API reference for managing work items (objectives, initiatives, epics, tasks), workspace documents, and user notifications.

Work Items, Workspace & Notifications

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

Work Items

Work items represent units of work organized in a hierarchy. Each item has a type that determines its place in the structure:

Objective
  └── Initiative
        └── Epic
              └── Task

Objectives define high-level goals. Initiatives break objectives into strategic streams. Epics group related tasks. Tasks are the actionable units that operators execute.

Any work item can be assigned to an operator, and operators autonomously pick up and execute tasks based on their capabilities.

List Work Items

Retrieve work items for a guild with optional filters.

GET /guilds/{guildId}/work-items?type=task&status=in_progress&parentId=xxx

Query Parameters

Parameter	Type	Description
`type`	string	Filter by type: `objective`, `initiative`, `epic`, `task`
`status`	string	Filter by status: `backlog`, `todo`, `in_progress`, `review`, `done`, `cancelled`
`parentId`	string	Filter by parent work item ID (e.g., get all tasks under an epic)

Example

curl "https://api.guilde.work/guilde/api/v1/guilds/gld_abc123/work-items?type=task&status=in_progress" \
  -H "Authorization: Bearer gld_your_api_key"

Response

{
  "workItems": [
    {
      "id": "wi_task_01",
      "type": "task",
      "title": "Draft social media calendar",
      "description": "Create a 4-week content calendar for LinkedIn and Twitter.",
      "status": "in_progress",
      "priority": "high",
      "progress": 40,
      "parentId": "wi_epic_03",
      "assignedOperatorId": "op_marketing",
      "createdAt": "2026-04-05T09:00:00Z",
      "updatedAt": "2026-04-08T11:00:00Z"
    }
  ]
}

Create Work Item

Create a new work item in the hierarchy.

POST /guilds/{guildId}/work-items

Request Body

Field	Type	Required	Description
`type`	string	Yes	One of: `objective`, `initiative`, `epic`, `task`
`title`	string	Yes	Work item title
`description`	string	No	Detailed description
`priority`	string	No	`low`, `medium`, `high`, `critical`. Defaults to `medium`.
`parentId`	string	No	Parent work item ID. Must respect hierarchy (e.g., a task's parent must be an epic).
`assignedOperatorId`	string	No	Operator to assign. The operator will be notified and may begin working autonomously.

Example — Create a task under an epic

curl -X POST https://api.guilde.work/guilde/api/v1/guilds/gld_abc123/work-items \
  -H "Authorization: Bearer gld_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "task",
    "title": "Write blog post about product launch",
    "description": "1500-word blog post covering features, pricing, and availability.",
    "priority": "high",
    "parentId": "wi_epic_03",
    "assignedOperatorId": "op_marketing"
  }'

Example — Create a top-level objective

curl -X POST https://api.guilde.work/guilde/api/v1/guilds/gld_abc123/work-items \
  -H "Authorization: Bearer gld_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "objective",
    "title": "Launch product in EU market by Q3",
    "priority": "critical"
  }'

Response

{
  "id": "wi_task_02",
  "type": "task",
  "title": "Write blog post about product launch",
  "status": "todo",
  "priority": "high",
  "progress": 0,
  "parentId": "wi_epic_03",
  "assignedOperatorId": "op_marketing",
  "createdAt": "2026-04-08T16:00:00Z"
}

Update Work Item

Update an existing work item's status, progress, assignment, or details.

PUT /work-items/{id}

Request Body

Field	Type	Description
`status`	string	New status: `backlog`, `todo`, `in_progress`, `review`, `done`, `cancelled`
`progress`	number	Completion percentage (0-100)
`title`	string	Updated title
`priority`	string	Updated priority
`assignedOperatorId`	string	Reassign to a different operator

Example

curl -X PUT https://api.guilde.work/guilde/api/v1/work-items/wi_task_01 \
  -H "Authorization: Bearer gld_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "review",
    "progress": 90
  }'

Response

