For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to page URLs.
Skip to content

Write Operations

Categories can be created and updated in bulk.

  • Create categories adds new categories.

  • Update categories changes existing ones, matched by ID.

  • Upsert categories does both in one call.

Every write endpoint answers with the same shape. errors is keyed by the position of the entry in your request, starting at 1.

{
  "success": false,
  "processed": 1,
  "categories": [
    { "id": "7c2a91bb-...", "title": "Food Programs" }
  ],
  "errors": {
    "2": {
      "site_links": ["Site 9f1c... does not belong to this organization."]
    }
  }
}

By default, nothing is written unless every entry is valid, and the response is 400. Set allow_partial to true to write the valid entries and have the rest reported back.

A request may carry at most 500 categories.