Tags

Retrieve a paginated list of all tags. Supports filtering by name, attached-by source, and sorting by name, usage count, or relevance.

get/tags

Request

  • Base URL: https://try.karakeep.app/api/v1
  • URL: https://try.karakeep.app/api/v1/tags
  • Auth: HTTP bearer

Query parameters

nameContainsstring
sort'name' | 'usage' | 'relevance'
attachedBy'ai' | 'human' | 'none'
cursorstring
limitinteger

Response

A paginated list of tags with usage counts.

nextCursorstring nullable required

Cursor for the next page, or null if no more results.

Changes

    • breaking

      for the query request parameter limit, the type changed from number to integer

    • warning

      for the query request parameter limit, the min was set to 1.00

    • info

      api operation id listTags was added

    • info

      added the non-success response with the status