Create playbook

POST

https://api.devin.ai/v1/playbooks

POST

/v1/playbooks

curl -X POST https://api.devin.ai/v1/playbooks \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "body": "Step 1: Gather requirements\nStep 2: Assign team roles\nStep 3: Execute tasks\nStep 4: Review and report",
  "title": "Quarterly Product Launch Playbook"
}'

{
  "access_type": "team",
  "body": "Step 1: Gather requirements\nStep 2: Assign team roles\nStep 3: Execute tasks\nStep 4: Review and report",
  "created_at": "2024-01-15T09:30:00Z",
  "created_by_user_id": "user_987654321",
  "created_by_user_name": "Alice Johnson",
  "org_id": "org_123456789",
  "playbook_id": "playbook_abc123xyz",
  "status": "active",
  "title": "Quarterly Product Launch Playbook",
  "updated_at": "2024-01-15T09:30:00Z",
  "updated_by_user_id": "user_987654321",
  "updated_by_user_name": "Alice Johnson",
  "macro": "launch_sequence_v2"
}

Create a new team playbook for the organization.

Authentication

AuthorizationBearer

Personal API Key (apk_user_) or Service API Key (apk_)

Request

This endpoint expects an object.

bodystringRequired>=1 character

titlestringRequired>=1 character

macrostring or nullOptional

Response

Successful Response

access_typestring

bodystring

created_atdatetime or null

created_by_user_idstring or null

created_by_user_namestring or null

org_idstring

playbook_idstring

statusstring

titlestring

updated_atdatetime or null

updated_by_user_idstring or null

updated_by_user_namestring or null

macrostring or nullOptional

Errors

422

Unprocessable Entity Error