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>'
{
  "runs": [
    {
      "cost_usd": 123,
      "created_at": "2023-11-07T05:31:56Z",
      "id": 123,
      "status": "<string>",
      "user": {
        "email": "<string>",
        "id": 123,
        "name": "<string>",
        "photo_url": "<string>"
      },
      "version": {
        "id": 123,
        "is_prod": true,
        "name": "<string>",
        "deployment": "<unknown>"
      },
      "duration_ms": 123,
      "group_id": 123,
      "last_reaction_sentiment": "<string>",
      "parent_id": 123,
      "trace": "<unknown>"
    }
  ],
  "group_id": 123,
  "next_page_token": 123,
  "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<int64>
required
​
app_id
integer<int64>
required

Query Parameters

​
user_id
integer<int64> | null

Filter runs by user ID

​
version_id
integer<int64> | null

Filter runs by version ID

​
status
string | null

Filter runs by status

​
sentiment
string | null

Filter runs by sentiment

​
group_id
integer<int64> | null

Filter runs by group ID

​
from
integer<int64> | null

Filter runs by start time (epoch timestamp in milliseconds)

​
to
integer<int64> | null

Filter runs by end time (epoch timestamp in milliseconds)

​
metadata
string | null

Filter runs by metadata

​
page_token
integer<int64> | null

Page token

Response

200 - application/json

Runs listed successfully

​
runs
object[]
required

List of runs

​
group_id
integer<int64> | null

The group_id filter applied to the query

​
next_page_token
integer<int64> | null

Cursor for the next page

​
user_id
integer<int64> | null

The user_id filter applied to the query