---
title: "Revoke agent task"
method: POST
path: "/agents/tasks/{agent_task_id}/revoke"
tags: ["Agent Tasks"]
---

# Revoke agent task

`POST /agents/tasks/{agent_task_id}/revoke`

Revokes a pending agent task.

## Path parameters

- `agent_task_id` string, required

## Response `200`

Success

- AgentTask
  - `object` 'agent_task', required
  - `agent_id` string, required — A stable identifier for the agent, unique per agent_name within an instance.
  - `agent_task_id` string, required — A unique identifier for this agent task.
  - `task_id` string, required — A unique identifier for this agent task. Deprecated: use agent_task_id instead.
  - `url` string — The URL that, when visited, creates a session for the user. Only present in the response to a create request.

## Other responses

- `400` — Request was not successful
- `404` — Resource not found

---

[API](https://skmtc.net/clerk/apis/clerk-backend-api.md) · [All operations](https://skmtc.net/clerk/apis/clerk-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clerk/clerk-backend-api/revisions/75df3a43fcb2/schema)