- Overview
- Authentication
- Agents
- Agent Access
- Agent Alias
- Agent Tags
- Agent Chat Threads
- Agent Comment
- Agent Rating
- Agent Review
- Agent Tools
- Agent User
- Agent User Permission
- Agent Vote
- Agent Type
- Get all AgentsGET
- Create a new AgentPOST
- Get an AgentGET
- Update an AgentPUT
- Delete an AgentDELETE
- Activate an AgentPUT
- Get Agent-Corpus ConnectionsGET
- Delete Agent-Corpus ConnectionsDELETE
- Get Agent-Corpus Connection DetailsGET
- Create Agent-Corpus ConnectionPOST
- Update Agent-Corpus ConnectionPUT
- Delete Agent-Corpus ConnectionDELETE
- Get agent history with paginationGET
- Restore an agent to a previous checkpointPUT
- Create Custom Instructions for an AgentPOST
- Get Agent Prompt HistoryGET
- Create a Recent AgentPOST
- Delete a Recent AgentDELETE
- Get Agent Details with Starred StatusGET
- Create Starred AgentPOST
- Delete Starred AgentDELETE
- Get the Status of an AgentGET
- Get User's Team Role for an AgentGET
- Create or Update an Agent using the Agent BuilderPOST
- Get Agent FilterGET
- Generate an image for an agent based on the provided descriptionPOST
- Get all Agents by ProjectGET
- Get list of Recent AgentsGET
- Get all Starred Agents of the Authenticated UserGET
- Get Agents accessible to the Current User across their TeamsGET
- Get Agents by Project team, User teamGET
- Agent Response
- Get an Agent Response
- Create Agent Response
- Delete an Agent Response
- Get Comments for Agent Response
- Create a Comment for Agent Response
- Create a Feedback for an Agent Response
- Pin an Agent Response
- Unpin an Agent Response
- Get Supporting Content of an Agent Response
- Get Thoughts of an Agent Response
- Get Agent Responses based on filters
- Get Agent Responses of an Agent
- Create Agent Response Log
- Get Pinned Agent Responses
- Update an Agent Response
- Generate Agent Response (Non-Streaming)
- Stream Agent Response (SSE)
- Chat Thread
- Chat Logs
- Conversation Starters
- Teams
- Projects
- Retrieve all Projects
- Create a Project
- Get a Project
- Update a Project
- Delete a Project
- Get Agent Responses using Project ID
- Add a Recent Project for a User
- Add Users to a Project
- Remove a User from a Project
- Get all Workflows for a Project
- Get multiple Projects by their IDs
- Get Projects based on filters
- Get Recent Projects for a User
- Get Projects with Team Details
- Corpora
- Get all Corpus
- Upload a Document to a Corpus
- Create a Corpus
- Get a Corpus
- Update a Corpus
- Delete a Corpus
- Get Corpus Agent Connections
- Get Default Corpus Agent Connection
- Annotate/Tag a Corpus
- Get Conversation Starters for a Corpus
- Get all Documents for a Corpus
- Delete Document(s) from a Corpus
- Check Duplicate Documents in a Corpus
- Get all Permissions for a Corpus
- Create a new Permission for a Corpus
- Delete a user permission for a corpus
- Get all user permissions for a corpus
- Trigger a Refresh (Reindex) of a Corpus
- Get Corpora with Refresh (Reindex) Enabled
- Documents
- Organizations
- Get all Configurations
- Get active configuration for an Organization
- Get the Model Deployment for an Organization
- Get all Tools in an Organization
- Disable a Tool for all Agents in an Organization
- Enable a Tool for all Agents in an Organization
- Get all API Tool Templates
- Create a new API Tool Template
- Create a new API tool
- Create an attachment tool
- Create a new RAG tool in an Organization
- Create a Web Search Tool in an Organization
- Get all Users in an Organization
- Create a User in an Organization
- Get all Configurations of user's Organization
- Get all LLM configurations of the user's Organization
- Get a specific LLM configuration by ID
- Users
- Get a User
- Update a User
- Delete a User
- Get Agent Responses of a User
- Get all User Permissions
- Create a new User Organization Permission
- Update the Organization Permission of a User
- Delete a User Organization Permission
- Get Projects of a User
- Get all Workflow Tables for a User
- Get all Workflows for a User
- Delete multiple Users
- Get a specific User by user_email
- Get all Users
- Get authenticated User
- Get User Projects
- Analytics
- Get Agent Cost Data
- Get Agent Document Count Data
- Get Agent Indexing Mode Data
- Get Agent Most Active Data
- Get Agent Query Count Data
- Get Recent Agent Data
- Get Agent Summary Statistics
- Get Agent Token Data
- Get Agent Vote Data
- Get Corpus Document Count Data
- Get Corpus Indexing Mode Data
- Get Cost Data
- Get Document Count Data
- Get Indexing Mode Data
- Get Project Cost Data
- Get Project Document Count Data
- Get Project Indexing Mode Data
- Get Project Most Active Data
- Get Project Query Count Data
- Get Recent Project Data
- Get Project Summary Statistics
- Get Project Token Data
- Get Project Vote Data
- Get Overall Summary Statistics
- Get Team Cost Data
- Get Team Document Count Data
- Get Team Indexing Mode Data
- Get Team Most Active Data
- Get Team Query Count Data
- Get Recent Team Data
- Get Team Summary Statistics
- Get Team Token Data
- Get Team Vote Data
- Get Total Entity Counts
- Get User Cost Data
- Get User Document Count Data
- Get User Indexing Mode Data
- Get User Most Active Data
- Get User Query Count Data
- Get Recent User Data
- Get User Summary Statistics
- Get User Token Data
- Get User Vote Data
- Get Vote Count Data
- Get Query Count Data
- Get Token Data
- Configurations
- Evaluations
- Retrieve all evaluations or filter by dataset
- Create a new evaluation
- Delete a set of evaluations or a specific evaluation
- Retrieve all evaluation datasets for a specific agent
- Create a new evaluation dataset for the given agent
- Delete multiple datasets or all datasets for an agent
- Retrieve a specific evaluation
- Update an evaluation run
- Delete a specific evaluation
- List query results for an evaluation run
- Create a query result and save metrics
- Retrieve a specific dataset
- Update an evaluation dataset
- Delete a specific dataset
- Retrieve queries for an evaluation dataset
- Create a new query for evaluation
- Retrieve all unique tags from all datasets in the organization
- Get a specific metric result by ID
- Retrieve all metrics or filter by category name
- Create a new metric
- Retrieve a specific metric
- Update a metric
- Delete a metric
- Get all metric results for a specific metric
- Create a new metric result entry for the given metric
- Retrieve a specific evaluation query
- Update an evaluation query
- Delete an evaluation query
- Get a specific query result with metrics
- Update a query result
- Guardrails
- Feature Flags
- Get All Feature Flags
- Get Agent Alias Feature Flag
- Get Api Tools Feature Flag
- Get Caching Feature Flag
- Get Chat Agent Creation Feature Flag
- Get dall_e Image Generation Feature Flag
- Get Developer Portal Feature Flag
- Get Guardrail Feature Flag
- Get PII Redaction Feature Flag
- Get Share Agent Feature Flag
- Get Sharepoint Connector Feature Flag
- Get Sharepoint Index Feature Flag
- Get Youtube Index Feature Flag
- Notifications
- Tools
- Workflows
- Get all Workflows
- Create a Workflow
- Get a Workflow
- Update a Workflow
- Delete a Workflow
- Get all Workflow Chat Threads
- Create a Workflow Chat Thread
- Get a Workflow Chat Thread
- Update a Workflow Chat Thread
- Delete a Workflow Chat Thread
- Get all Workflow Chat Responses
- Create a Workflow Chat Response
- Delete a Workflow Response
- Create a Workflow Feedback
- Create a Workflow Review
- Retrieve a list of reviews for a given workflow response
Create Custom Instructions for an Agent
POST
/api/v2/agents/{agent_id}/instructions
Request
Path Params
Header Params
Body Params application/json
Examples
Responses
🟢200OK
application/json
Body
🟠400Bad Request
🔴500Server Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request POST 'https:///api/v2/agents//instructions' \
--header 'Ocp-Apim-Subscription-Key: ' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
"custom_instructions": [
"string"
],
"created_by": "[email protected]"
}'Response Response Example
200 - Example 1
{
"success": true,
"message": "string",
"data": {
"items": [
{
"id": 0,
"instruction": "string",
"created_by": "string",
"created_on": "2019-08-24T14:15:22Z",
"agent_id": 0
}
]
}
}