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

# Get Agent Status

> Retrieve the current status of an ARKOS agent

## GET /v1/agents/{agent_id}

**Coming soon!** This endpoint will retrieve the current status and configuration of a specific ARKOS agent.

### Planned Features

* Agent state information
* Memory statistics
* Active tool configurations
* Conversation history
* Performance metrics

### Example Request

```bash theme={null}
curl -X GET "http://localhost:8000/v1/agents/default" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Example Response (Planned)

```json theme={null}
{
  "id": "default",
  "name": "Default ARKOS Agent",
  "status": "active",
  "model": {
    "provider": "openai",
    "name": "gpt-4"
  },
  "memory": {
    "total_entries": 1523,
    "working_memory": 12,
    "long_term_memory": 1511
  },
  "state": {
    "current": "waiting_for_input",
    "transitions": 45
  },
  "tools": [
    "weather",
    "calendar"
  ],
  "created_at": "2024-01-01T00:00:00Z",
  "last_active": "2024-01-15T14:30:00Z"
}
```

<Note>
  This endpoint is not yet implemented. The structure above represents the planned API design.
</Note>