Conversations

A Conversation groups related runs into a single multi-turn thread, so an agent carries context from one turn to the next.

Each turn is still its own run. To continue a conversation, pass its conversationId when you start a run:

curl https://api.nicia.ai/v1/runs \
  -H "x-api-key: $NICIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agentId": "…",
    "conversationId": "0c7f1e9a-2b4d-4f3a-9c1e-8a2d6f4b0c7f",
    "input": { "prompt": "And summarize that in one line." }
  }'

Create and list conversations under /v1/conversations; list the runs in one with GET /v1/conversations/{id}/runs. See the API reference for the full set.

If you just want one-shot invocations, you can ignore conversations entirely — omit conversationId and each run stands alone.