Update AI Agent Basic Information

Used to update the basic information (persona) of an existing AI agent. This typically includes fields like name, role, tags, description, and logo, but not AI-specific configurations.

API Endpoint

Property	Value
Request Method	POST
Request URL	https://api.seliseblocks.com/agents/update-persona

Request

Request Example

curl -X POST 'https://api.seliseblocks.com/agents/update-persona' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "agent_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Customer Support Agent",
    "tags": ["support", "customer-service", "chatbot"],
    "description": "An AI agent specialized in handling customer support inquiries",
    "logo_url": "https://example.com/logo.png",
    "logo_id": "logo_123456",
    "project_key": "YOUR_PROJECT_KEY"
  }'

Request Headers

Field	Type	Required	Description
accept	string	Yes	Accepted response format. Use application/json
Content-Type	application/json	Yes	Data type, must be application/json.

Request Body

Request Body Schema

{
  "agent_id": "string",
  "name": "string",
  "tags": [
    "string"
  ],
  "description": "string",
  "logo_url": "string",
  "logo_id": "string",
  "project_key": "string"
}

Request Body Parameters

Field	Type	Required	Description
agent_id	string	Yes	Unique identifier of the agent to be updated.
name	string	Yes	The updated name of the AI agent.
tags	array	No	Array of tags/labels to categorize the agent.
description	string	No	Updated description of the agent's purpose and functionality.
logo_url	string	No	URL of the agent's logo image.
logo_id	string	No	Unique identifier for the logo asset.
project_key	string	Yes	The project key for your project.

Response

Success Response (200 OK)

Returns an object containing the update status and details.

{
  "is_success": true,
  "item_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "detail": "Agent persona updated successfully",
  "error": {}
}

Response Fields

Field	Type	Description
is_success	boolean	Indicates whether the agent update was successful.
item_id	string	Unique identifier for the updated agent.
detail	string	Success or failure message with additional context.
error	object	Error details if the operation failed (empty if successful).

Error Response (422 Unprocessable Entity)

Returns validation error details when the request body is invalid.

{
  "detail": [
    {
      "loc": [
        "body",
        "agent_id"
      ],
      "msg": "field required",
      "type": "value_error.missing"
    }
  ]
}

Error Response Fields

Field	Type	Description
detail	array	Array of validation error objects.
loc	array	Location of the error in the request (e.g., body field).
msg	string	Human-readable error message.
type	string	Error type identifier.

Error Codes

Status Code	Description	Response Type
200	Successful Response	Success
422	Validation Error - Invalid request parameters	Unprocessable Entity