Agents
Update an agent and atomically replace its attachment set
PATCH
/
v1
/
agents
/
{id}
Update an agent and atomically replace its attachment set
curl --request PATCH \
--url https://api.lusor.ai/v1/agents/{id} \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"color": "<string>",
"avatar": "<string>",
"description": "<string>",
"model": "<string>",
"devices": [
{
"device_id": "<string>",
"label": "<string>",
"description": "<string>",
"position": 5000
}
]
}
'const options = {
method: 'PATCH',
headers: {'X-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
workspaceId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
name: '<string>',
color: '<string>',
avatar: '<string>',
description: '<string>',
model: '<string>',
devices: [
{
device_id: '<string>',
label: '<string>',
description: '<string>',
position: 5000
}
]
})
};
fetch('https://api.lusor.ai/v1/agents/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.lusor.ai/v1/agents/{id}"
payload = {
"workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"color": "<string>",
"avatar": "<string>",
"description": "<string>",
"model": "<string>",
"devices": [
{
"device_id": "<string>",
"label": "<string>",
"description": "<string>",
"position": 5000
}
]
}
headers = {
"X-Api-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text){
"data": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"color": "<string>",
"avatar": "<string>",
"description": "<string>",
"model": "<string>",
"archivedAt": "2023-11-07T05:31:56Z",
"purgeAfter": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"lastTurnAt": "2023-11-07T05:31:56Z",
"lastTurnSnippet": "<string>",
"devices": [
{
"deviceId": "<string>",
"label": "<string>",
"description": "<string>",
"position": 123,
"createdAt": "2023-11-07T05:31:56Z"
}
],
"turns": [
{
"id": "<string>",
"sessionId": "<string>",
"prompt": "<string>",
"status": "<string>",
"deviceId": "<string>",
"summary": "<string>",
"recording": true,
"queued": true,
"createdAt": "2023-11-07T05:31:56Z",
"startedAt": "2023-11-07T05:31:56Z",
"completedAt": "2023-11-07T05:31:56Z"
}
],
"turnsCursor": "<string>",
"turnsHasMore": true,
"activityAt": "2023-11-07T05:31:56Z"
}
}{
"error": "validation_error",
"details": {}
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}Authorizations
ApiKeyBearerAuth
Workspace API key, created in the dashboard under Settings → API Keys.
Path Parameters
Agent UUID. Missing, inaccessible, and malformed IDs return an opaque 404.
Body
application/json
Optional for workspace-scoped API keys.
Required string length:
1 - 255Required string length:
1 - 64Avatar id. Omit on create for a random emoji; null is rejected.
Pattern:
^(emojis|apps|other)/[a-z0-9-]{1,64}$Maximum string length:
4096Provider-qualified model id, for example deepseek/deepseek-flash
(the default), openai/gpt-6-luna or anthropic/claude-opus-5-5.
auto is accepted as an alias for the default model and is
stored as deepseek/deepseek-flash.
Required string length:
1 - 255An agent uses at most one device. Supplying the array replaces the current attachment atomically (single RPC) — this is the "move my agent to another phone" flow. At most one entry is accepted; a second is rejected with a 400.
Maximum array length:
1Show child attributes
Show child attributes
Response
Agent updated
Show child attributes
Show child attributes
Was this page helpful?
⌘I
Update an agent and atomically replace its attachment set
curl --request PATCH \
--url https://api.lusor.ai/v1/agents/{id} \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"color": "<string>",
"avatar": "<string>",
"description": "<string>",
"model": "<string>",
"devices": [
{
"device_id": "<string>",
"label": "<string>",
"description": "<string>",
"position": 5000
}
]
}
'const options = {
method: 'PATCH',
headers: {'X-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
workspaceId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
name: '<string>',
color: '<string>',
avatar: '<string>',
description: '<string>',
model: '<string>',
devices: [
{
device_id: '<string>',
label: '<string>',
description: '<string>',
position: 5000
}
]
})
};
fetch('https://api.lusor.ai/v1/agents/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.lusor.ai/v1/agents/{id}"
payload = {
"workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"color": "<string>",
"avatar": "<string>",
"description": "<string>",
"model": "<string>",
"devices": [
{
"device_id": "<string>",
"label": "<string>",
"description": "<string>",
"position": 5000
}
]
}
headers = {
"X-Api-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text){
"data": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"color": "<string>",
"avatar": "<string>",
"description": "<string>",
"model": "<string>",
"archivedAt": "2023-11-07T05:31:56Z",
"purgeAfter": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"lastTurnAt": "2023-11-07T05:31:56Z",
"lastTurnSnippet": "<string>",
"devices": [
{
"deviceId": "<string>",
"label": "<string>",
"description": "<string>",
"position": 123,
"createdAt": "2023-11-07T05:31:56Z"
}
],
"turns": [
{
"id": "<string>",
"sessionId": "<string>",
"prompt": "<string>",
"status": "<string>",
"deviceId": "<string>",
"summary": "<string>",
"recording": true,
"queued": true,
"createdAt": "2023-11-07T05:31:56Z",
"startedAt": "2023-11-07T05:31:56Z",
"completedAt": "2023-11-07T05:31:56Z"
}
],
"turnsCursor": "<string>",
"turnsHasMore": true,
"activityAt": "2023-11-07T05:31:56Z"
}
}{
"error": "validation_error",
"details": {}
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}