Task Management

Get task items for an entity

Get task items for an entity in Betayum. Manage task items and attachments linked to operational entities such as risks and vendors.

get/v1/task-management

Query parameters

entityIdstring required
Example:vnd_abc123def456

ID of the entity to get task items for

entityType'vendor' | 'risk' required
Example:vendor

Type of entity

pagenumber
Example:1

Page number (1-indexed)

limitnumber
Example:5

Number of items per page

status'todo' | 'in_progress' | 'in_review' | 'done' | 'canceled'
Example:todo

Filter by status

priority'urgent' | 'high' | 'medium' | 'low'
Example:high

Filter by priority

assigneeIdstring
Example:mbr_abc123def456

Filter by assignee ID

sortBy'createdAt' | 'updatedAt' | 'title' | 'status' | 'priority'
Example:createdAt

Sort by field

sortOrder'asc' | 'desc'
Example:desc

Sort order

Response

Task items retrieved successfully

Example response

{
  "data": [
    {
      "id": "tski_abc123def456",
      "title": "Review vendor contract"
    }
  ]
}

Changes

Changed in 2 of the 51 revisions of this API.21

    • the data/items/assignee response's property type/format changed from / to object/ for status 200

      response-property-type-changed

    • the data/items/updatedBy response's property type/format changed from / to object/ for status 200

      response-property-type-changed

    • deleted the header request parameter X-Organization-Id

      request-parameter-removed

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog