> This page is for API Reference. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://contentful.com/developers/docs/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://contentful.com/developers/docs/_mcp/server. # List all design tokens GET https://api.contentful.com/spaces/{spaceId}/environments/{environmentId}/design_tokens Reference: https://contentful.com/developers/docs/references/experience-management-api/design-tokens/list-design-tokens ## Authentication - `Authorization` header (bearer token, required) — Contentful Management API token ## Request ### Path parameters - `spaceId` (string, required) - `environmentId` (string, required) ### Query parameters - `access_token` (string, optional) - `pageNext` (string, optional) - `pagePrev` (string, optional) - `limit` (double, optional) - `metadata.tags.sys.id[in]` (string, optional) - `metadata.tags.sys.id[all]` (string, optional) - `metadata.tags.sys.id[nin]` (string, optional) - `metadata.concepts.sys.id[in]` (string, optional) - `metadata.concepts.sys.id[all]` (string, optional) - `metadata.concepts.sys.id[nin]` (string, optional) - `metadata.concepts.descendants[in]` (any, optional) - `name[match]` (string, optional) - `name` (string, optional) - `sys.id[in]` (any, optional) - `sys.id[nin]` (any, optional) - `type` (enum, optional) - Allowed values: `DTCG.Color`, `DTCG.Dimension`, `DTCG.FontFamily`, `DTCG.FontWeight`, `DTCG.Duration`, `DTCG.CubicBezier`, `DTCG.Number`, `DTCG.StrokeStyle`, `DTCG.Border`, `DTCG.Transition`, `DTCG.Shadow`, `DTCG.Gradient`, `DTCG.Typography` - `type[in]` (any, optional) - `type[nin]` (any, optional) ## Response ### 200 200 - `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaSys, required) - `limit` (double, required) - `items` (list of SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItems, required) - `pages` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaPages, required) ## Errors ### 400 Bad Request Error 400 - `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaSys, required) - `message` (string, optional) - `requestId` (string, optional) - `details` (any, optional) - `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContext, optional) ### 401 Unauthorized Error 401 - `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaSys, required) - `message` (string, optional) - `requestId` (string, optional) - `details` (any, optional) - `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContext, optional) ### 403 Forbidden Error 403 - `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaSys, required) - `message` (string, optional) - `requestId` (string, optional) - `details` (any, optional) - `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContext, optional) ### 404 Not Found Error 404 - `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaSys, required) - `message` (string, optional) - `requestId` (string, optional) - `details` (any, optional) - `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContext, optional) ### 409 Conflict Error 409 - `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaSys, required) - `message` (string, optional) - `requestId` (string, optional) - `details` (any, optional) - `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContext, optional) ### 422 Unprocessable Entity Error 422 - `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaSys, required) - `message` (string, optional) - `requestId` (string, optional) - `details` (any, optional) - `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContext, optional) ### 500 Internal Server Error 500 - `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaSys, required) - `message` (string, optional) - `requestId` (string, optional) - `details` (any, optional) - `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContext, optional) ### 503 Service Unavailable Error 503 - `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaSys, required) - `message` (string, optional) - `requestId` (string, optional) - `details` (any, optional) - `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContext, optional) ## Types ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaSys - `id` (string, required) - `type` (enum, required) - Allowed values: `Error` ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItems - `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSys, required) - `name` (string, required) - `type` (enum, required) - Allowed values: `DTCG.Color`, `DTCG.Dimension`, `DTCG.FontFamily`, `DTCG.FontWeight`, `DTCG.Duration`, `DTCG.CubicBezier`, `DTCG.Number`, `DTCG.StrokeStyle`, `DTCG.Border`, `DTCG.Transition`, `DTCG.Shadow`, `DTCG.Gradient`, `DTCG.Typography` - `metadata` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadata, optional) ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaPages - `next` (string, optional) - `prev` (string, optional) ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContext - `code` (string, required) - `pluralCount` (double, optional) - `parameters` (map from string to SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContextParameters, optional) ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSys - `id` (string, required) - `type` (enum, required) - Allowed values: `DesignToken` - `space` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysSpace, required) - `environment` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysEnvironment, required) - `createdAt` (string, required) - `updatedAt` (string, required) - `createdBy` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysCreatedBy, required) - `updatedBy` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysUpdatedBy, required) - `version` (double, required) - `designSystemSource` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysDesignSystemSource, optional) ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadata - `tags` (list of SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadataTagsItems, optional) - `concepts` (list of SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadataConceptsItems, optional) - `annotations` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadataAnnotations, optional) ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContextParameters - SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContextParameters0 - SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContextParameters1 - SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContextParameters2 - SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContextParameters3 - SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContextParameters4 ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysSpace - `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysSpaceSys, required) ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysEnvironment - `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysEnvironmentSys, required) ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysCreatedBy - SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysCreatedBy0 - SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysCreatedBy1 ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysUpdatedBy - SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysUpdatedBy0 - SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysUpdatedBy1 ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysDesignSystemSource - `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysDesignSystemSourceSys, required) ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadataTagsItems - `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadataTagsItemsSys, required) ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadataConceptsItems - `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadataConceptsItemsSys, required) ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadataAnnotations - `DesignSystem` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadataAnnotationsDesignSystem, optional) - `ComponentType` (list of SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadataAnnotationsComponentTypeItems, optional, nullable) - `Template` (list of SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadataAnnotationsTemplateItems, optional, nullable) ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContextParameters0 - `type` (enum, required) - Allowed values: `string` - `value` (string, required) ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContextParameters1 - `type` (enum, required) - Allowed values: `number` - `value` (double, required) ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContextParameters2 - `type` (enum, required) - Allowed values: `date` - `value` (string, required) ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContextParameters3 - `type` (enum, required) - Allowed values: `array.string` - `value` (list of string, required) ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContextParameters4 - `type` (enum, required) - Allowed values: `array.number` - `value` (list of double, required) ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysSpaceSys - `type` (enum, required) - Allowed values: `Link` - `linkType` (enum, required) - Allowed values: `Space` - `id` (string, required) ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysEnvironmentSys - `type` (enum, required) - Allowed values: `Link` - `linkType` (enum, required) - Allowed values: `Environment` - `id` (string, required) ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysCreatedBy0 - `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysCreatedByOneOf0Sys, required) ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysCreatedBy1 - `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysCreatedByOneOf1Sys, required) ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysUpdatedBy0 - `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysUpdatedByOneOf0Sys, required) ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysUpdatedBy1 - `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysUpdatedByOneOf1Sys, required) ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysDesignSystemSourceSys - `type` (enum, required) - Allowed values: `ResourceLink` - `linkType` (enum, required) - Allowed values: `Contentful:DesignSystemSource` - `urn` (string, required) ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadataTagsItemsSys - `type` (enum, required) - Allowed values: `Link` - `linkType` (enum, required) - Allowed values: `Tag` - `id` (string, required) ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadataConceptsItemsSys - `type` (enum, required) - Allowed values: `Link` - `linkType` (enum, required) - Allowed values: `TaxonomyConcept` - `id` (string, required) ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadataAnnotationsDesignSystem - `source` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadataAnnotationsDesignSystemSource, optional, nullable) ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadataAnnotationsComponentTypeItems - `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadataAnnotationsComponentTypeItemsSys, required) - `parameters` (map from string to any, optional) ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadataAnnotationsTemplateItems - `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadataAnnotationsTemplateItemsSys, required) - `parameters` (map from string to any, optional) ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysCreatedByOneOf0Sys - `type` (enum, required) - Allowed values: `Link` - `linkType` (enum, required) - Allowed values: `User` - `id` (string, required) ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysCreatedByOneOf1Sys - `type` (enum, required) - Allowed values: `Link` - `linkType` (enum, required) - Allowed values: `App` - `id` (string, required) ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysUpdatedByOneOf0Sys - `type` (enum, required) - Allowed values: `Link` - `linkType` (enum, required) - Allowed values: `User` - `id` (string, required) ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysUpdatedByOneOf1Sys - `type` (enum, required) - Allowed values: `Link` - `linkType` (enum, required) - Allowed values: `App` - `id` (string, required) ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadataAnnotationsDesignSystemSource - `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadataAnnotationsDesignSystemSourceSys, required) ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadataAnnotationsComponentTypeItemsSys - `id` (string, required) - `type` (enum, required) - Allowed values: `Link` - `linkType` (enum, required) - Allowed values: `Annotation` ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadataAnnotationsTemplateItemsSys - `id` (string, required) - `type` (enum, required) - Allowed values: `Link` - `linkType` (enum, required) - Allowed values: `Annotation` ### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadataAnnotationsDesignSystemSourceSys - `type` (enum, required) - Allowed values: `ResourceLink` - `linkType` (enum, required) - Allowed values: `Contentful:DesignSystemSource` - `urn` (string, required) ## Examples **Response** ```json { "sys": { "type": "Array" }, "limit": 1.1, "items": [ { "sys": { "id": "string", "type": "DesignToken", "space": { "sys": { "type": "Link", "linkType": "Space", "id": "string" } }, "environment": { "sys": { "type": "Link", "linkType": "Environment", "id": "string" } }, "createdAt": "string", "updatedAt": "string", "createdBy": { "sys": { "id": "string", "linkType": "User", "type": "Link" } }, "updatedBy": { "sys": { "id": "string", "linkType": "User", "type": "Link" } }, "version": 1.1, "designSystemSource": { "sys": { "type": "ResourceLink", "linkType": "Contentful:DesignSystemSource", "urn": "string" } } }, "name": "string", "type": "DTCG.Color", "metadata": { "tags": [ { "sys": { "type": "Link", "linkType": "Tag", "id": "string" } } ], "concepts": [ { "sys": { "type": "Link", "linkType": "TaxonomyConcept", "id": "string" } } ], "annotations": { "DesignSystem": { "source": { "sys": { "type": "ResourceLink", "linkType": "Contentful:DesignSystemSource", "urn": "string" } } }, "ComponentType": [ { "sys": { "id": "string", "type": "Link", "linkType": "Annotation" }, "parameters": {} } ], "Template": [ { "sys": { "id": "string", "type": "Link", "linkType": "Annotation" }, "parameters": {} } ] } } } ], "pages": { "next": "string", "prev": "string" } } ```