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.
This means your API key determines which agents and knowledge can be used.
The External Agent API provides programmatic access to agents using your dataset. Create agents, update their configuration, and chat with them using RAG-powered responses based on your knowledge base.
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
Last updated