---
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
- `sched` boolean
- `nvme` boolean
- `regionId` string, required
- `credentialsId` string, required

## Response `200`

OK

- DescribePlatformResponse
  - `metainfo` union
    - object
      - `discriminator` string — property to select the platform metainfo type
      - `allocStrategy` string[]
      - `buckets` Bucket[]
        - `path` string
      - `efsFileSystems` EfsFileSystem[]
        - `id` string
      - `fileSystems` FsxFileSystem[]
        - `dns` string
        - `id` string
        - `mount` string
      - `images` Image[]
        - `arch` string, required
        - `description` string, required
        - `id` string, required
        - `name` string, required
      - `instanceFamilies` string[]
      - `jobQueues` JobQueue[]
        - `name` string, required
        - `state` string, required
      - `keyPairs` string[]
      - `securityGroups` SecurityGroup[]
        - `id` string
        - `name` string
        - `vpcId` string
      - `subnets` Subnet[]
        - `id` string
        - `vpcId` string
        - `zone` string
      - `vpcs` Vpc[]
        - `id` string
        - `isDefault` boolean
      - `warnings` string[]
    - object
      - `discriminator` string — property to select the platform metainfo type
      - `buckets` Bucket[]
        - `path` string
      - `images` Image[]
        - `arch` string, required
        - `description` string, required
        - `id` string, required
        - `name` string, required
      - `instanceTypes` InstanceType[]
        - `arch` string, required
        - `features` Feature[] — Capability features advertised for this instance type (e.g. GPU, NVMe). Absent when the data source does not publish features; an empty list means none.
        - `id` string
      - `keyPairs` string[]
      - `securityGroups` SecurityGroup[]
        - `id` string
        - `name` string
        - `vpcId` string
      - `subnets` Subnet[]
        - `id` string
        - `vpcId` string
        - `zone` string
      - `vpcs` Vpc[]
        - `id` string
        - `isDefault` boolean
      - `warnings` string[]
    - object
      - `discriminator` string — property to select the platform metainfo type
      - `buckets` GooglePlatformMetainfoBucket[]
        - `path` string
      - `filestores` GooglePlatformMetainfoFilestore[]
        - `location` string
        - `name` string
        - `target` string
      - `images` GoogleImage[]
        - `arch` string
        - `description` string
        - `id` string
        - `name` string
        - `qualifiedName` string
      - `instanceTypes` GoogleInstanceType[]
        - `arch` string
        - `features` Feature[] — Capability features advertised for this instance type (e.g. GPU). Absent when the data source does not publish features; an empty list means none.
        - `id` string
      - `locations` string[]
      - `warnings` string[]
      - `zones` string[]
    - object
      - `discriminator` string — property to select the platform metainfo type
      - `buckets` GoogleBucket[]
        - `path` string
      - `images` GoogleImage[]
        - `arch` string
        - `description` string
        - `id` string
        - `name` string
        - `qualifiedName` string
      - `instanceTypes` GoogleInstanceType[]
        - `arch` string
        - `features` Feature[] — Capability features advertised for this instance type (e.g. GPU). Absent when the data source does not publish features; an empty list means none.
        - `id` string
      - `networks` GoogleNetwork[]
        - `name` string
        - `selfLink` string
      - `subnetworks` GoogleSubnetwork[]
        - `name` string
        - `network` string
        - `region` string
      - `warnings` string[]
      - `zones` string[]
    - object
      - `discriminator` string — property to select the platform metainfo type
      - `containers` string[]
      - `pools` string[]
      - `vmTypes` string[]
      - `warnings` string[]
    - object
      - `discriminator` string — property to select the platform metainfo type
      - `containers` string[]
      - `instanceTypes` string[]
      - `networks` AzNetwork[]
        - `id` string
        - `name` string
        - `region` string
        - `resourceGroup` string
      - `subnets` AzSubnet[]
        - `name` string
        - `networkId` string
        - `region` string
      - `warnings` string[]
    - object
      - `discriminator` string — property to select the platform metainfo type
      - `clusters` string[]
      - `warnings` string[]
    - object
      - `discriminator` string — property to select the platform metainfo type
      - `clusters` string[]
      - `warnings` 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
      - `allocStrategy` string[]
      - `buckets` Bucket[]
        - `path` string
      - `efsFileSystems` EfsFileSystem[]
        - `id` string
      - `fileSystems` FsxFileSystem[]
        - `dns` string
        - `id` string
        - `mount` string
      - `images` Image[]
        - `arch` string, required
        - `description` string, required
        - `id` string, required
        - `name` string, required
      - `instanceFamilies` string[]
      - `instanceTypes` InstanceType[]
        - `arch` string, required
        - `features` Feature[] — Capability features advertised for this instance type (e.g. GPU, NVMe). Absent when the data source does not publish features; an empty list means none.
        - `id` string
      - `jobQueues` JobQueue[]
        - `name` string, required
        - `state` string, required
      - `keyPairs` string[]
      - `securityGroups` SecurityGroup[]
        - `id` string
        - `name` string
        - `vpcId` string
      - `subnets` Subnet[]
        - `id` string
        - `vpcId` string
        - `zone` string
      - `vpcs` Vpc[]
        - `id` string
        - `isDefault` boolean
      - `warnings` string[]
    - object
      - `discriminator` string — property to select the platform metainfo type

## Other responses

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

## Changes

> 14 revisions in range; 1 not diffed, 2 could not be searched.

- **2026-07-09** `aa8544683897` — 2 info
  - added the optional property `metainfo/oneOf[subschema #6: Azure Cloud platform metainfo]/networks` to the response with the `200` status
  - added the optional property `metainfo/oneOf[subschema #6: Azure Cloud platform metainfo]/subnets` to the response with the `200` status
- **2026-05-11** `61cfa2ccce46` — 6 info
  - added the new optional `query` request parameter `nvme`
  - added the new optional `query` request parameter `sched`
  - added the optional property `metainfo/oneOf[subschema #11: Seqera Compute platform metainfo]/instanceTypes/items/features` to the response with the `200` status
  - added the optional property `metainfo/oneOf[subschema #2: AWS Cloud platform metainfo]/instanceTypes/items/features` to the response with the `200` status
  - …2 more
- **2026-03-17** `58c125675f01` — 3 info
  - added the optional property `metainfo/oneOf[subschema #3: Google Batch platform metainfo]/images` to the response with the `200` status
  - added the optional property `metainfo/oneOf[subschema #3: Google Batch platform metainfo]/instanceTypes` to the response with the `200` status
  - added the optional property `metainfo/oneOf[subschema #4: Google Cloud platform metainfo]/images/items/qualifiedName` to the response with the `200` status
- …earlier changes not shown

[Full 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/97f7655d105a/schema)
