Agent work settings
The Agent work settings endpoints of the Kenso API.
Get the agent work settings
/v1/agent-work-settingsagent-work-settings.getNeeds the agent_work feature on your workspace. Until it is on, calls answer 404.
Returns every kind with its executor, always all seven in hand-out order. A kind the workspace never saved is kenso_ai with updatedAt null. available is false for a kind Kenso cannot hand to an agent yet: it stays on kenso_ai.
Errors:
- 404 not_found: the workspace does not have the agent_work feature.
Open to any workspace member except a Client seat.
Parameters
YYYY-MM-DD form. 1.1 is another name for the first dated version. Leave it out to use your API key's pinned version. Keys created in the Kenso app are pinned to the newest version; keys minted by the CLI login are not. A key with no pinned version and no header gets the legacy shape where the path has one, and 404 where the path exists only in this version. A date that is not a version answers 400 unsupported_version; any other value that is not a version is treated as legacy.400 workspace_required. A workspace you are not a member of answers 404 not_found.Response 200
data is a AgentWorkSettings.
curl -X GET "https://api.ken.so/v1/agent-work-settings" \ -H "Authorization: Bearer $KEN_API_KEY" \ -H "Ken-Version: 1.1" \ -H "X-Ken-Workspace-Id: $KEN_WORKSPACE_ID"
{
"success": true,
"data": {
"settings": [
{
"kind": "string",
"executor": "string",
"updatedAt": "2026-09-23T15:02:11Z",
"available": true
}
]
}
}Update the agent work settings
/v1/agent-work-settingsagent-work-settings.updateNeeds the agent_work feature on your workspace. Until it is on, calls answer 404.
Sets the executor of each kind you name and leaves the others as they are. Body: { "settings": [ { "kind": "personalization", "executor": "my_agent" } ] }. Returns every kind after the change, in the same shape as the GET. With my_agent, the kind's work waits for the workspace's agent: Kenso's AI does not run it, and the full prompt and the lead's facts go to that agent.
Errors:
- 400 validation_failed: settings is missing or empty, a kind or executor is not a known value, or a kind is named twice. Each problem is one details[] entry, such as settings[1].kind. Nothing is saved. A kind set to my_agent while its available is false is a detail with code kind_not_available. - 404 not_found: the workspace does not have the agent_work feature.
Requires the workspace_settings permission.
Parameters
YYYY-MM-DD form. 1.1 is another name for the first dated version. Leave it out to use your API key's pinned version. Keys created in the Kenso app are pinned to the newest version; keys minted by the CLI login are not. A key with no pinned version and no header gets the legacy shape where the path has one, and 404 where the path exists only in this version. A date that is not a version answers 400 unsupported_version; any other value that is not a version is treated as legacy.400 workspace_required. A workspace you are not a member of answers 404 not_found.Request body
application/json, optional.
Response 200
data is a AgentWorkSettings.
curl -X PATCH "https://api.ken.so/v1/agent-work-settings" \
-H "Authorization: Bearer $KEN_API_KEY" \
-H "Ken-Version: 1.1" \
-H "X-Ken-Workspace-Id: $KEN_WORKSPACE_ID" \
-H "Content-Type: application/json" \
-d '{
"settings": [
{
"kind": "string",
"executor": "string"
}
]
}'{
"success": true,
"data": {
"settings": [
{
"kind": "string",
"executor": "string",
"updatedAt": "2026-09-23T15:02:11Z",
"available": true
}
]
}
}