Skip to main content
Create Playbook
curl --request POST \
  --url https://api.devin.ai/v1/playbooks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "title": "<string>",
  "body": "<string>",
  "macro": "<string>"
}'
{
  "playbook_id": "playbook-abc123",
  "title": "Deploy to Production",
  "body": "Steps to deploy the application to production environment...",
  "status": "published",
  "access_type": "team",
  "org_id": "org-xyz789",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:00Z",
  "created_by_user_id": "user-123",
  "created_by_user_name": "John Doe",
  "updated_by_user_id": "user-123",
  "updated_by_user_name": "John Doe",
  "macro": "!deploy"
}
Create a new team playbook. Requires ManageOrgPlaybooks permission.

​
Request Body

​
title
string
required
The title of the playbook
​
body
string
required
The content/instructions of the playbook
​
macro
string
Optional macro shortcut for the playbook (e.g., !deploy)

​
Response

Returns the newly created playbook object with all metadata. 
{
  "playbook_id": "playbook-abc123",
  "title": "Deploy to Production",
  "body": "Steps to deploy the application to production environment...",
  "status": "published",
  "access_type": "team",
  "org_id": "org-xyz789",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:00Z",
  "created_by_user_id": "user-123",
  "created_by_user_name": "John Doe",
  "updated_by_user_id": "user-123",
  "updated_by_user_name": "John Doe",
  "macro": "!deploy"
}
⌘I