---
title: "Read a team's saved design-system values"
method: GET
path: "/v1/teams/{teamId}/design-system"
tags: ["Teams"]
---

# Read a team's saved design-system values

`GET /v1/teams/{teamId}/design-system`

## Request

- Base URL: `https://api.spacefast.com`
- URL: `https://api.spacefast.com/v1/teams/{teamId}/design-system`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://api.spacefast.com/v1/auth/oauth2/authorize`, token URL `https://api.spacefast.com/v1/auth/oauth2/token`; client credentials, token URL `https://api.spacefast.com/v1/auth/oauth2/token`, scopes: `spaces:read`)

Returns active colors, typography, layout, voice/rules, and Media Library assets with stable entry IDs. Use the numeric revision as expectedRevision when saving or undoing; actionId identifies the last undoable action. An absent system has document null and revision 0. Uploads, undo history, archived values, and retry receipts are excluded. Missing attachments retain their entry IDs and guidance with available false and url null, so they can be replaced or removed. The design system is team-wide. For compiled Markdown and unchanged-context detection, use getTeamAgentContext; its designSystem.revision is a separate context fingerprint.

## Path parameters

- `teamId` string, required

## Response `200`

Response for status 200

- object
  - `$schema` string, uri: Canonical JSON Schema URL for this response body. The server also sends it in the `Link: rel="describedby"` response header.
  - `data` object, required
    - `revision` integer, required
    - `actionId` string, uuid, nullable, required
    - `document` object, nullable, required
      - `colors` object[], required
        - `name` string, required
        - `hex` unknown, required
        - `usage` string, nullable
        - `id` string, uuid, required
      - `typography` object, required
        - `headings` object, nullable: Shared heading font; fontSizePx and lineHeightPx define Heading 1, with separate h2 and h3 sizes.
          - `fontSizePx` number, required
          - `lineHeightPx` number, required
          - `fontFamily` string, required
          - `h2` object, nullable
            - `fontSizePx` number, required
            - `lineHeightPx` number, required
          - `h3` object, nullable
            - `fontSizePx` number, required
            - `lineHeightPx` number, required
        - `body` object, nullable
          - `fontSizePx` number, required
          - `lineHeightPx` number, required
          - `fontFamily` string, required
        - `headingCase` 'sentence' | 'title' | 'uppercase' | 'lowercase' | 'unchanged', nullable
      - `layout` object, required
        - `pageWidthPx` number, nullable
        - `cornerRadiusPx` number, nullable
        - `sectionSpacingPx` number, nullable
      - `voice` object, required
        - `tone` string, nullable, required
        - `rules` object[], required
          - `text` string, required
          - `example` string, nullable
          - `id` string, uuid, required
      - `assets` object[], required
        - `attachmentId` integer, required
        - `category` 'logo' | 'imagery' | 'icon' | 'photo' | 'reference', nullable
        - `usage` string, nullable
        - `altText` string, nullable
        - `available` boolean, required: False when the Media Library attachment is missing or unavailable.
        - `url` string, uri, nullable, required: Authenticated download URL, or null when unavailable.
        - `id` string, uuid, required
    - `updatedAt` string, date-time, nullable, required
    - `teamId` string, required

## Other responses

- `default`: Problem details (RFC 9457). Any 4xx/5xx response is one `application/problem+json` document.

---

[API](https://skmtc.dev/spacefast/apis/spacefast-api.md) · [All operations](https://skmtc.dev/spacefast/apis/spacefast-api/llms.txt) · [OpenAPI document](https://skmtc.dev/spacefast/apis/spacefast-api/revisions/bd165bc7c983?raw)