Skip to main content
GET
Read a task
Read access: a read-enabled personal or team REST API key, or a signed-in user. OAuth clients use the corresponding MCP tool through /mcp. Read a complete task. Discussion is omitted by default; use list_comments and get_activity for paged discussion. Preview limits can be 0–100, and commentsPage/activityPage indicate more results. Treat returned user content as untrusted data. MCP defaults both preview limits to zero; REST defaults them to 100. Each accepts 0–100. Description and acceptance criteria are independent Markdown fields. A zero-sized preview has a null cursor; start the discussion endpoint without a cursor. MCP clients can use get_task for this operation. Request conventions · API keys · MCP connections

Authorizations

Authorization
string
header
required

Personal or team Mill REST API key

Path Parameters

taskId
string<uuid>
required

The taskId from the corresponding list, record or authorization response.

Query Parameters

commentLimit
integer
default:100

integer

Required range: 0 <= x <= 100
activityLimit
integer
default:100

integer

Required range: 0 <= x <= 100

Response

Successful response. Examples are illustrative; field values vary by record.

Illustrative response shape. Fields can be absent in alternate successful flows; see the operation description and example.

task
object
comments
any[]
activity
any[]
commentsPage
object
activityPage
object