Pular para o conteúdo principal
PUT
Atualizar um playbook
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 ManageAccountPlaybooks no nível de Enterprise.

Autorizações

Authorization
string
header
obrigatório

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

Parâmetros de caminho

playbook_id
string
obrigatório

ID do playbook (prefixo: playbook-)

Exemplo:

"playbook-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 de sucesso

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