Vai al contenuto principale
PUT
Aggiorna un playbook
I Playbook stanno passando alle Competenze. In un account già migrato, questa richiesta scrive invece la skill del playbook: una creazione aggiunge una skill, un aggiornamento la modifica e un’eliminazione la rimuove. Crea e modifica le skill nella pagina Personalizza. Dal 24 ottobre 2026, i nuovi account partiranno con le Competenze e non avranno Playbook. Consulta I Playbook stanno passando alle Competenze.

Autorizzazioni

Richiede un utente di servizio o un token di accesso personale con il permesso ManageAccountPlaybooks a livello Enterprise.

Autorizzazioni

Authorization
string
header
obbligatorio

Credenziale utente di servizio (prefisso: cog_)

Parametri del percorso

playbook_id
string
obbligatorio

ID del playbook (prefisso: playbook-)

Esempio:

"playbook-abc123def456"

Corpo

application/json
title
string
obbligatorio
body
string
obbligatorio
macro
string | null

Identificatore della macro del playbook. Deve iniziare con '!' seguito da una o più lettere, cifre, caratteri di sottolineatura o trattini. Esempio: '!my_macro' oppure '!my-macro'

structured_output_schema
Structured Output Schema · object | null

Schema JSON (Draft 7) che le sessioni che usano questo playbook produrranno come output strutturato. Max 64 KB. Deve essere autosufficiente (nessun $ref esterno).

Risposta

Risposta con esito positivo

playbook_id
string
obbligatorio
title
string
obbligatorio
body
string
obbligatorio
macro
string | null
obbligatorio
created_by
string
obbligatorio
updated_by
string
obbligatorio
created_at
integer
obbligatorio
updated_at
integer
obbligatorio
access_type
enum<string>
obbligatorio
Opzioni disponibili:
enterprise,
org
org_id
string | null
obbligatorio
structured_output_schema
Structured Output Schema · object | null