agent

Get an agent thread's run tree

Changed on

Get the runs of a thread as a tree (via parent_run_id). Use it to detect branches (sibling runs from edit/regenerate) and pick a run to restore (restore via the run events endpoints).

Required scope: `inference:run`

get/agent/threads/{thread_id}

Request

  • Base URL
    https://developer.qaip.com/api/v1
  • URL
    https://developer.qaip.com/api/v1/agent/threads/{thread_id}
  • Auth
    API key in header x-api-key

Path parameters

thread_idstring required

Query parameters

principal_idstring

Scope by principal. If omitted, only a thread with no principal (principal_id is null) is returned; a thread whose principal differs yields 404.

Response

Agent thread run tree

thread_idstring required

Changes

  • 2489c6f1a9d8Revision changes
    • info

      added the non-success response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

  • c874961c9519Revision changes
    • warning

      added the new CANCELLED enum value to the // response property for the response status

    • warning

      added the new CANCELLING enum value to the // response property for the response status

    • warning

      added the new FAILED enum value to the // response property for the response status

    • warning

      added the new QUEUED enum value to the // response property for the response status

    • warning

      added the new RUNNING enum value to the // response property for the response status

    • warning

      added the new SUCCEEDED enum value to the // response property for the response status