Update an agent's configuration
curl --request PATCH \
--url https://api.ando.so/v1/agents/{agentId}/configuration \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '{}'const options = {
method: 'PATCH',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
fetch('https://api.ando.so/v1/agents/{agentId}/configuration', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.ando.so/v1/agents/{agentId}/configuration"
payload = {}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text){
"data": {
"object": "agent_configuration",
"agent_id": "01jzn7e61x3a7v9h2r7t2m3q4p",
"instructions": "<string>",
"model_id": "<string>",
"role_name": "<string>",
"app_access": {
"connection_ids": [
"<string>"
],
"excluded_connection_ids": [
"<string>"
],
"enabled_connection_tools": [
{
"connection_id": "01jzn7e61x3a7v9h2r7t2m3q4p",
"tool_names": [
"<string>"
]
}
],
"github_repository_ids": [
"<string>"
],
"apps": [
{
"connection_id": "01jzn7e61x3a7v9h2r7t2m3q4p",
"display_name": "<string>",
"tool_names": [
"<string>"
]
}
]
},
"updated_at": "2026-05-14T08:00:00.000Z"
}
}{
"error": "<string>",
"error_code": "<string>",
"type": "invalid_request_error",
"request_id": "<string>",
"missing_scopes": [
"<string>"
]
}{
"error": "<string>",
"error_code": "<string>",
"type": "invalid_request_error",
"request_id": "<string>",
"missing_scopes": [
"<string>"
]
}{
"error": "<string>",
"error_code": "<string>",
"type": "invalid_request_error",
"request_id": "<string>",
"missing_scopes": [
"<string>"
]
}{
"error": "<string>",
"error_code": "<string>",
"type": "invalid_request_error",
"request_id": "<string>",
"missing_scopes": [
"<string>"
]
}{
"error": "<string>",
"error_code": "<string>",
"type": "invalid_request_error",
"request_id": "<string>",
"missing_scopes": [
"<string>"
]
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": "<string>",
"error_code": "<string>",
"type": "invalid_request_error",
"request_id": "<string>",
"missing_scopes": [
"<string>"
]
}Update an agent's configuration
Updates an agent’s instructions, model, role or app access with the same checks as Settings > Members > Agents, and returns the configuration after the change. Omitted fields keep their value. Requires the agents:write scope. A personal-scope agent can only be changed by its creator.
PATCH
https://api.ando.so/v1
/
agents
/
{agentId}
/
configuration
Update an agent's configuration
curl --request PATCH \
--url https://api.ando.so/v1/agents/{agentId}/configuration \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '{}'const options = {
method: 'PATCH',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
fetch('https://api.ando.so/v1/agents/{agentId}/configuration', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.ando.so/v1/agents/{agentId}/configuration"
payload = {}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text){
"data": {
"object": "agent_configuration",
"agent_id": "01jzn7e61x3a7v9h2r7t2m3q4p",
"instructions": "<string>",
"model_id": "<string>",
"role_name": "<string>",
"app_access": {
"connection_ids": [
"<string>"
],
"excluded_connection_ids": [
"<string>"
],
"enabled_connection_tools": [
{
"connection_id": "01jzn7e61x3a7v9h2r7t2m3q4p",
"tool_names": [
"<string>"
]
}
],
"github_repository_ids": [
"<string>"
],
"apps": [
{
"connection_id": "01jzn7e61x3a7v9h2r7t2m3q4p",
"display_name": "<string>",
"tool_names": [
"<string>"
]
}
]
},
"updated_at": "2026-05-14T08:00:00.000Z"
}
}{
"error": "<string>",
"error_code": "<string>",
"type": "invalid_request_error",
"request_id": "<string>",
"missing_scopes": [
"<string>"
]
}{
"error": "<string>",
"error_code": "<string>",
"type": "invalid_request_error",
"request_id": "<string>",
"missing_scopes": [
"<string>"
]
}{
"error": "<string>",
"error_code": "<string>",
"type": "invalid_request_error",
"request_id": "<string>",
"missing_scopes": [
"<string>"
]
}{
"error": "<string>",
"error_code": "<string>",
"type": "invalid_request_error",
"request_id": "<string>",
"missing_scopes": [
"<string>"
]
}{
"error": "<string>",
"error_code": "<string>",
"type": "invalid_request_error",
"request_id": "<string>",
"missing_scopes": [
"<string>"
]
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": "<string>",
"error_code": "<string>",
"type": "invalid_request_error",
"request_id": "<string>",
"missing_scopes": [
"<string>"
]
}Authorizations
AndoApiKeyBearerApiKey
Body
application/json
A partial configuration update. Omitted fields keep their value; unknown fields are refused.