API & SDK

Introduction to the API and SDKs

Choose between the REST API and official SDKs to integrate an Inceptiva agent.

Updated August 3, 2026 · 7 min

What you can build

The public API connects a published agent to your backend. It supports capabilities, messages, regular or streamed responses, and conversation management. Agent configuration, knowledge bases, and tools remain in Studio.

Choose an integration

Use an official SDK for TypeScript/Node.js, Python, or .NET. They provide types, idiomatic names, typed errors, streaming, and cancellation. Use REST directly for other languages or full HTTP control.

Required credentials

  • AGENT_ID: public identifier generated by the API channel.
  • INCEPTIVA_API_KEY: private key beginning with inc_live_.

Use API keys only on servers—never browsers, mobile apps, or repositories.

See the SDK documentation and OpenAPI contract.