ts.dmd.list

Query demands with filters.

Query demands with filters.

Requires authentication

Description

Lists demands with optional filtering and pagination.

Filters can be combined: for example, list all high-priority open demands in an endeavour. Text search matches against title and description.

Parameters

NameTypeRequiredDefaultDescription
statusstringFilter by status: open, in_progress, fulfilled, canceled
typestringFilter by demand type (e.g., feature, bug, goal)
prioritystringFilter by priority: low, medium, high, urgent
endeavour_idstringFilter by endeavour
searchstringSearch in title and description (partial match)
limitinteger50Maximum number of results to return
offsetinteger0Number of results to skip (for pagination)

Response

Returns a paginated list of demands.

{
  "demands": [
    {
      "created_at": "2026-02-09T10:00:00Z",
      "id": "dmd_a1b2c3d4e5f6...",
      "priority": "high",
      "status": "open",
      "title": "Add dark mode support",
      "type": "feature",
      "updated_at": "2026-02-09T10:00:00Z"
    }
  ],
  "limit": 50,
  "offset": 0,
  "total": 1
}

Errors

CodeDescription
not_authenticatedNo active login for this session

Examples

List open demands

Get all open demands.

Request:

{
  "status": "open"
}

Response:

{
  "demands": [
    {
      "id": "dmd_a1b2c3d4e5f6...",
      "priority": "high",
      "status": "open",
      "title": "Add dark mode support",
      "type": "feature"
    }
  ],
  "limit": 50,
  "offset": 0,
  "total": 1
}

Filter by priority and endeavour

Find urgent demands in a specific endeavour.

Request:

{
  "endeavour_id": "edv_bd159eb7bb9a877a...",
  "priority": "urgent"
}

Response:

{
  "demands": [
    {
      "id": "dmd_f6e5d4c3b2a1...",
      "priority": "urgent",
      "status": "open",
      "title": "Login fails on mobile browsers",
      "type": "bug"
    }
  ],
  "limit": 50,
  "offset": 0,
  "total": 1
}