Tasks, Plans & Requests

Base URL: https://api.guilde.work/guilde/api/v1

Tasks

Simple task CRUD for guild task management.

List tasks

curl "https://api.guilde.work/guilde/api/v1/guilds/{guildId}/tasks?status=pending" \
  -H "Authorization: Bearer gld_your_api_key"

Create task

curl -X POST https://api.guilde.work/guilde/api/v1/guilds/{guildId}/tasks \
  -H "Authorization: Bearer gld_your_api_key" \
  -d '{ "title": "Review Q1 metrics", "priority": "high" }'

Update task

curl -X PATCH https://api.guilde.work/guilde/api/v1/guilds/{guildId}/tasks/{taskId} \
  -H "Authorization: Bearer gld_your_api_key" \
  -d '{ "status": "done" }'

Delete task

curl -X DELETE https://api.guilde.work/guilde/api/v1/guilds/{guildId}/tasks/{taskId} \
  -H "Authorization: Bearer gld_your_api_key"

Plans

Operator work plans are Markdown files in the guild workspace (plans/*.md). The API reads and parses them.

List plans

curl "https://api.guilde.work/guilde/api/v1/guilds/{guildId}/plans?operatorId=op_123" \
  -H "Authorization: Bearer gld_your_api_key"

Returns plan summaries: objective, status, progress percentage, operator, timestamps.

Get plan detail

curl https://api.guilde.work/guilde/api/v1/guilds/{guildId}/plans/{planId} \
  -H "Authorization: Bearer gld_your_api_key"

Returns full plan with steps (status: done/pending/failed/skipped), artifacts, and context.

Requests

Operators can create requests that need human approval. The founder responds via the API.

List requests

curl "https://api.guilde.work/guilde/api/v1/guilds/{guildId}/requests?status=pending" \
  -H "Authorization: Bearer gld_your_api_key"

Respond to request

curl -X POST https://api.guilde.work/guilde/api/v1/guilds/{guildId}/requests/{requestId}/respond \
  -H "Authorization: Bearer gld_your_api_key" \
  -d '{ "response": "approved", "reasoning": "Looks good" }'

Tasks & Plans