# One-shot reply (stateless — no memory)

> POST /chat/complete. HeyRik API parameters and documented request and response examples.

Source: https://www.heyrik.com/docs/api-reference/chat/post-chat-complete-one-shot-reply-stateless-no-memory

POST https://server.heyrik.com/api/v1/chat/complete

## Headers

Authorization: Bearer $HEYRIK_API_KEY (required). Keep your key on your server.

## Parameters

- agent_id (string, required): The agent to answer (from POST /agents). `agency_id` also accepted.
- message (string): A single user message — the simplest form.
- messages (object[]): OR the full turn history you want considered: [{ role: "user" | "assistant", content }]. Use this to give context, since nothing is remembered between calls. Send one of message or messages.

## Notes

Stateless: it remembers nothing between calls. For a back-and-forth conversation, either pass the whole messages[] each time, or use a session (below) which keeps the history for you.

## Request example

```sh
curl -X POST https://server.heyrik.com/api/v1/chat/complete \
  -H "Authorization: Bearer $HEYRIK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agc_9f2a1c30",
    "message": "What are your timings?"
  }'
```

## Response example

```json
{
  "data": {
    "reply": "We are open Monday to Saturday, 9:00 AM to 6:00 PM.",
    "credits_charged": 1,
    "balance_credits": 4975
  }
}
```
