Skip to navigation

List tasks

View as Markdown

List the organization’s tasks (open by default). Returns for each task: taskId, taskNumber, title, status, assignee, dueAt, notes, and source (agent | manual). Use this before update_task, which needs an exact taskId from this list.

Authentication

AuthorizationBearer

A Basement key (bsmt_...), from Agents, Connect in the app.

Request

This endpoint expects an object.
includeDonebooleanOptional

Include done/canceled tasks (default false)

limitdoubleOptional

Max tasks (default 50, maximum 200)

Response

The tool's answer.
taskIdstring
taskNumberinteger or null

The number people use for the task (#57)

titlestring
statusenum
Allowed values:
assigneestring or null
dueAtdouble or null

Due date (ms since epoch)

notesstring or null
sourceenum
Allowed values:

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
429
Too Many Requests Error
500
Internal Server Error