Overview

Blocked Tasks

Active Work

Select a property and board to view retro items, or create a new board.

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
Name Brand URL
Title Belongs To Updated
External apps
Name Type Login Password Linked To
Active Monthly
$0.00
Active Annual
$0.00
Total (incl. Inactive)
$0.00
App Name Monthly Cost Annual Cost Status

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"
}