Sign in
Lists

Get a single list

Changed on

Retrieve a single list by its ID.

get/lists/{listId}

Request

  • Base URL: https://try.karakeep.app/api/v1
  • URL: https://try.karakeep.app/api/v1/lists/{listId}
  • Auth: HTTP bearer

Path parameters

listIdstring required

The unique identifier of the list.

Example:ieidlxygmwj87oxz5hxttoc8

Response

The requested list.

idstring required
namestring required
descriptionstring nullable
iconstring required
parentIdstring nullable required
type'manual' | 'smart'
querystring nullable
publicboolean required
hasCollaboratorsboolean required
userRole'owner' | 'editor' | 'viewer' | 'public' required

Changes

  • 6210da080616Revision changes
    • info

      api operation id getList was added

    • info

      added the non-success response with the status

  • dc0636c164c7Revision changes
    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status