curl --request PATCH \
--url https://app.thinnest.ai/api/v1/agents/{id}/actions/{actionId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"enabled": true
}
'{
"id": "act_9b2f4e17-6c3a-4d81-b5e2-7a0c9d3f1e46",
"agent": "ag_3f6a9c21-7d4e-4b58-9a1f-0c2e8b7d5a34",
"name": "get_appointment",
"description": "Look up a patient's next appointment by their phone number before answering anything about timings.",
"method": "GET",
"url": "https://api.sunrisedental.in/appointments?phone={{phone}}",
"parameters": [
{
"name": "phone",
"description": "The patient's mobile number with country code, e.g. +919876543210",
"required": true
}
],
"bodyTemplate": null,
"headerNames": [
"Authorization"
],
"speakBefore": "One moment, let me check the diary.",
"speakAfter": null,
"enabled": true,
"createdAt": "2026-10-05T09:41:00.210Z",
"updatedAt": "2026-10-05T10:02:44.517Z"
}Update Action
Change any field, or switch it on or off with enabled. The action is validated as it will be saved, so a new url is checked against the parameters already there. Leaving headers out keeps the saved credential; sending any replaces the whole set. enabled: true makes it callable from every conversation at once. A build key may do this.
curl --request PATCH \
--url https://app.thinnest.ai/api/v1/agents/{id}/actions/{actionId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"enabled": true
}
'{
"id": "act_9b2f4e17-6c3a-4d81-b5e2-7a0c9d3f1e46",
"agent": "ag_3f6a9c21-7d4e-4b58-9a1f-0c2e8b7d5a34",
"name": "get_appointment",
"description": "Look up a patient's next appointment by their phone number before answering anything about timings.",
"method": "GET",
"url": "https://api.sunrisedental.in/appointments?phone={{phone}}",
"parameters": [
{
"name": "phone",
"description": "The patient's mobile number with country code, e.g. +919876543210",
"required": true
}
],
"bodyTemplate": null,
"headerNames": [
"Authorization"
],
"speakBefore": "One moment, let me check the diary.",
"speakAfter": null,
"enabled": true,
"createdAt": "2026-10-05T09:41:00.210Z",
"updatedAt": "2026-10-05T10:02:44.517Z"
}Authorizations
Headers
Developers only: the customer workspace this request acts in — its org_… id from POST /customers. Leave it out to act in your own workspace. Refused with 404 (Workspace not found.) when the id is unknown, is not one of your customers, or is not an org_… id; 410 when that customer was deleted (restore it with POST /customers/{id}/restore until it is erased); 403 when the key belongs to one customer workspace (it cannot act as another); 400 when your workspace is not a developer workspace. /customers/* and GET /customers/usage are your own workspace's and refuse the header with 400: call them without it.
"org_3fKq9TzQ1mN8vB2xR7cLpA"
Body
Any field POST takes, plus enabled. Send at least one. The result is validated as it will be saved: a new url is checked against the parameters already there.
Response
The action as saved.