Provider Runs

Provider runs track the execution of provider operations within a session. This read-only resource provides visibility into provider activity.

Provider Runs object

Attributes

object

String

String representing the object's type

id

String

Unique provider run identifier

status

Enum

Run status

session_id

String

Parent session ID

session_provider_id

String

Session provider ID

provider_id

String

Provider ID

connection_id

String

Connection ID

completed_at

DateNullable

Timestamp when run completed

created_at

Date

Timestamp when created

updated_at

Date

Timestamp when last updated

{
  "object": "session.provider_run",
  "id": "prn_8hJkLmNpQrStUvWx",
  "status": "running",
  "session_id": "ses_4dEfGhJkLmNpQrSt",
  "session_provider_id": "spr_3cDeFgHjKlMnPqRs",
  "provider_id": "pro_5gHjKlMnPqRsTuVw",
  "connection_id": "scn_8hJkLmNpQrStUvWx",
  "completed_at": "2025-09-15T10:30:05.000Z",
  "created_at": "2025-09-15T10:30:00.000Z",
  "updated_at": "2026-01-10T14:45:00.000Z"
}

List all provider runs

Returns a paginated list of provider runs across all sessions.

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

status

UnionOptional

Filter by run status

id

UnionOptional

Filter by provider run ID(s)

session_id

UnionOptional

Filter by session ID(s)

provider_id

UnionOptional

Filter by provider ID(s)

session_provider_id

UnionOptional

Filter by session provider ID(s)

session_connection_id

UnionOptional

Filter by session connection ID(s)

provider_version_id

UnionOptional

Filter by provider version ID(s)

created_at

ObjectOptional

Filter provider run creation time by date range

updated_at

ObjectOptional

Filter provider run last update time by date range

GEThttp://api.metorial.com/provider-runs
curl -X GET "https://api.metorial.com/provider-runs" \
  -H "Authorization: Bearer metorial_sk_..."

Get provider run

Retrieves a specific provider run by ID.

URL Parameters

provider_run_id

String

The unique identifier for the provider_run

GEThttp://api.metorial.com/provider-runs/:provider_run_id
curl -X GET "https://api.metorial.com/provider-runs/pro_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."

Get provider run logs

Retrieves the logs for a specific provider run.

URL Parameters

provider_run_id

String

The unique identifier for the provider_run

GEThttp://api.metorial.com/provider-runs/:provider_run_id/logs
curl -X GET "https://api.metorial.com/provider-runs/pro_Rm4Mnheq2bfEPhBhP7SY/logs" \
  -H "Authorization: Bearer metorial_sk_..."