Planning

Add an epic

Create an epic: a larger piece of work (a feature, a migration) whose cards can sit in any swimlane. Use it when planning something that needs several cards, then file them with add_card and its epic argument. Check get_board first so you don't duplicate an existing epic.

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

post/projects/{project}/epics

Request

  • Base URL: https://api.yokka.ai/api/v1
  • URL: https://api.yokka.ai/api/v1/projects/{project}/epics
  • Auth: HTTP bearer

Path parameters

projectstring required

Project slug, name or card prefix, like "getting-started" or "GS".

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.

Idempotency-Keystring

Makes a retry safe: the same key and request within 24 hours answers the first result again instead of creating a second one.

Request body

namestring required

Short name, like "Checkout v2".

briefstring

Optional markdown: the goal and what done means.

Response

Created. The tool's result.

epicstring required

Changes

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