Sign in

Search Tasks

Search tasks with pagination, sorting, and filtering.

Query params: page: Page number (1-based, default 1). per_page: Items per page (1-100, default 20). sort: Sort field (created_at, priority, title, role, status). order: Sort order (asc, desc; default desc). status: Filter by task status. role: Filter by task role. assigned_agent: Filter by assigned agent.

get/api/v1/tasks/search

Query parameters

pageinteger
per_pageinteger
sortstring
orderstring
statusstring nullable
rolestring nullable
assigned_agentstring nullable

Response

Successful Response

totalinteger required
pageinteger required
per_pageinteger required
total_pagesinteger required
sortstring required
orderstring required
filtersobject

Changes

Changed in 2 of the 15 revisions of this API.11

  • d52fab9681ed1See the full diff
    • ○

      added the optional property tasks/items/artifact_spec to the response with the 200 status

      response-optional-property-added

  • 2a1299ef19fa10See the full diff
    • ○

      added the optional property tasks/items/cli to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property tasks/items/closed_at to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property tasks/items/completed_at to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property tasks/items/max_output_tokens to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property tasks/items/max_retries to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property tasks/items/max_turns to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property tasks/items/meta_messages to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property tasks/items/retry_count to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property tasks/items/retry_delay_s to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property tasks/items/terminal_reason to the response with the 200 status

      response-optional-property-added

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