API & SDK

Send your first API message

Invoke a published agent with HTTP and process its response.

Updated August 3, 2026 · 8 min

Check the agent

curl https://api.inceptiva.com/v1/agents/AGENT_ID \
  -H "Authorization: Bearer $INCEPTIVA_API_KEY"

Create a response

curl -X POST https://api.inceptiva.com/v1/agents/AGENT_ID/responses \
  -H "Authorization: Bearer $INCEPTIVA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message":"What services does Inceptiva offer?","conversation_id":null,"metadata":{"source":"help-center"}}'

message is required and accepts up to 10,000 characters. conversation_id, external_reference, and metadata are optional.

Process the result

{"conversation_id":"uuid","response":"Agent response","citations":[]}

Store conversation_id to continue the dialogue. Citations appear only when channel and knowledge policies allow them.

Was this helpful?