GETTING STARTED

First requests

TypeScript

import { Inceptiva } from "@inceptiva/sdk";

const client = new Inceptiva({
  apiKey: process.env.INCEPTIVA_API_KEY!,
  agentId: process.env.INCEPTIVA_AGENT_ID!,
});

const result = await client.responses.create({
  message: "Analyze this opportunity",
  externalReference: "opportunity-123",
  idempotencyKey: crypto.randomUUID(),
});
console.log(result.response, result.conversationId, result.citations);

Python

python

client = Inceptiva(api_key=api_key, agent_id=agent_id)
result = client.responses.create(message="Analyze this opportunity")
print(result.response, result.conversation_id)

curl

shell

curl --request POST \
  "$INCEPTIVA_API_BASE_URL/v1/agents/$INCEPTIVA_AGENT_ID/responses" \
  --header "Authorization: Bearer $INCEPTIVA_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"message":"Analyze this opportunity"}'

Pass the latest conversation identifier in the next request to preserve context. Paginate history with { page: 1, pageSize: 50 }; response metadata contains rate limits, usage, and replay state. Reuse the same idempotency key after an uncertain network result.

Continue with Conversations or Error handling.