Pular para o conteúdo principal
POST
Criar um playbook da organização
Os Playbooks estão migrando para Habilidades. Em uma conta que já migrou, esta requisição grava, em vez disso, a skill do playbook: uma criação adiciona uma skill, uma atualização a altera e uma exclusão a remove. Crie e edite habilidades na página Customize. A partir de 24 de outubro de 2026, novas contas começarão com Habilidades e não terão Playbooks. Consulte Os Playbooks estão migrando para Habilidades.

Permissões

Requer um usuário de serviço ou token de acesso pessoal com a permissão ManageOrgPlaybooks (org.playbooks.manage) no nível da organização.

Autorizações

Authorization
string
header
obrigatório

Credencial de usuário de serviço (prefixo: cog_)

Parâmetros de caminho

org_id
string
obrigatório

ID da organização (prefixo: org-)

Exemplo:

"org-abc123def456"

Corpo

application/json
title
string
obrigatório
body
string
obrigatório
macro
string | null

Identificador de macro de playbook. Deve começar com '!' seguido de uma ou mais letras, dígitos, underscores ou hífens. Exemplo: '!my_macro' ou '!my-macro'

structured_output_schema
Structured Output Schema · object | null

JSON Schema (Draft 7) que será produzido como saída estruturada pelas sessões que usam este playbook. Máx. 64 KB. Deve ser autocontido (sem $ref externo).

Resposta

Resposta bem-sucedida

playbook_id
string
obrigatório
title
string
obrigatório
body
string
obrigatório
macro
string | null
obrigatório
created_by
string
obrigatório
updated_by
string
obrigatório
created_at
integer
obrigatório
updated_at
integer
obrigatório
access_type
enum<string>
obrigatório
Opções disponíveis:
enterprise,
org
org_id
string | null
obrigatório
structured_output_schema
Structured Output Schema · object | null