GET/api/v1/categories
List the org's asset categories
The org's category taxonomy for assets — categories whose group is for assets or for every kind of thing — each with its group, by group (as the app orders them) then name. Returned whole, at most 1000. Use an id with GET /assets?category_id=. Read only: the taxonomy is managed in the app. For an OAuth token, empty unless its person is a member of the org. 404 when the org does not have categories.
Scopes: taxonomy:read
Response 200CategoryList
dataarray of CategoryrequiredBy group (its order in the app, then name), then name. Returned whole, at most 1000.
groupobjectrequiredThe category group (a facet: Genre, Territory…).
idstring (uuid)requirednamestringrequired
idstring (uuid)requirednamestringrequireddescriptionstring or nullrequiredparent_idstring (uuid) or nullrequiredThe category this one sits under (one level deep at most), or null.
is_systembooleanrequiredA category the platform seeded; it cannot be deleted in the app.
next_cursorstring or nullrequiredAlways null: the list is returned whole.
Other responses
- 401 unauthenticated — no key, or an unknown, revoked or expired one.
- 403 insufficient-scope — the key lacks a required scope.
- 404 not-found.
- 429 rate-limited — the key's request budget is spent; wait Retry-After seconds.
- 500 internal.