Endpoint reference

Return the current identity: user ID, name, email, role and token abilities.

List your tokens.

Token values are truncated to their first eight characters; the full value is shown only once, at creation.

Create a token.

Body: name, optional abilities, optional expires_at. The full token value is returned exactly once.

Revoke a token.

List the projects accessible to the caller.

Create a project.

Automatically enrolls the caller as owner and provisions the four default lanes.

Fetch a project by slug or numeric ID.

Update a project's name, description and repository.

Archive a project (soft delete).

Return the full Kanban board, grouped by lane.

Toggle the project as a favorite for the calling user.

Return the project activity log.

List a project's lanes in display order.

Create a lane.

Body: name, color, status type.

Update a lane's name, color, status type or visibility.

Delete a lane.

Returns 409 if the lane still contains stories.

Reorder lanes by passing an array of lane IDs.

List stories across accessible projects.

Filter by project, project_id, status, priority, assigned_to, type, search. Paginate with limit (max 500) and offset.

Deep search across titles, descriptions, comments, attachment filenames and task text.

Filter by project, status, priority, type and assignee. Paginate with page and per_page.

Create a story.

Requires project or project_id plus title. Accepts description, type, status, priority, story points, due date, assignee, epic ID and epic flag.

Fetch one story with its comments and comment count.

Update any field of a story.

Computes a field-level change set, writes it to the activity log, auto-syncs the lane on status change, and fires assignment and update notifications.

Delete a story.

Move a story to a different status or position.

Move a story to a different project.

When the subject is an epic, all child stories move with it.

Assign or unassign a story inline.

Create many stories in one call.

Returns per-item results plus a created/failed summary. Responds 207 Multi-Status when some items succeeded and others failed.

Move many stories to one status in a single call.

Each move is logged individually.

List a project's epics.

Create an epic in a project.

Fetch an epic with its child stories.

Attach stories to an epic.

Detach a story from an epic.

Return what a story depends on and what it blocks.

Add a dependency.

Rejected if it would create a cycle.

Replace a story's whole dependency set.

Remove one dependency.

List the tasks on a story's checklist.

Add a task to a story.

Update a task.

Mark a task complete.

Reopen a completed task.

Delete a task.

List a story's comments with reactions inline and an unread count in meta.

Optional flat=true, unread_only=true, include_attachments=true.

Post a comment on a story.

Supports an urgent flag. Parses mentions, auto-marks read, auto-subscribes the author and notifies watchers.

Edit a comment.

Stamps an edit time.

Soft-delete a comment, preserving the thread.

Admins may pass ?soft=false to hard-delete the comment, its descendants and their attachments.

Post a threaded reply to a comment.

Mark one comment read.

Mark every comment on a story read.

Add an emoji reaction to a comment.

One of 👍 👎 ❤️ 😂 🎉 🚀 👀.

Remove your reaction from a comment.

List recent comments across all stories.

Full-text search of comments in natural-language mode with relevance ranking, highlighted snippets and rendered HTML.

Filter by project, user, story and date range.

Upload a file to a comment.

Maximum of 5 attachments per comment at this endpoint.

List a comment's attachments with same-domain download URLs.

Delete a comment attachment.

Permitted to the uploader, the comment author or an admin.

List your mentions.

Mark one mention read.

Mark one mention read.

Alias of /api/v1/mentions/{id}/mark_read.

Mark all your mentions read.

Watch a story so you are notified of comments and changes.

Stop watching a story.

List the users watching a story.

Upload a file to a story as multipart/form-data.

Fully validated by the attachment pipeline (file type, size and content checks).

List a story's attachments.

Download an attachment scoped to its story.

Verifies the attachment actually belongs to that story.

Return attachment metadata.

Stream the file through the application domain.

Delete an attachment.

List users.

Return one user.

Return a leaderboard of the most active users.

Per user over the last seven days: stories assigned, stories in progress, stories completed, comments posted, last-activity timestamp and composite activity score.

Return the highest-priority unassigned backlog stories — the "give me something to work on" call.

Ordered Critical → High → Medium → Low, then oldest first. Optionally scoped to one project. Default 5, max 20.

Return overdue stories within the caller's accessible projects.

Return stories due within the next N days.

Default 7 days, max 30.

Return work assigned to the caller, ordered by priority then due date.

Excludes completed items unless a status is specified.

Quick story search.

Minimum two characters.

Return recent activity across all projects with JSON detail payloads decoded.

Up to 200 entries.

Log an agent run.

Requires agent and activity; status must be success, warning or error; optional story_ids array and duration_seconds. Returns the stored entry with 201.

Return a paginated, filtered feed of runs.

Filter by agent, status, date range and free text.