Card work

Report progress

Report progress on a card you hold, at real milestones only. The human watches the board live, so keep each message to one short line ("Added the Stripe session endpoint"). Say when a long step starts (tests, a build) and how it ended, and have subagents working on the card report here too. Never report work you haven't done.

Needs a read-and-write token. Same as the MCP tool report_progress.

post/cards/{card}/progress

Request

  • Base URL: https://api.yokka.ai/api/v1
  • URL: https://api.yokka.ai/api/v1/cards/{card}/progress
  • Auth: HTTP bearer

Path parameters

cardstring required

The card's ref, like "GS-12".

Headers

X-Client-Namestring

Your agent's name on the board (default "api"). Cards you claim stay yours across requests with the same token and name.

Request body

messagestring required

One line on what just happened.

percentnumber

Optional rough completion, 0–100 (rounded to a whole number). Leave it out on a card with a checklist: its bar follows the items.

stepstring

Optional short step name, like "Tests".

Response

The tool's result.

refstring required
percentinteger nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.