Preset categories

List preset categories

GET
/preset/categories

Authorization

token_auth
AuthorizationBearer <token>

Token-based authentication using access tokens.

In: header

Query Parameters

search?|

Filter categories by name (case-insensitive substring match).

Defaultnull
type?|

Filter categories by preset type. Only returns categories that contain at least one preset of the given type.

Defaultnull
sort_by?Sort By

Sort by field: 'name' or 'created_at'.

Default"created_at"
Value in"name" | "created_at"
order?Order

Sort order: 'asc' or 'desc'.

Default"desc"
Value in"asc" | "desc"
ownership?|

Filter by ownership: 'mine' (own), 'shared' (via groups), 'default' (system).

Defaultnull

Response Body

application/json

application/json

curl -X GET "https://v2.api.piktid.com/preset/categories"
{
  "categories": [
    {
      "id": "string",
      "name": "string",
      "description": "string",
      "thumbnail_url": "string",
      "visibility": "shared",
      "created_by": "string",
      "created_at": "string",
      "preset_count": 0,
      "groups": [
        "string"
      ]
    }
  ]
}
{
  "error": "Invalid request",
  "detail": [
    {
      "field": null,
      "message": "string",
      "position": "query"
    }
  ]
}
Empty