{
  "id": "wi_task_01",
  "type": "task",
  "title": "Draft social media calendar",
  "status": "review",
  "progress": 90,
  "priority": "high",
  "parentId": "wi_epic_03",
  "assignedOperatorId": "op_marketing",
  "updatedAt": "2026-04-08T17:00:00Z"
}

Workspace

The workspace is a shared document store for the guild. Operators and humans can create and read documents like briefs, reports, and reference material.

List Documents

GET /guilds/{guildId}/workspace

Example

curl https://api.guilde.work/guilde/api/v1/guilds/gld_abc123/workspace \
  -H "Authorization: Bearer gld_your_api_key"

Response

{
  "documents": [
    {
      "id": "doc_001",
      "title": "Brand Guidelines",
      "type": "reference",
      "description": "Official brand voice, colors, and typography.",
      "createdAt": "2026-03-15T08:00:00Z",
      "updatedAt": "2026-04-01T12:00:00Z"
    },
    {
      "id": "doc_002",
      "title": "Weekly Status Report",
      "type": "report",
      "createdAt": "2026-04-07T09:00:00Z",
      "updatedAt": "2026-04-07T09:00:00Z"
    }
  ]
}

Write Document

Create a new document in the workspace.

POST /guilds/{guildId}/workspace

Request Body

Field	Type	Required	Description
`title`	string	Yes	Document title
`content`	string	Yes	Document content (Markdown supported)
`type`	string	No	One of: `document`, `reference`, `brief`, `report`. Defaults to `document`.
`description`	string	No	Short description of the document

Example

curl -X POST https://api.guilde.work/guilde/api/v1/guilds/gld_abc123/workspace \
  -H "Authorization: Bearer gld_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Launch Brief",
    "content": "# Product Launch Brief\n\n## Timeline\n- April 15: Beta release\n- May 1: Public launch\n\n## Key Messages\n...",
    "type": "brief",
    "description": "Brief for the Q2 product launch."
  }'

Response

{
  "id": "doc_003",
  "title": "Launch Brief",
  "type": "brief",
  "description": "Brief for the Q2 product launch.",
  "createdAt": "2026-04-08T16:30:00Z"
}

Read Document

Retrieve a single document with its full content.

GET /guilds/{guildId}/workspace/{docId}

Example

curl https://api.guilde.work/guilde/api/v1/guilds/gld_abc123/workspace/doc_003 \
  -H "Authorization: Bearer gld_your_api_key"

Response

{
  "id": "doc_003",
  "title": "Launch Brief",
  "type": "brief",
  "description": "Brief for the Q2 product launch.",
  "content": "# Product Launch Brief\n\n## Timeline\n- April 15: Beta release\n- May 1: Public launch\n\n## Key Messages\n...",
  "createdAt": "2026-04-08T16:30:00Z",
  "updatedAt": "2026-04-08T16:30:00Z"
}

Notifications

User-level notifications for activity across all guilds.

List Notifications

GET /notifications

Example

curl https://api.guilde.work/guilde/api/v1/notifications \
  -H "Authorization: Bearer gld_your_api_key"

Response

{
  "notifications": [
    {
      "id": "notif_001",
      "type": "work_item_updated",
      "message": "Strategist marked 'Draft social media calendar' as review.",
      "read": false,
      "createdAt": "2026-04-08T17:00:00Z",
      "meta": {
        "workItemId": "wi_task_01",
        "operatorId": "op_strategy"
      }
    },
    {
      "id": "notif_002",
      "type": "conversation_message",
      "message": "Marketer replied in 'Product Launch Plan'.",
      "read": true,
      "createdAt": "2026-04-08T15:02:00Z",
      "meta": {
        "conversationId": "conv_new123",
        "operatorId": "op_marketing"
      }
    }
  ]
}

Mark All Read

POST /notifications/read-all

Example

curl -X POST https://api.guilde.work/guilde/api/v1/notifications/read-all \
  -H "Authorization: Bearer gld_your_api_key"

Response

{
  "success": true,
  "markedCount": 5
}

Work Items, Workspace & Notifications

On this page