---
title: "Delete Task by Name"
method: DELETE
path: "/tasks/name/{task_name}"
tags: ["Tasks"]
---

# Delete Task by Name

`DELETE /tasks/name/{task_name}`

Delete a task by its unique name.

## Path parameters

- `task_name` string, required

## Query parameters

- `agent_id` string, nullable — Optional agent filter. When provided, we authorize it via direct OpenFGA Check and avoid ListObjects(agent) to prevent false 403s from transient/partial list results.

## Response `200`

Successful Response

- DeleteResponse
  - `id` string, required
  - `message` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/terminaluse/apis/sb0-api.md) · [All operations](https://skmtc.net/terminaluse/apis/sb0-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/terminaluse/sb0-api/versions/f24a474dc415/schema)