`revoke()`

Warning

Agent Tasks are currently in beta. If you run into any issues, please reach out to our support team.

Revokes an existing AgentTask, preventing it from being used to create a session.

function revoke(agentTaskId: string): Promise<Omit<AgentTask, 'url'>>

Parameters

Note

Using clerkClient varies based on the SDK you're using. Refer to the overview for usage details, including guidance on how to access the userId and other properties.

await clerkClient.agentTasks.revoke('agttsk_123')

This method in the SDK is a wrapper around the BAPI endpoint POST/agents/tasks/{agent_task_id}/revoke. See the BAPI reference for more information.

Last updated on May 19, 2026