ProductOSDocs

Entity reference · v1

ds-tokens

TOKN-NNNNNNtable ds_tokenssoft delete

Design system tokens (color/spacing/typography/...).

Endpoints

GET/api/v1/ds-tokens
POST/api/v1/ds-tokens
GET/api/v1/ds-tokens/{id}
PATCH/api/v1/ds-tokens/{id}
DELETE/api/v1/ds-tokens/{id}
POST/api/v1/ds-tokens/{id}/restore

Writable fields

* required on create. PATCH treats every field as optional.

FieldTypeConstraintsNotes
name*string
categorystringcolor | spacing | typography | shadow | border-radius | breakpoint | other
value*string
descriptiontext
css_variablestring
sort_orderinteger
is_draftboolean
metadatajson

Listing & filtering

  • Pagination: ?limit=50&offset=0 · max limit 200
  • Default sort: ?sort=sort_order&order=asc
  • Sortable fields: created_at · updated_at · sort_order · name · id_number
  • Search (?q=): name, description, css_variable
  • Filters: ?category= , repeat any filter to OR multiple values
  • Trash: hidden by default; pass ?include_deleted=true

Examples

curlbash
curl 'https://productos.ca/api/v1/ds-tokens?limit=10' \
  -H "Authorization: Bearer $TOKEN"

Try it out

Paste a token and hit a real endpoint. The request goes from your browser straight to /api/v1/ds-tokens. The token is held in this page only for the request and is never stored.

Try it out

Issue tokens in Settings → API tokens. Token never leaves this page.

GET/api/v1/ds-tokens?limit=3

Generated from the API's entity configuration. This page is rebuilt on every deploy, so it always matches the live API.