---
title: "Read the design system an artifact holds [read]"
method: GET
path: "/artifacts/{id}/design-system"
tags: ["artifacts"]
---

# Read the design system an artifact holds \[read\]

`GET /artifacts/{id}/design-system`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/artifacts/{id}/design-system`
- Auth: HTTP bearer

404 when the artifact is not a design system.

## Path parameters

- `id` string, required

## Response `200`

OK

- object
  - `design_system` DesignSystem, required: A design system as its files say: the index, the brand book, tokens with the stylesheet compiled from them, components and asset groups. Paths are relative to `root`.
    - `artifact_id` string, required
    - `name` string, required
    - `version` integer, required
    - `root` string, required: The folder that holds project/: empty or ending in /
    - `title` string, required
    - `namespace` string, nullable
    - `libraries` object[]
      - `name` string
      - `version` string
    - `last_change` object, nullable
      - `by` string
      - `at` string
      - `via` string
      - `note` string
    - `editable` boolean, required
    - `editable_files` string[], required: The text files saved through PUT /artifacts/{id}/design-system/files/{path}, project/README.md first; empty when the system is read-only
    - `readme` string, nullable, required: project/README.md, the brand book: read it first
    - `sections` object[], required
      - `path` string
      - `title` string
      - `markdown` string
    - `tokens` object, nullable, required: tokens.json as read, with `dropped` naming every value that could not be read and why
    - `tokens_css` string, required: tokens.css compiled from tokens.json, without @font-face
    - `fonts` object[], required
      - `family` string
      - `path` string
      - `weight` string
      - `style` string
    - `cover` boolean, required
    - `components` object[], required
      - `name` string
      - `group` string, nullable
      - `height` integer
      - `width` integer, nullable
      - `subtitle` string, nullable
      - `readme` string, nullable
      - `has_preview` boolean
    - `assets` object[], required
    - `files` string[], required

## Other responses

- `default`: Error — { error: { code, message } }

## Changes

- **2026-11-02** `e5e8f0229a99`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/artifacts/:id/design-system/get.md)

---

[API](https://skmtc.dev/agentsky/apis/agentsky-developer-api.md) - [All operations](https://skmtc.dev/agentsky/apis/agentsky-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentsky/apis/agentsky-developer-api/revisions/8280a065ef6a?raw)