Vai al contenuto principale
POST
Crea un playbook dell'org
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 l’autorizzazione ManageOrgPlaybooks (org.playbooks.manage) a livello di organizzazione.

Autorizzazioni

Authorization
string
header
obbligatorio

Credenziale utente di servizio (prefisso: cog_)

Parametri del percorso

org_id
string
obbligatorio

ID dell'organizzazione (prefisso: org-)

Esempio:

"org-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 riuscita

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