Lexicon Garden

org.designtxt.resolveTokens

Resolve a resolver document by providing concrete context values for each of its modifiers. Returns a flat token set with all aliases resolved. Authentication is optional; the resolver document must be publicly accessible if used without auth.

Repository @bomberstudios.com did:plc:34yvx4hv64znmh2i2fezoyqx namespace authority
Details · procedure
Kindprocedure
Authoritydesigntxt.org
Indexed
Compare Edit in builder → Fork →

Procedure

procedure · POST

Input

application/json

input

requiredobject

Contextual input values, keyed by modifier name. Each value must be a string matching one of that modifier's defined contexts. E.g. { "theme": "dark", "size": "compact" }.

resolveReferences

boolean

If true (default), resolve all alias references ({token.name}) in the output. Set to false to preserve aliases as literal strings.

resolverRef

requiredstring · at-uri

AT-URI of the org.designtxt.resolver record to resolve.

  • maxLength: 8192

Output

application/json

input

object

Echo of the input values used for resolution.

resolvedAt

string · datetime

Timestamp when resolution was performed.

  • maxLength: 64

tokens

requiredunknown

The resolved token collection. All modifier conditions have been applied according to resolutionOrder, and alias references have been resolved.

Errors

ResolverNotFound

The specified resolver document could not be found.

InvalidInput

The input values do not match the resolver's modifier definitions (unknown modifier, invalid context value, or missing required modifier without a default).

CircularReference

The resolver or referenced token sources contain a circular reference.

ResolutionFailed

Token resolution failed due to unresolvable alias references, invalid token values, or other processing errors.

Similar lexicons

semantic match

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

  • org.designtxt.getTokens

    query

    XRPC Query to retrieve a design token collection, optionally at a specific subtree path, and optionally with alias references resolved. Implemented at https://xrpc.designtxt.org/xrpc/org.designtxt.getTokens

  • org.designtxt.resolver

    record

    A resolver document for multi-context design tokens (theming, breakpoints, accessibility modes). Follows the DTCG Resolver 2025.10 specification. Describes how token sets and contextual modifiers combine to produce resolved token values for a given input.