Skip to main content
GET
/
orgs
/
{org_id}
/
apps
/
{app_id}
/
runs
cURL
curl --request GET \
  --url https://dev.timbal.ai/orgs/{org_id}/apps/{app_id}/runs \
  --header 'Authorization: Bearer <token>'
{
  "group_id": 123,
  "next_page_token": 123,
  "runs": [
    {
      "cost_usd": 123,
      "created_at": "2023-11-07T05:31:56Z",
      "duration_ms": 123,
      "group_id": 123,
      "id": 123,
      "last_reaction_sentiment": "<string>",
      "parent_id": 123,
      "status": "<string>",
      "trace": "<any>",
      "user": {
        "email": "<string>",
        "id": 123,
        "name": "<string>",
        "photo_url": "<string>"
      },
      "version": {
        "deployment": null,
        "id": 123,
        "is_prod": true,
        "name": "<string>"
      }
    }
  ],
  "user_id": 123
}

Authorizations

Authorization
string
header
required

Timbal API key. Obtain your API key from the Timbal platform settings. See Authentication for more information.

Path Parameters

org_id
integer
required
app_id
integer
required

Query Parameters

user_id
integer | null

Filter runs by user ID

version_id
integer | null

Filter runs by version ID

status
string | null

Filter runs by status

sentiment
string | null

Filter runs by sentiment

group_id
integer | null

Filter runs by group ID

from
integer | null

Filter runs by start time (epoch timestamp in milliseconds)

to
integer | null

Filter runs by end time (epoch timestamp in milliseconds)

metadata
string | null

Filter runs by metadata

page_token
integer | null

Page token

Response

200 - application/json

Runs listed successfully

runs
object[]
required

List of runs

group_id
integer | null

The group_id filter applied to the query

next_page_token
integer | null

Cursor for the next page

user_id
integer | null

The user_id filter applied to the query