Create Cards
createCardsBulk-create up to 40 cards on a single AgilePlace board. Use for new cards only, not updates. Returns created[] with clientKey and real id for connections, and failed[] with reasons for partial-failure retries.
Instructions
Bulk-creates cards on one board. Use for new cards, not updates. Returns created[] with clientKey + the real id for a later connect pass; failed[] carries clientKey + title + reason. Pass type as a label ("Epic"); the tool resolves it. header is cosmetic and is not used to connect cards. One board per call. Max 40 cards per call — chunk larger sets and concatenate created[] before connecting. Partial success is normal: isError: false with some cards in failed[]. Cards in created[] already exist — NEVER resubmit those clientKeys. To complete a partial batch, resubmit only the failed[] (and any never-sent) cards. This applies to every partial result, not just retryAfter rate-limit cases. If retryAfter is set, wait that many seconds, then resubmit only the never-sent cards (not created[]). Never invent board, type, or lane ids. Attach to an existing parent with parentCards; otherwise create all cards first, then connect using the returned ids.
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": {
"boardId": "<boardId>",
"cards": "<cards>"
},
"name": "createCards"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cards | Yes | Cards to create. Max 40 per call; chunk larger sets. | |
| boardId | Yes | Target board title or id. One board per call. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| failed | Yes | ||
| created | Yes | ||
| summary | Yes | ||
| retryAfter | No |