create_epic
Create an epic. progressStatus defaults to 'idea'; planStatus defaults to 'later'. deployed/done are not allowed on create — 'deployed' is not available to agents; the human sets it in the web UI. If the user is working inside a VSCode workspace and a <workspace>/.bilg/bilg.config.json exists, prefer that file's projectName over the API key's default project. If .bilg/bilg.config.json has a "surface" and the new item concerns only that part, set surfaces to it. Create the epic before starting non-trivial work. Put the summary here; put detail in a document and link it with documentId.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"title": "<title>"
},
"name": "create_epic"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| owner | No | "me", a person's name, the email shown for members without a name, or id, or null. Defaults to unassigned (falls back to the project owner in solo projects). | |
| title | Yes | ||
| active | No | ||
| labels | No | Free-form tags, e.g. ['ui', 'auth']. Replaces the full set. | |
| surfaces | No | Surface names or ids this epic touches. Replaces the full set; [] = project-wide. | |
| documentId | No | Link a detail/spec document. Pass null to unlink. | |
| planStatus | No | ||
| description | No | Markdown description | |
| projectName | No | ||
| progressStatus | No |