Sign in

v1

latestOpenAPI 3.1.02026-07-22106199311.5 KB
AI Agent Tasks

Set Task Permissions

Replaces the full set of granted tool permissions for a task. Pass an empty list to clear all permissions.

put/v1/ai/agents/tasks/{taskId}/permissions

Path parameters

taskIdstring uuid required

Request body

Example request

{
  "grantedPermissions": [
    {
      "toolName": "execute_sql"
    }
  ]
}

Response

Permissions updated successfully

taskIdstring uuid

The unique identifier of the task

Example response

{
  "grantedPermissions": [
    {
      "toolName": "execute_sql"
    }
  ],
  "taskId": "550e8400-e29b-41d4-a716-446655440000"
}