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.