org.designtxt.getTokens

Retrieve design tokens from a tokenCollection record. If no input modifiers are provided, returns the raw token document. If an input object is given (matching a resolver document's modifiers), tokens are resolved against that context.

Details · query
Kindquery
Authoritydesigntxt.org
Indexed

Query

query · GET

Parameters

query string

path

string

JSON Pointer path to a specific subtree within the token collection. When set, only the sub-tree at this path is returned.

  • maxLength: 1024

ref

requiredstring · at-uri

AT-URI of the org.designtxt.tokenCollection record to retrieve.

  • maxLength: 8192

If true, resolve alias references ({token.name}) inline in the response. Defaults to false.

Output

application/json

resolvedAt

string · datetime

Timestamp when the response was produced.

  • maxLength: 64

tokens

requiredunknown

The requested token data. Either the full token collection, the subtree at the requested path, or the resolved token values.

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • XRPC Procedure to resolve a design token resolver document against a set of contextual inputs, producing a fully resolved token collection. Implemented at https://xrpc.designtxt.org/xrpc/org.designtxt.resolveTokens

  • A record containing a collection of design tokens in DTCG 2025.10 format. The record has typed metadata fields (name, description, createdAt) alongside the token tree. Token/group keys sit at the same level as metadata; atproto ignores unexpected fields, so the token tree passes through without schema-level validation.