API reference

Motir API · version 1.23.0

POST/api/v1/dispatch-runs

Open a dispatch run, with the SET of cards it owns

POST/api/v1/dispatch-runs/{id}/close

Close a dispatch run with its stop reason

POST/api/v1/dispatch-runs/{id}/events

Append a batch of events to a dispatch run

GET/api/v1/me

Who this token is

GET/api/v1/plans/{planId}

Read a plan with the proposals it bundles

GET/api/v1/plans/{planId}/status

Read what became of a submitted planning job

GET/api/v1/projects

List the projects in this token’s workspace

GET/api/v1/projects/{projectKey}

Read a project

GET/api/v1/projects/{projectKey}/backlog

Read a project’s backlog

POST/api/v1/projects/{projectKey}/backlog/work-items

Move work items out of their sprint and back to the backlog

POST/api/v1/projects/{projectKey}/plan-session

Open or resume the planning conversation for a scope

POST/api/v1/projects/{projectKey}/plan-session/submissions

Send the thread’s accumulated intent to the planner

POST/api/v1/projects/{projectKey}/plan-session/turns

Add one turn to the planning conversation

GET/api/v1/projects/{projectKey}/ready

Read a project’s READY set

GET/api/v1/projects/{projectKey}/repositories

List a project’s repositories

GET/api/v1/projects/{projectKey}/sprints

List a project’s sprints

POST/api/v1/projects/{projectKey}/sprints

Create a planned sprint

GET/api/v1/projects/{projectKey}/work-items

List a project’s work items

POST/api/v1/projects/{projectKey}/work-items

Create a work item

GET/api/v1/projects/{projectKey}/work-items/count

Count a project’s work items

POST/api/v1/scope-claims

Atomically claim a whole story or sprint, all or nothing

POST/api/v1/sessions/complete

Close out a merged session branch

GET/api/v1/sprints/{sprintId}

Read a sprint

PATCH/api/v1/sprints/{sprintId}

Update a sprint

POST/api/v1/sprints/{sprintId}/complete

Complete a sprint

POST/api/v1/sprints/{sprintId}/start

Start a sprint

GET/api/v1/sprints/{sprintId}/work-items

List a sprint’s members

POST/api/v1/sprints/{sprintId}/work-items

Move work items into a sprint

GET/api/v1/work-items/{key}

Read a work item

PATCH/api/v1/work-items/{key}

Update a work item

GET/api/v1/work-items/{key}/activity

Read a work item’s activity — changes, comments, or both

POST/api/v1/work-items/{key}/archive

Archive a work item

POST/api/v1/work-items/{key}/attachments

Attach a file to a work item

POST/api/v1/work-items/{key}/claim

Atomically claim one work item by key

GET/api/v1/work-items/{key}/comments

List a work item’s comments

POST/api/v1/work-items/{key}/comments

Comment on a work item

GET/api/v1/work-items/{key}/dispatch-prompt

Read the canonical coding-agent prompt for a work item

POST/api/v1/work-items/{key}/expansions

Submit an AI expansion of a container work item

POST/api/v1/work-items/{key}/implementation

Record what BUILT a work item

POST/api/v1/work-items/{key}/integration

Record a work item as integrated on a session branch

DELETE/api/v1/work-items/{key}/links

Remove a relationship edge

GET/api/v1/work-items/{key}/links

Read a work item’s relationship edges

POST/api/v1/work-items/{key}/links

Create a relationship edge

POST/api/v1/work-items/{key}/plan-approval

Approve the plan this work item produced

POST/api/v1/work-items/{key}/restore

Restore an archived work item

GET/api/v1/work-items/{key}/transitions

List the statuses a work item can move to

POST/api/v1/work-items/{key}/transitions

Move a work item to a new status

GET/api/v1/workspaces

List the workspaces this token’s owner belongs to