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

StringNullable

Run status

name

StringNullable

Display name

description

StringNullable

Description

metadata

ObjectNullable

Custom key-value pairs

session_id

String

Parent session ID

session_provider_id

StringNullable

Session provider ID

provider_id

StringNullable

Provider ID

provider_deployment_id

StringNullable

Provider deployment ID

provider_version_id

StringNullable

Provider version ID

started_at

DateNullable

Timestamp when run started

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": "completed",
  "name": "Tool execution",
  "description": "Executing search_files tool",
  "metadata": {
    "tool_name": "search_files"
  },
  "session_id": "ses_4dEfGhJkLmNpQrSt",
  "session_provider_id": "spr_3cDeFgHjKlMnPqRs",
  "provider_id": "pro_5gHjKlMnPqRsTuVw",
  "provider_deployment_id": "pde_1aBcDeFgHjKlMnPq",
  "provider_version_id": "prv_4dEfGhJkLmNpQrSt",
  "started_at": "2025-09-15T10:30:00.000Z",
  "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

StringOptional

Filter by run status

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)

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

List provider runs

Returns a paginated list of provider runs for a session.

URL Parameters

session_id

String

The unique identifier for the session

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

StringOptional

Filter by run status

provider_id

UnionOptional

Filter by provider ID(s)

session_provider_id

UnionOptional

Filter by session provider ID(s)

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

Get provider run

Retrieves a specific provider run for a session.

URL Parameters

session_id

String

The unique identifier for the session

provider_run_id

String

The unique identifier for the provider_run

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

Get provider run logs

Retrieves the logs for a specific provider run.

URL Parameters

session_id

String

The unique identifier for the session

provider_run_id

String

The unique identifier for the provider_run

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