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": "conv_…",
    "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.