.svg?fit=max&auto=format&n=fnPhXvYfm-TNmZho&q=85&s=dc407af2e287b4714cedea5b8d7abf4d){kind=logo}
API reference
MCP tools
Platform
Workflows
SLA
Apps platform
Help Center
curl --request PUT \
--url https://agent-studio.thena.ai/api/v1/agents/{agent_id} \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"configuration": {
"communication_style": "FORMAL",
"core_capabilities": [
"enterprise sales",
"negotiation",
"solution selling"
],
"expertise_level": "EXPERT",
"goal": "Drive enterprise sales",
"knowledge_domains": [
"enterprise sales",
"B2B",
"solution architecture"
],
"personality_traits": [
"strategic",
"persuasive",
"consultative"
],
"role": "Senior Sales Representative",
"tone": "Professional"
},
"description": "Updated description",
"metadata": {
"updated_by": "admin"
},
"name": "Updated Sales Assistant",
"status": "inactive"
}
'{
"bot_sub": "VVYZYKNJ10E18462MAKTHQRW4C142",
"completed_flows_count": 42,
"configuration": {
"language": "English",
"team_size": 5,
"tone": "Professional"
},
"created_at": "2023-01-01T00:00:00Z",
"description": "Customized sales assistant for my team",
"files": [],
"id": "123e4567-e89b-12d3-a456-426614174000",
"metadata": {
"created_by": "admin",
"updated_by": "admin"
},
"name": "My Sales Assistant",
"organization_id": "123e4567-e89b-12d3-a456-426614174000",
"pending_flows_count": 5,
"status": "active",
"team_id": [
"team-1",
"team-2"
],
"template_id": "123e4567-e89b-12d3-a456-426614174000",
"updated_at": "2023-01-01T00:00:00Z"
}Update Agent
Update an agent.
curl --request PUT \
--url https://agent-studio.thena.ai/api/v1/agents/{agent_id} \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"configuration": {
"communication_style": "FORMAL",
"core_capabilities": [
"enterprise sales",
"negotiation",
"solution selling"
],
"expertise_level": "EXPERT",
"goal": "Drive enterprise sales",
"knowledge_domains": [
"enterprise sales",
"B2B",
"solution architecture"
],
"personality_traits": [
"strategic",
"persuasive",
"consultative"
],
"role": "Senior Sales Representative",
"tone": "Professional"
},
"description": "Updated description",
"metadata": {
"updated_by": "admin"
},
"name": "Updated Sales Assistant",
"status": "inactive"
}
'{
"bot_sub": "VVYZYKNJ10E18462MAKTHQRW4C142",
"completed_flows_count": 42,
"configuration": {
"language": "English",
"team_size": 5,
"tone": "Professional"
},
"created_at": "2023-01-01T00:00:00Z",
"description": "Customized sales assistant for my team",
"files": [],
"id": "123e4567-e89b-12d3-a456-426614174000",
"metadata": {
"created_by": "admin",
"updated_by": "admin"
},
"name": "My Sales Assistant",
"organization_id": "123e4567-e89b-12d3-a456-426614174000",
"pending_flows_count": 5,
"status": "active",
"team_id": [
"team-1",
"team-2"
],
"template_id": "123e4567-e89b-12d3-a456-426614174000",
"updated_at": "2023-01-01T00:00:00Z"
}Authorizations
Path Parameters
Body
New name for the agent
New description for the agent
Updated configuration settings
Show child attributes
Show child attributes
The specific role/job title of the agent
Primary objective/purpose of the agent
Background story and context for the agent
Initial message from the agent
The emotional tone of the agent's responses
How the agent communicates with others
Key personality characteristics
Level of expertise in the agent's domain
List of primary skills and capabilities
Specific areas of knowledge
How independently the agent makes decisions (0-1)
0 <= x <= 1Likelihood to delegate tasks to other agents (0-1)
0 <= x <= 1Whether to use streaming LLM service instead of CrewAI for message processing
List of agent roles this agent works best with
Preferred length of responses (brief/moderate/detailed)
Number of past interactions to consider
x >= 1Whether to show follow-up suggestions after each assistant message
Custom prompt for generating suggestions
Whether to include real-time context from the user's current view
Custom prompt explaining the real-time context to the LLM
Maximum size (in characters) of context data to include
Whether to include memory context (entities and facts) from the conversation
Customizable internal instructions for agent response formatting and behavior.
Customizable format for the agent to use when confirming ticket creation.
Customizable instructions for the user, displayed in the system prompt.
Maximum number of iteration attempts for a task
Maximum time allowed for task completion
List of tool names this agent can use
Additional custom configuration parameters
Customizable instructions specifically for the chat widget context.
New status for the agent
New avatar URL for the agent
Updated metadata for the agent
Response
Successful Response
Name of the agent
Agent-specific configuration settings
Show child attributes
Show child attributes
The specific role/job title of the agent
Primary objective/purpose of the agent
Background story and context for the agent
Initial message from the agent
The emotional tone of the agent's responses
How the agent communicates with others
Key personality characteristics
Level of expertise in the agent's domain
List of primary skills and capabilities
Specific areas of knowledge
How independently the agent makes decisions (0-1)
0 <= x <= 1Likelihood to delegate tasks to other agents (0-1)
0 <= x <= 1Whether to use streaming LLM service instead of CrewAI for message processing
List of agent roles this agent works best with
Preferred length of responses (brief/moderate/detailed)
Number of past interactions to consider
x >= 1Whether to show follow-up suggestions after each assistant message
Custom prompt for generating suggestions
Whether to include real-time context from the user's current view
Custom prompt explaining the real-time context to the LLM
Maximum size (in characters) of context data to include
Whether to include memory context (entities and facts) from the conversation
Customizable internal instructions for agent response formatting and behavior.
Customizable format for the agent to use when confirming ticket creation.
Customizable instructions for the user, displayed in the system prompt.
Maximum number of iteration attempts for a task
Maximum time allowed for task completion
List of tool names this agent can use
Additional custom configuration parameters
Customizable instructions specifically for the chat widget context.
Unique identifier for the agent
ID of the template this agent was created from
ID of the organization that owns this agent
Current status of the agent (active, inactive, etc)
When the agent was created
When the agent was last updated
Description of the agent's purpose and capabilities
URL of the agent's avatar image
Additional metadata for the agent
List of files associated with this agent
Show child attributes
Show child attributes
Unique identifier for the file
ID of the agent this file belongs to
ID of the organization that owns this file
Name of the file
Path to the file in storage bucket
Size of the file in bytes
MIME type of the file
When the file was created
When the file was last updated
Additional metadata for the file
List of team IDs this agent belongs to
Count of successfully completed flow executions
Count of pending and running flow executions
Bot subscriber ID used for executing flows
Platform app installation ID
Platform app ID
Platform app slug