Inflectiv Docs›API Reference›External Agent API
API Reference

External Agent API

Programmatically access and interact with agents connected to your datasets.

External Agent API

Dataset-scoped Agent Access & Chat

The External Agent API lets you programmatically access and interact with agents connected to your datasets.

You can create agents, update their configuration, and chat with them using AI responses powered by your knowledge base.

Access model

API keys in Inflectiv are scoped to a single dataset.

  • Any agent connected to that dataset can be accessed using the dataset's API key
  • This enables secure and flexible agent sharing while maintaining dataset-level access control
Info
Your API key determines which agents and knowledge can be used.

Available endpoints

List agents

GET /api/v1/ext/agents/

Returns all agents attached to the dataset linked to your API key.

Cost: Free

Create agent

POST /api/v1/ext/agents/

Creates a new agent connected to the dataset associated with your API key.

Cost: 5 credits

Get agent details

GET /api/v1/ext/agents/{agent}

Returns details for a specific agent by ID.

Cost: Free

Update agent configuration

PUT /api/v1/ext/agents/{agent}/config

Updates the configuration of an existing agent.

Cost: 2 credits

Chat with agent

POST /api/v1/ext/agents/{agent}/chat

Send a message to an agent and receive an AI-generated response based on your dataset (RAG-powered).

Cost: 1 credit per request