Update persona
Edit a caller persona or toggle its workspace availability. Content fields (name, prompt, gender, language, accent, voiceId, interruptionLevel, speed) only work on CUSTOM personas, predefined ones are immutable (recreate the behaviour as a custom persona with create_persona instead). The `enabled` toggle works on every persona, predefined included, and controls whether it appears in the personality-sweep picker (run_all_tests personaIds). Pass only the fields to change.
Authorization
bearerAuth A personal access token from Settings > API tokens.
In: header
Header Parameters
A key you choose, such as a UUID, that makes this POST safe to retry. Within 24 hours the same key and request answers with the first successful answer and runs nothing, the same key with a different request answers 422 idempotency_key_reused, and a key whose request is still running answers 409 idempotency_key_in_use. A failed request keeps nothing, so the same key runs it again.
1 <= length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/operations/update_persona" \ -H "Content-Type: application/json" \ -d '{ "personaId": "string", "agent": "string" }'{}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}Update dashboard POST
Edit an Overview dashboard's chrome: rename it, change the default time range its widgets resolve against (Grafana-style 'now-7d' → 'now'), re-scope the agent multi-select, or toggle daily-report inclusion. Pass only the fields to change. Widgets are separate, add with add_dashboard_plot, remove with delete_dashboard_widget.
Update my preferences POST
Change your own preferences. Pass only what you want to change. builderApprovalDefault can be set to 'review' (every change waits for approval) or 'plan' (read and propose only); voiceInput shows or hides the dictation button; askBeforePaidTestRuns: true turns on the confirmation before paid test runs. Loosening a safeguard (approval 'auto', or askBeforePaidTestRuns false) is refused: you change those yourself in Settings → Preferences. The theme is set per device in the app and cannot be changed here.