> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agntix.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Agent
> Retrieve a single agent by UUID, including its model, tools, and knowledge store.
Every endpoint on this page requires either a Clerk-issued JWT (`Authorization: Bearer `) or
an organization API key (`x-api-key: pk_…`). Anonymous calls return `401 Unauthorized`. See
[Authentication](/authentication) for the full setup.
## Code examples
```bash curl theme={null}
curl https://api.agntix.ai/v2/chat/agents/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
-H "x-api-key: pk_live_••••"
```
```javascript Node.js theme={null}
const agentId = 'a1b2c3d4-e5f6-7890-abcd-ef1234567890';
const res = await fetch(`https://api.agntix.ai/v2/chat/agents/${agentId}`, {
headers: { 'x-api-key': 'pk_live_••••' },
});
const agent = await res.json();
console.log('Tools attached:', agent.agentTools?.length ?? 0);
```
```python Python theme={null}
import httpx
agent_id = "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
agent = httpx.get(
f"https://api.agntix.ai/v2/chat/agents/{agent_id}",
headers={"x-api-key": "pk_live_••••"},
).json()
print("Model:", agent["model"]["name"])
```
## Sample response
```json theme={null}
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"fullName": "Customer Support Bot",
"description": "Handles tier-1 customer queries",
"role": "You are a helpful, concise support agent for Acme Inc.",
"language": "en",
"systemPrompt": "You specialize in billing, returns, and account access.",
"voiceEnabled": false,
"isActive": true,
"isPublic": false,
"orgId": "org_2abc123",
"model": {
"id": "96f3b0a3-1234-5678-abcd-ef1234567890",
"name": "gpt-4.1",
"provider": "openai"
},
"agentTools": [
{
"tool": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "GET_ACCOUNT_BALANCE",
"description": "Retrieves the current account balance."
}
}
],
"agentKnowledgeStore": null,
"createdAt": "2026-04-29T08:00:00Z",
"updatedAt": "2026-04-29T08:00:00Z"
}
```
## OpenAPI
````yaml GET /v2/chat/agents/{id}
openapi: 3.0.3
info:
title: Agntix API
version: 1.0.0
description: >-
The Agntix API lets you build, deploy, and operate AI chat and voice agents.
All requests are sent to `https://api.agntix.ai`. Authenticate with an API
key (`x-api-key`) or a Clerk-issued JWT (`Authorization: Bearer `).
Base URL: `https://api.agntix.ai`
servers:
- url: https://api.agntix.ai
description: Production
security:
- ApiKeyAuth: []
- BearerAuth: []
tags:
- name: Agents
description: >-
Create and manage AI agents — the core building block of Agntix. An agent
encapsulates a system prompt, LLM, tools, knowledge store, and voice
configuration.
- name: Chat
description: >-
Open chat sessions with an agent and exchange messages. Supports streaming
responses over SSE.
- name: Voice
description: >-
List available voices and TTS/STT models, and create real-time voice
sessions.
- name: Tools
description: >-
Extend agent capabilities with API tools (webhook calls) or function tools
(server-side logic).
- name: Phone Numbers
description: >-
Provision and manage telephony numbers for inbound and outbound voice
calls.
- name: Models
description: Browse available LLM, STT, and TTS models supported by Agntix.
- name: Analytics
description: Query call and agent-level performance metrics.
- name: API Keys
description: Create and manage organization-scoped API keys.
- name: Contacts
description: Manage customer contacts that can be linked to chat sessions.
- name: Call Campaigns
description: Launch and manage outbound call campaigns against a list of contacts.
- name: Subscriptions
description: View billing plans, usage quotas, and manage Stripe subscriptions.
paths:
/v2/chat/agents/{id}:
get:
tags:
- Agents
summary: Get agent
description: >-
Retrieves a single agent by its UUID, including its model, attached
tools, knowledge store, and voice configuration.
operationId: getAgent
parameters:
- name: id
in: path
required: true
description: Agent UUID.
schema:
type: string
format: uuid
responses:
'200':
description: Agent detail.
content:
application/json:
schema:
$ref: '#/components/schemas/AgentDetail'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
components:
schemas:
AgentDetail:
allOf:
- $ref: '#/components/schemas/Agent'
- type: object
properties:
model:
type: object
properties:
id:
type: string
format: uuid
name:
type: string
provider:
type: string
agentTools:
type: array
items:
type: object
properties:
tool:
$ref: '#/components/schemas/Tool'
agentKnowledgeStore:
type: object
nullable: true
properties:
id:
type: string
name:
type: string
Agent:
type: object
properties:
id:
type: string
format: uuid
example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
fullName:
type: string
example: Customer Support Bot
description:
type: string
example: Handles tier-1 customer queries
role:
type: string
example: You are a helpful support agent for Acme Inc.
language:
type: string
example: en
systemPrompt:
type: string
voiceEnabled:
type: boolean
example: false
voicePipelineMode:
type: string
nullable: true
isActive:
type: boolean
example: true
isPublic:
type: boolean
example: false
orgId:
type: string
example: org_2abc123
modelId:
type: string
format: uuid
createdAt:
type: string
format: date-time
example: '2026-04-28T11:42:11Z'
updatedAt:
type: string
format: date-time
example: '2026-04-28T11:42:11Z'
Tool:
type: object
properties:
id:
type: string
format: uuid
name:
type: string
example: GET_ACCOUNT_BALANCE
description:
type: string
type:
type: string
enum:
- API_TOOL
- FUNCTION_TOOL
ajvPropertiesSchema:
type: object
orgId:
type: string
createdAt:
type: string
format: date-time
updatedAt:
type: string
format: date-time
Error:
type: object
properties:
error:
type: object
properties:
code:
type: string
example: NOT_FOUND
message:
type: string
example: Resource not found.
status:
type: integer
example: 404
meta:
type: object
properties:
requestId:
type: string
timestamp:
type: string
format: date-time
responses:
Unauthorized:
description: Missing or invalid authentication credentials.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: UNAUTHORIZED
message: Authentication required.
status: 401
meta:
requestId: req_01j3m...
timestamp: '2026-04-29T10:00:00Z'
NotFound:
description: Resource not found.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: NOT_FOUND
message: Agent not found.
status: 404
meta:
requestId: req_01j3m...
timestamp: '2026-04-29T10:00:00Z'
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: >-
Organization API key. Obtain from the
[dashboard](https://app.agntix.ai/settings/api-keys). Format:
`pk_live_…`
BearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: 'Clerk-issued JWT. Use `Authorization: Bearer `.'
````