Zum Hauptinhalt springen
POST
Ein Playbook auf Organisationsebene erstellen
Playbooks werden zu Fähigkeiten migriert. In einem bereits migrierten Konto schreibt diese Anfrage stattdessen den Skill des Playbooks: Beim Erstellen wird ein Skill hinzugefügt, bei einem Update wird er geändert, beim Löschen wird er entfernt. Fähigkeiten erstellen und bearbeiten Sie auf der Seite Anpassen. Ab dem 24. Oktober 2026 starten neue Konten mit Fähigkeiten und ohne Playbooks. Siehe Playbooks werden zu Fähigkeiten migriert.

Berechtigungen

Erfordert einen Servicebenutzer oder ein persönliches Zugriffstoken mit der Berechtigung ManageOrgPlaybooks (org.playbooks.manage) auf Organisationsebene.

Autorisierungen

Authorization
string
header
erforderlich

Anmeldedaten für Service-Benutzer (Präfix: cog_)

Pfadparameter

org_id
string
erforderlich

Organisations-ID (Präfix: org-)

Beispiel:

"org-abc123def456"

Body

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

Makro-ID des Playbooks. Muss mit '!' beginnen, gefolgt von einem oder mehreren Buchstaben, Ziffern, Unterstrichen oder Bindestrichen. Beispiel: '!my_macro' oder '!my-macro'

structured_output_schema
Structured Output Schema · object | null

JSON-Schema (Draft 7) für die strukturierte Ausgabe von Sitzungen, die dieses Playbook verwenden. Max. 64 KB. Muss in sich geschlossen sein (keine externen $ref).

Antwort

Erfolgreiche Antwort

playbook_id
string
erforderlich
title
string
erforderlich
body
string
erforderlich
macro
string | null
erforderlich
created_by
string
erforderlich
updated_by
string
erforderlich
created_at
integer
erforderlich
updated_at
integer
erforderlich
access_type
enum<string>
erforderlich
Verfügbare Optionen:
enterprise,
org
org_id
string | null
erforderlich
structured_output_schema
Structured Output Schema · object | null