Overview

Blocked Tasks

Active Work

I'm Bob, your COO assistant. I can help you with:

• Check business status ("How's the business doing?")
• View brands and properties ("Show me TestJeff properties")
• Manage tasks ("What's blocked?", "Create a task for...")
• Move work forward ("Move task X to doing")

What would you like to know?
Name Description Properties Tasks
Name Type Brand URL
Title Belongs To Updated
External apps with saved credentials

API Key

Use this key to authenticate external API requests.

••••••••••••••••

Authentication

Include your API key in the X-API-Key header with every request.

curl -H "X-API-Key: YOUR_API_KEY" https://bob.ensomniamedia.com/api/external/tasks

Endpoints

GET /api/external/tasks

Get all tasks from the kanban board with brand names.

curl -H "X-API-Key: YOUR_API_KEY" \
  https://bob.ensomniamedia.com/api/external/tasks
GET /api/external/tasks/:id

Get a single task by ID.

curl -H "X-API-Key: YOUR_API_KEY" \
  https://bob.ensomniamedia.com/api/external/tasks/TASK_ID
GET /api/external/tasks/assignee/:assignee

Get tasks assigned to a specific person. Assignees: bob, alice, data

curl -H "X-API-Key: YOUR_API_KEY" \
  https://bob.ensomniamedia.com/api/external/tasks/assignee/bob
PATCH /api/external/tasks/:id/status

Update task status. Valid statuses: backlog, todo, doing, blocked, done

curl -X PATCH \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status": "done"}' \
  https://bob.ensomniamedia.com/api/external/tasks/TASK_ID/status

Response Format

All responses are JSON. Example task object:

{
  "id": "abc123",
  "title": "Build landing page",
  "description": "Create initial landing page",
  "status": "doing",
  "assignee": "data",
  "brandId": "xyz789",
  "brandName": "TestJeff",
  "createdAt": "2025-01-01T00:00:00.000Z",
  "updatedAt": "2025-01-02T00:00:00.000Z"
}