curl --request GET \
--url https://api.operator.xyz/procedural_agents/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Operator-Version: <operator-version>'import requests
url = "https://api.operator.xyz/procedural_agents/{id}"
headers = {
"Operator-Version": "<operator-version>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'Operator-Version': '<operator-version>', Authorization: 'Bearer <token>'}
};
fetch('https://api.operator.xyz/procedural_agents/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "<string>",
"version_id": "<string>",
"name": "<string>",
"description": "<string>",
"version_status": "released",
"config": {
"filter_statuses": [
"completed"
],
"runtime": {
"model": "openai/gpt-4o",
"prompt": {
"text": "<string>",
"type": "fixed"
},
"reasoning_effort": "medium"
},
"tool": {
"tools": [
{
"ns": "syscall",
"name": "<string>"
}
]
},
"output": {
"slack_channel": null,
"output_schema": null,
"post_url": null
},
"filter_condition": null
},
"triggered_by_agents": [
{
"id": "<string>",
"name": "<string>"
}
]
}{
"code": "<string>",
"message": "<string>",
"data": "<unknown>"
}Get a procedural agent
curl --request GET \
--url https://api.operator.xyz/procedural_agents/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Operator-Version: <operator-version>'import requests
url = "https://api.operator.xyz/procedural_agents/{id}"
headers = {
"Operator-Version": "<operator-version>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'Operator-Version': '<operator-version>', Authorization: 'Bearer <token>'}
};
fetch('https://api.operator.xyz/procedural_agents/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "<string>",
"version_id": "<string>",
"name": "<string>",
"description": "<string>",
"version_status": "released",
"config": {
"filter_statuses": [
"completed"
],
"runtime": {
"model": "openai/gpt-4o",
"prompt": {
"text": "<string>",
"type": "fixed"
},
"reasoning_effort": "medium"
},
"tool": {
"tools": [
{
"ns": "syscall",
"name": "<string>"
}
]
},
"output": {
"slack_channel": null,
"output_schema": null,
"post_url": null
},
"filter_condition": null
},
"triggered_by_agents": [
{
"id": "<string>",
"name": "<string>"
}
]
}{
"code": "<string>",
"message": "<string>",
"data": "<unknown>"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
The API version to use.
2025-06-19 Path Parameters
The ID of the procedural agent to retrieve. Use pa_8qm9JBCiTe7 for the latest version, or pa_8qm9JBCiTe7@v2 for a specific version.
Response
Successful response.
Unique identifier for the procedural agent, e.g. pa_8qm9JBCiTe7
Version-specific identifier for the procedural agent instance, e.g. pa_8qm9JBCiTe7@v0
Human-readable name for the procedural agent.
Description of the procedural agent.
Status of this procedural agent version: 'released', 'draft', or 'archived'.
released, draft, archived Full configuration for the procedural agent (e.g. runtime, tools, output).
Show child attributes
Show child attributes
A summary description of the conversational agents that trigger this procedural agent.
Show child attributes
Show child attributes

