---
title: "Lists all available Components with the specified Workspace Id"
method: GET
path: "/workspaces/{workspace_id}/components"
tags: ["components"]
---

# Lists all available Components with the specified Workspace Id

`GET /workspaces/{workspace_id}/components`

You need Workspace memberships to access this resource

In case Tenant feature flag for component whitelist is enabled and Workspace has type `full` - this endpoint lists all available Components in given workspace with respect of component whitelist.

Otherwise (i.e. if either feature flag is disabled, or workspace has type `limited`) - it lists all available omponents in given Workspace.

Response includes latest Descriptor for each Component.

## Path parameters

- `workspace_id` string, required

## Response `200`

OK

- object
  - `data` object[], required
    - `id` string, required
    - `type` 'component', required
    - `links` object, required
      - `self` string, required
    - `attributes` object, required
      - `name` string, required — Repository name
      - `team_name` string, required — Developer Team name
      - `access` 'team' | 'tenant' | 'globalversion', required
      - `whitelisted_contract_ids` string[], required — List of Contracts where this components is available for full Workspaces
    - `relationships` object, required
      - `versions` object, required
        - `links` object, required
          - `related` string, required
      - `latest_version` object, required
        - `data` object, required
          - `id` string, required
          - `type` 'version', required
        - `links` object, required
          - `self` string, required
  - `meta` object, required
  - `included` union[], required
    - union
      - object
        - `id` string, required
        - `type` 'descriptor', required
        - `links` object, required
          - `self` string, required
        - `attributes` object, required
          - `repo_name` string, required
          - `team_name` string, required
          - `short_revision` string, required
          - `is_latest` boolean, required
          - `description` string, required
          - `icon` string, required — Component icon as base64 string
          - `language` string, required
          - `sailor_version` string, required
          - `title` string, required
          - `triggers` object
        - `relationships` object, required
          - `version` object, required
            - `data` object, required
              - …
            - `links` object, required
              - …
      - object
        - `id` string, required
        - `type` 'version', required
        - `links` object, required
          - `self` string, required
        - `attributes` object, required
          - `date` integer, required — The unix time stamp
          - `version_number` string, required
        - `relationships` object, required
          - `descriptor` object, required
            - `data` object, required
              - …
            - `links` object, required
              - …
          - `component` object, required
            - `data` object, required
              - …
            - `links` object, required
              - …
  - `links` object, required
    - `self` string, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/elastic/apis/elastic-io-rest-api-documentation-v2.md) · [All operations](https://skmtc.net/elastic/apis/elastic-io-rest-api-documentation-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elastic/elastic-io-rest-api-documentation-v2/revisions/411f9f98c01e/schema)