Work Items and OKRs

Bulk-create work items (workspace / portfolio / OKR) in one call. Accepts an array of the same payload as POST /item plus a shared options envelope. Partial-success: each item is validated/resolved and written independently; failures are isolated and reported per item (keyed by request index) so the caller can retry only the failures. Max 100 items.

Request

  • Base URL
    https://api.craft.io
  • URL
    https://api.craft.io/items
  • Auth
    API key in header x-api-key

Request body

Example request

{
  "items": [
    {
      "assignee": {
        "team": "Team A",
        "user": "a@b.com"
      }
    }
  ]
}

Response

Per-item results

Changes

    • info

      added the optional property to the response with the status

    • breaking

      added to the // request property allOf list

    • warning

      removed from the // request property allOf list