Autonomous reply settings
How Ken answers replies on its own.
Return autonomous reply settings for the current workspace
GET
/v1/autonomous-reply-settingsautonomous-reply-settings.getRequires ReadAccess.
Parameters
Name
In
Type
Required
Description
Ken-Version
In: header
string, one of: 2026-11-02, 1.1
required
The API version: a dated version (YYYY-MM-DD), or 1.1, another name for the first dated version. Without it the request uses your API key's pinned version; an unpinned key reaches the legacy shape of the same path. 1.0 selects the legacy shape explicitly.
X-Ken-Workspace-Id
In: header
integer (int64)
optional
Workspace to act in. Required when your credential can reach more than one workspace (otherwise
400 workspace_required).Response 200
data is a AutonomousReplySettingsModel.
Field
Type
Description
defaultEnabled
boolean
linkedInEnabled
boolean
mode
string
extraInstructions
string
createdAt
string (date-time)
updatedAt
string (date-time)
Request
curl -X GET "https://api.ken.so/v1/autonomous-reply-settings" \ -H "Authorization: Bearer $KEN_API_KEY" \ -H "Ken-Version: 2026-11-02" \ -H "X-Ken-Workspace-Id: $KEN_WORKSPACE_ID"
Response 200
{
"success": true,
"data": {
"defaultEnabled": true,
"linkedInEnabled": true,
"mode": "string",
"extraInstructions": "string",
"createdAt": "2026-09-23T15:02:11Z",
"updatedAt": "2026-09-23T15:02:11Z"
}
}Update autonomous reply settings
PATCH
/v1/autonomous-reply-settingsautonomous-reply-settings.updateAbsent fields stay unchanged. JSON null clears extraInstructions. mode is draft or autonomous, or approve_risky where the workspace has the reply_agent_approve_risky flag on; elsewhere approve_risky gets the same 400 validation_failed on mode as an unknown mode. A body without mode keeps the stored mode. Requires WriteAccess.
Parameters
Name
In
Type
Required
Description
Ken-Version
In: header
string, one of: 2026-11-02, 1.1
required
The API version: a dated version (YYYY-MM-DD), or 1.1, another name for the first dated version. Without it the request uses your API key's pinned version; an unpinned key reaches the legacy shape of the same path. 1.0 selects the legacy shape explicitly.
X-Ken-Workspace-Id
In: header
integer (int64)
optional
Workspace to act in. Required when your credential can reach more than one workspace (otherwise
400 workspace_required).Request body
application/json, optional: object.
Response 200
data is a AutonomousReplySettingsModel.
Field
Type
Description
defaultEnabled
boolean
linkedInEnabled
boolean
mode
string
extraInstructions
string
createdAt
string (date-time)
updatedAt
string (date-time)
Request
curl -X PATCH "https://api.ken.so/v1/autonomous-reply-settings" \
-H "Authorization: Bearer $KEN_API_KEY" \
-H "Ken-Version: 2026-11-02" \
-H "X-Ken-Workspace-Id: $KEN_WORKSPACE_ID" \
-H "Content-Type: application/json" \
-d '{}'Response 200
{
"success": true,
"data": {
"defaultEnabled": true,
"linkedInEnabled": true,
"mode": "string",
"extraInstructions": "string",
"createdAt": "2026-09-23T15:02:11Z",
"updatedAt": "2026-09-23T15:02:11Z"
}
}