---
raw: true
search:
  tags:
    - Teams
    - GET
seo:
  description: >-
    Returns active colors, typography, layout, voice/rules, and Media… Reference
    for the GET /v1/teams/{teamId}/design-system endpoint in the Spacefast API.
sidebar:
  label: Read a team's saved design-system values
  badge: GET
title: Read a team's saved design-system values
type: openapi-operation
---
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.

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

**Responses**

- `200` — Response for status 200
- `default` — Problem details (RFC 9457). Any 4xx/5xx response is one \`application/problem+json\` document.

Response example, 200:

```json
{
  "$schema": "http://example.com",
  "data": {
    "revision": 0,
    "actionId": "4a2794ff-94cb-4bac-8d36-d5fb36c563a0",
    "document": {
      "colors": [
        {
          "name": "string",
          "hex": null,
          "usage": "string",
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
        }
      ],
      "typography": {
        "headings": {
          "fontSizePx": 0,
          "lineHeightPx": 0,
          "fontFamily": "string",
          "h2": {
            "fontSizePx": 0,
            "lineHeightPx": 0
          },
          "h3": {
            "fontSizePx": 0,
            "lineHeightPx": 0
          }
        },
        "body": {
          "fontSizePx": 0,
          "lineHeightPx": 0,
          "fontFamily": "string"
        },
        "headingCase": "sentence"
      },
      "layout": {
        "pageWidthPx": 0,
        "cornerRadiusPx": 0,
        "sectionSpacingPx": 0
      },
      "voice": {
        "tone": "string",
        "rules": [
          {
            "text": "string",
            "example": "string",
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
          }
        ]
      },
      "assets": [
        {
          "attachmentId": 1,
          "category": "logo",
          "usage": "string",
          "altText": "string",
          "available": true,
          "url": "http://example.com",
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
        }
      ]
    },
    "updatedAt": "2019-08-24T14:15:22Z",
    "teamId": "string"
  }
}
```