Retrieve an Aria Agent Cloud Agent by ID

Retrieve an agent by identifier. The response is OpenAI beta Agents compatible, so client SDKs written for OpenAI’s Agents resource work against Aria Agent Cloud without changes.

Endpoint

GET /v1/agents/{agent_id}

Authentication

Authorization: Bearer <api_key> or Authorization: ApiKey <api_key>.

Path parameters

string

required

Agent identifier.

Response

string

Agent identifier.

string

Always agent.

string

Display name.

string

Backing model identifier.

string

System instructions for the agent.

array

Tool definitions attached to the agent.

object

Free-form metadata.

integer

Unix seconds.

Example

curl https://agent.example.com/v1/agents/ag_0198a... \
  -H "Authorization: Bearer $ARIA_AGENT_KEY"

{
  "id": "ag_0198a...",
  "object": "agent",
  "name": "support-triage",
  "model": "gpt-4o-mini",
  "instructions": "You are a triage agent...",
  "tools": [],
  "metadata": {},
  "created_at": 1735000000
}

PIN API

ROUTER API

AGENT API

Retrieve an Aria Agent Cloud Agent by ID

Endpoint

Authentication

Path parameters

Response

Example

​Endpoint

​Authentication

​Path parameters

​Response

​Example

Endpoint

Authentication

Path parameters

Response

Example