---
title: "Describe platform"
method: GET
path: "/platforms/{platformId}"
tags: ["platforms"]
---

# Describe platform

`GET /platforms/{platformId}`

Retrieves the details of the computing platform identified by the given `platformId`.

## Path parameters

- `platformId` string, required

## Query parameters

- `workspaceId` integer
- `regionId` string, required
- `credentialsId` string, required

## Response `200`

OK

- DescribePlatformResponse
  - `metainfo` union
    - object
      - `discriminator` string — property to select the platform metainfo type
      - `warnings` string[]
      - `jobQueues` JobQueue[]
        - `name` string, required
        - `state` string, required
      - `buckets` Bucket[]
        - `path` string
      - `fileSystems` FsxFileSystem[]
        - `id` string
        - `dns` string
        - `mount` string
      - `efsFileSystems` EfsFileSystem[]
        - `id` string
      - `keyPairs` string[]
      - `vpcs` Vpc[]
        - `id` string
        - `isDefault` boolean
      - `images` Image[]
        - `id` string, required
        - `name` string, required
        - `description` string, required
        - `arch` string, required
      - `securityGroups` SecurityGroup[]
        - `id` string
        - `name` string
        - `vpcId` string
      - `subnets` Subnet[]
        - `id` string
        - `zone` string
        - `vpcId` string
      - `instanceFamilies` string[]
      - `allocStrategy` string[]
    - object
      - `discriminator` string — property to select the platform metainfo type
      - `warnings` string[]
      - `buckets` Bucket[]
        - `path` string
      - `keyPairs` string[]
      - `vpcs` Vpc[]
        - `id` string
        - `isDefault` boolean
      - `images` Image[]
        - `id` string, required
        - `name` string, required
        - `description` string, required
        - `arch` string, required
      - `securityGroups` SecurityGroup[]
        - `id` string
        - `name` string
        - `vpcId` string
      - `subnets` Subnet[]
        - `id` string
        - `zone` string
        - `vpcId` string
      - `instanceTypes` InstanceType[]
        - `id` string
        - `arch` string, required
    - object
      - `discriminator` string — property to select the platform metainfo type
      - `locations` string[]
      - `warnings` string[]
      - `zones` string[]
      - `buckets` GooglePlatformMetainfoBucket[]
        - `path` string
      - `filestores` GooglePlatformMetainfoFilestore[]
        - `target` string
        - `name` string
        - `location` string
    - object
      - `discriminator` string — property to select the platform metainfo type
      - `warnings` string[]
      - `zones` string[]
      - `buckets` GoogleBucket[]
        - `path` string
      - `instanceTypes` GoogleInstanceType[]
        - `id` string
        - `arch` string
      - `images` GoogleImage[]
        - `id` string
        - `name` string
        - `description` string
        - `arch` string
    - object
      - `discriminator` string — property to select the platform metainfo type
      - `warnings` string[]
      - `pools` string[]
      - `containers` string[]
      - `vmTypes` string[]
    - object
      - `discriminator` string — property to select the platform metainfo type
      - `warnings` string[]
      - `containers` string[]
      - `instanceTypes` string[]
    - object
      - `discriminator` string — property to select the platform metainfo type
      - `warnings` string[]
      - `clusters` string[]
    - object
      - `discriminator` string — property to select the platform metainfo type
      - `warnings` string[]
      - `clusters` string[]
    - object
      - `discriminator` string — property to select the platform metainfo type
    - object
      - `discriminator` string — property to select the platform metainfo type
    - object
      - `discriminator` string — property to select the platform metainfo type
      - `warnings` string[]
      - `jobQueues` JobQueue[]
        - `name` string, required
        - `state` string, required
      - `buckets` Bucket[]
        - `path` string
      - `fileSystems` FsxFileSystem[]
        - `id` string
        - `dns` string
        - `mount` string
      - `efsFileSystems` EfsFileSystem[]
        - `id` string
      - `keyPairs` string[]
      - `vpcs` Vpc[]
        - `id` string
        - `isDefault` boolean
      - `images` Image[]
        - `id` string, required
        - `name` string, required
        - `description` string, required
        - `arch` string, required
      - `securityGroups` SecurityGroup[]
        - `id` string
        - `name` string
        - `vpcId` string
      - `subnets` Subnet[]
        - `id` string
        - `zone` string
        - `vpcId` string
      - `instanceFamilies` string[]
      - `allocStrategy` string[]
      - `instanceTypes` InstanceType[]
        - `id` string
        - `arch` string, required
    - object
      - `discriminator` string — property to select the platform metainfo type

## Other responses

- `400` — Bad request
- `403` — Operation not allowed

## Changes

> 4 revisions in range; 1 not diffed.

- **2026-01-20** `98d6b538c88e` — 1 breaking, 3 info
  - added `#/components/schemas/AzCloudPlatformMetaInfo, #/components/schemas/SeqeraComputePlatformMetainfo` to the `metainfo` response property `oneOf` list for the response status `200`
  - added the optional property `metainfo/discriminator` to the response with the `200` status
  - added `google, azure-cloud` discriminator mapping keys to the `metainfo` response property for the response status `200`
  - removed `#/components/schemas/SeqeraComputePlatformDescriber` from the `metainfo` response property `oneOf` list for the response status `200`

[Change history](https://skmtc.dev/seqeralabs/apis/seqera-api/changes/platforms/:platformId/get.md)

---

[API](https://skmtc.dev/seqeralabs/apis/seqera-api.md) · [All operations](https://skmtc.dev/seqeralabs/apis/seqera-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/seqeralabs/seqera-api/revisions/49c99a6944de/schema)