# Tasks

The Tasks endpoints allow you to interact with actionable items within Cakewalk—typically approval or decision steps triggered by workflows like access requests, offboarding, or reviews. These endpoints enable programmatic management of workflow tasks assigned to users or approvers.

These endpoints are useful for:

* Retrieving task details for UI or system integration
* Approving or declining access requests via automation
* Embedding Cakewalk task handling into external tools or workflows

***

### 📘 Tasks Endpoints

<table><thead><tr><th width="256.40234375">Endpoint</th><th width="131.60546875">Method</th><th width="103.68359375">Version<select><option value="ZFsibY8Fd7Yn" label="v1" color="blue"></option></select></th><th>Description</th></tr></thead><tbody><tr><td><a href="/pages/LcIcfLONBBKW95hkKgZr">GET /Tasks?userId={userId}</a></td><td>GET</td><td><span data-option="ZFsibY8Fd7Yn">v1</span></td><td>Returns a paginated list of tasks for a user, optionally filtered by task status</td></tr><tr><td><a href="/pages/9sT4yItawD6KwO0uWkM3">/{version}/Tasks/{taskId}</a></td><td>GET</td><td><span data-option="ZFsibY8Fd7Yn">v1</span></td><td>Retrieves detailed information about a specific task, including status, type, target, and metadata.</td></tr><tr><td><a href="/pages/ernPZ363R5hyPMhQgO4e">/{version}/Tasks/{taskId}/Approve</a></td><td>POST</td><td><span data-option="ZFsibY8Fd7Yn">v1</span></td><td>Approves the specified task. Typically used for access requests or entitlement reviews.</td></tr><tr><td><a href="/pages/Po7JXoBtePGdeMxH3e7z">/{version}/Tasks/{taskId}/Decline</a></td><td>POST</td><td><span data-option="ZFsibY8Fd7Yn">v1</span></td><td>Declines the specified task. Optionally supports sending a reason for rejection.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.getcakewalk.io/open-api-and-mcp/api-reference/tasks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.