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

String

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

Maximum number of items to return (1-100)

after

StringOptional

Return items after this ID

before

StringOptional

Return items before this ID

cursor

StringOptional

Pagination cursor from a previous response

order

EnumOptional

Sort order for results

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)

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_..."