> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ariacompute.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve an Aria Agent Cloud Agent by ID

> Retrieve an Aria Agent Cloud agent by identifier, returning its model, instructions, tools, and metadata in OpenAI beta shape.

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

```http theme={null}
GET /v1/agents/{agent_id}
```

## Authentication

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

## Path parameters

<ParamField path="agent_id" type="string" required>
  Agent identifier.
</ParamField>

## Response

<ResponseField name="id" type="string">
  Agent identifier.
</ResponseField>

<ResponseField name="object" type="string">
  Always `agent`.
</ResponseField>

<ResponseField name="name" type="string">
  Display name.
</ResponseField>

<ResponseField name="model" type="string">
  Backing model identifier.
</ResponseField>

<ResponseField name="instructions" type="string">
  System instructions for the agent.
</ResponseField>

<ResponseField name="tools" type="array">
  Tool definitions attached to the agent.
</ResponseField>

<ResponseField name="metadata" type="object">
  Free-form metadata.
</ResponseField>

<ResponseField name="created_at" type="integer">
  Unix seconds.
</ResponseField>

## Example

```bash theme={null}
curl https://agent.example.com/v1/agents/ag_0198a... \
  -H "Authorization: Bearer $ARIA_AGENT_KEY"
```

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


## Related topics

- [Retrieve an Aria Agent Cloud Session by ID](/api-reference/agent/sessions/get.md)
- [Delete an Aria Agent Cloud Session by ID](/api-reference/agent/sessions/delete.md)
- [Create Aria Agent Cloud Session for an Agent](/api-reference/agent/sessions/create.md)
- [Delete an Aria Agent Cloud Agent Definition](/api-reference/agent/agents/delete.md)
- [Update an Aria Agent Cloud Agent Definition](/api-reference/agent/agents/update.md)