COcontext
webdbs

List runs for a collection

Changed on

Returns recent runs for a collection.

get/webdbs/collections/{collection_id}/runs

Request

  • Base URL
    https://api.context.dev/v1
  • URL
    https://api.context.dev/v1/webdbs/collections/{collection_id}/runs
  • Auth
    HTTP bearer

Path parameters

collection_idstring required

Collection ID.

Example:col_123

Query parameters

limitinteger

Maximum items to return. Defaults to 25.

cursorstring

Pagination cursor from a previous response.

tagsstring[]

Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.

Optional comma-separated caller-defined tags for tracking this request. Tags are recorded on the request's usage log and can be used to filter usage on the dashboard usage page. Up to 20 tags, each 1-50 characters.

[
  "production",
  "team-alpha"
]

Response

A paginated list of runs, newest first

has_moreboolean required

Whether another page is available.

next_cursorstring nullable required

Cursor for the next page, or null at the end.

Example response

{
  "data": [
    {
      "id": "run_123",
      "collection_id": "col_123",
      "by_target": [
        {
          "target_id": "tgt_123"
        }
      ]
    }
  ]
}

Changes

  • 182f532c2552Revision changes
    • warning

      added the new WEBSITE_BLOCKED enum value to the response property for the response status

    • warning

      added the new WEBSITE_BLOCKED enum value to the response property for the response status

  • 3c6a01ba967fRevision changes
    • warning

      added the new COLD_DOMAIN_TIMEOUT_TOO_LOW enum value to the response property for the response status

    • warning

      added the new COLD_DOMAIN_TIMEOUT_TOO_LOW enum value to the response property for the response status