> ## 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.

# Create Chat Completion

> Send messages to an ARKOS agent

## POST /v1/chat/completions

Create a chat completion with an ARKOS agent using the OpenAI-compatible API format.

### Request Body

```json theme={null}
{
  "model": "arkos-default",
  "messages": [
    {
      "role": "system",
      "content": "You are a helpful assistant with persistent memory."
    },
    {
      "role": "user",
      "content": "Hello! Can you help me understand ARKOS?"
    }
  ],
  "temperature": 0.7,
  "max_tokens": 1000
}
```

### Response

```json theme={null}
{
  "id": "chatcmpl-123",
  "object": "chat.completion",
  "created": 1677652288,
  "model": "arkos-default",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "Hello! I'd be happy to help you understand ARKOS..."
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 42,
    "completion_tokens": 128,
    "total_tokens": 170
  }
}
```

### Parameters

| Parameter   | Type    | Required | Description                                           |
| ----------- | ------- | -------- | ----------------------------------------------------- |
| model       | string  | Yes      | Model identifier (currently supports "arkos-default") |
| messages    | array   | Yes      | Array of message objects with role and content        |
| temperature | float   | No       | Sampling temperature (0.0 to 2.0)                     |
| max\_tokens | integer | No       | Maximum tokens to generate                            |

### Features In Development

* **Coming soon!** Streaming responses
* **Coming soon!** Tool/function calling
* **Coming soon!** Memory context injection
* **Coming soon!** Multi-agent conversations