PUT/api/v1/workspaces/{workspace_id}/favorites

Star or unstar

kind is doc (a page, document or file; ref is its slug), team or project (ref is its id). on: false removes it. Returns the updated list. Up to 50 per workspace.

API token required120 per minute per IPMCP: set_favorite
Code samples and Try it

Path parameters

#
  • workspace_idstringRequired

    The workspace's id, from the address of its settings page (markdrop.in/settings/workspaces/<workspace-id>) or from List workspaces.

Request body

#

application/json, required

  • kind"doc" | "project" | "team"Required
  • refstringRequired

    1–80 characters.

  • onboolean

    Default true.

Responses

#
  • 200OK.
  • 401No token, or the token is revoked or mistyped.
  • 422The request didn't validate. detail lists each problem, with where it is (loc) and why (msg).
  • 429Too many requests from your IP address. Wait the seconds in Retry-After.
Did this page help?