Skip to main content
GET
/
procedures
List procedures
curl --request GET \
  --url https://api.operator.xyz/procedures \
  --header 'Authorization: Bearer <token>' \
  --header 'Operator-Version: <operator-version>'
{
  "page": [
    {
      "id": "<string>",
      "livemode": true,
      "name": "<string>",
      "conversation_id": "<string>",
      "agent_id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "status": "pending",
      "output": null,
      "error": null
    }
  ],
  "cursor": null
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Operator-Version
enum<string>
required

The API version to use.

Available options:
2025-06-19

Query Parameters

​
agent_id
string

Filter by agent ID

​
conversation_id
string

Filter by conversation ID

​
created_at_gte
string<date-time>

Filter procedures created after this date.

​
created_at_lt
string<date-time>

Filter procedures created before this date.

​
cursor
string

Pagination cursor for retrieving the next page of results. Use the cursor value returned in the previous response to fetch subsequent pages.

Response

Successful response.

​
page
listed.procedure · object[]
required

List of procedures

​
cursor
string

Cursor for next page, if available

⌘I