Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Tasks [Beta]

List pending manual activity tasks in a scope

get

Returns manual activity tasks that are in a pending state (activity status RUNNING, ON_HOLD, or OUTPUT_WAITING) within the given scope. When myTasks is true, only tasks assigned to the calling user (via user_reference_id or user_groups membership) are returned.

Query parameters
orgIdentifierstringOptional

Organisation Identifier

projectIdentifierstringOptional

Project Identifier

myTasksbooleanOptional

When true, returns only tasks for activities triggered by the calling user. Equivalent to requestedBy=.

Default: false
pendingOnMebooleanOptional

When true, returns only tasks assigned to the calling user (by user_reference_id or user_groups).

Default: false
requestedBystringOptional

When set, returns only tasks for activities triggered by this user identifier.

pendingOnUserIdstringOptional

When set, returns only tasks assigned to this specific user identifier (by user_reference_id or user_groups membership). Distinct from pendingOnMe, which resolves to the calling user. When absent, all tasks are returned regardless of assignee.

pendingOnOthersbooleanOptional

When true, returns only tasks that are NOT pending on the specified user (pendingOnUserId) or, if pendingOnUserId is absent, NOT pending on the calling user.

Default: false
nextCursorstringOptional

Opaque forward cursor returned by the previous page's nextCursor field. Omit for the first page.

previousCursorstringOptional

Opaque backward cursor returned by the previous page's prevCursor field. Pass to navigate backward.

sortstringOptional

Sort criteria: FIELD,DIRECTION — e.g. CREATED_AT,ASC or CREATED_AT,DESC. Valid fields: CREATED_AT. Valid directions: ASC, DESC. Defaults to CREATED_AT,ASC when absent.

sizeintegerOptional

Maximum number of tasks to return per page

Default: 20
Header parameters
Harness-AccountstringRequired

Account Identifier

Responses
200

Pending manual activity tasks in the given scope

application/json

Cursor-paginated list of pending manual activity tasks

currentSizeintegerOptional

Number of items in this page

hasMorebooleanOptional

Whether additional pages are available

nextCursorstringOptional

Opaque forward cursor. Pass as nextCursor on the next request. Absent when hasMore is false.

prevCursorstringOptional

Opaque backward cursor. Pass as previousCursor on the next request to navigate backward. Absent when this is the first page.

get/tasks/pending
GET /api/tasks/pending HTTP/1.1
Harness-Account: text
Accept: */*
{
  "content": [
    {
      "actualDuration": "text",
      "createdAt": 1,
      "description": "text",
      "executionContext": {
        "activityExecutionId": "text",
        "activityId": "text",
        "activityName": "text",
        "orgId": "text",
        "phaseExecutionId": "text",
        "phaseId": "text",
        "phaseName": "text",
        "processExecutionId": "text",
        "processId": "text",
        "processName": "text",
        "projectId": "text",
        "releaseId": "text",
        "releaseName": "text",
        "releaseVersion": "text"
      },
      "expectedDuration": "text",
      "failureInfo": {
        "code": "text",
        "msg": "text"
      },
      "identifier": "text",
      "lastUpdatedAt": 1,
      "name": "text",
      "required": true,
      "status": "TODO",
      "taskExecutionId": "text",
      "triggeredBy": {
        "avatar": "text",
        "email": "text",
        "id": "text",
        "name": "text",
        "triggerType": "MANUAL"
      },
      "userGroups": "text",
      "userReferenceId": "text"
    }
  ],
  "currentSize": 1,
  "hasMore": true,
  "nextCursor": "text",
  "prevCursor": "text"
}

Last updated

Was this helpful?