---
title: "Match Deployment Shape Versions"
method: POST
path: "/v1/accounts/{account_id}/deploymentShapeVersions:match"
tags: ["gateway.openapi_Gateway"]
---

# Match Deployment Shape Versions

`POST /v1/accounts/{account_id}/deploymentShapeVersions:match`

## Request

- Base URL: `https://api.fireworks.ai`
- URL: `https://api.fireworks.ai/v1/accounts/{account_id}/deploymentShapeVersions:match`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/fw-ai-external/apis/gateway-rest-api/docs/v1/accounts/:account_id/deploymentShapeVersions:match/post.ts> (a function with typed inputs; its response is checked against the schema)

Returns the deployment shape versions compatible with the provided deployment create request. Use this to discover a validated shape before creating a deployment with `deployment_shape` set - shapeless deployments (raw accelerator type/count) skip validated-configuration checks and are far more likely to fail at creation.

## Path parameters

- `account_id` string, required

## Request body

- GatewayGatewayMatchDeploymentShapeVersionsBody
  - `createDeploymentRequest` object, required: The deployment create request to match deployment shape versions for. The full CreateDeploymentRequest schema is accepted here — including fields like `deployment.enableAddons` that affect shape compatibility — only the most common fields are listed below. See the Create Deployment reference page for the complete request schema.
    - `deployment` object: The properties of the deployment being created.
      - `baseModel` string: The base model the deployment will serve.
      - `enableAddons` boolean: If true, the deployment can serve LoRA addons. When set, only shapes with the MULTI_LORA capability are returned.

## Response `200`

A successful response.

- GatewayListDeploymentShapeVersionsResponse
  - `deploymentShapeVersions` GatewayDeploymentShapeVersion[]
    - `name` string
    - `createTime` string, date-time: The creation time of the deployment shape version. Lists will be ordered by this field.
    - `snapshot` GatewayDeploymentShape
      - `name` string
      - `displayName` string: Human-readable display name of the deployment shape. e.g. "My Deployment Shape" Must be fewer than 64 characters long.
      - `description` string: The description of the deployment shape. Must be fewer than 1000 characters long.
      - `createTime` string, date-time: The creation time of the deployment shape.
      - `updateTime` string, date-time: The update time for the deployment shape.
      - `baseModel` string, required: Mutable, but only via UpdateDeploymentShape and only to a compatible model: one with the same model_type, parameter_count, and embedding status. The derived model_type / parameter_count fields (OUTPUT_ONLY, IMMUTABLE) are therefore preserved across a swap. Any incompatible change is rejected.
      - `modelType` string: The model type of the base model.
      - `parameterCount` string, int64: The parameter count of the base model .
      - `acceleratorCount` integer: The number of accelerators used per replica. If not specified, the default is the estimated minimum required by the base model.
      - `acceleratorType` 'ACCELERATOR_TYPE_UNSPECIFIED' | 'NVIDIA_A100_80GB' | 'NVIDIA_H100_80GB' | 'AMD_MI300X_192GB' | 'NVIDIA_A10G_24GB' | 'NVIDIA_A100_40GB' | 'NVIDIA_L4_24GB' | 'NVIDIA_H200_141GB' | 'NVIDIA_B200_180GB' | 'AMD_MI325X_256GB' | 'AMD_MI350X_288GB' | 'NVIDIA_B300_288GB' | 'NVIDIA_GB200' | 'NVIDIA_GB300'
      - `precision` 'PRECISION_UNSPECIFIED' | 'FP16' | 'FP8' | 'FP8_MM' | 'FP8_AR' | 'FP8_MM_KV_ATTN' | 'FP8_KV' | 'FP8_MM_V2' | 'FP8_V2' | 'FP8_MM_KV_ATTN_V2' | 'NF4' | 'FP4' | 'BF16' | 'FP4_BLOCKSCALED_MM' | 'FP4_MX_MOE'
      - `disableDeploymentSizeValidation` boolean: If true, the deployment size validation is disabled.
      - `enableAddons` boolean: If true, LORA addons are enabled for deployments created from this shape. Deprecated: set enable_addons on the deployment instead.
      - `draftTokenCount` integer: The number of candidate tokens to generate per step for speculative decoding. Default is the base model's draft_token_count.
      - `draftModel` string: The draft model name for speculative decoding. e.g. accounts/fireworks/models/my-draft-model If empty, speculative decoding using a draft model is disabled. Default is the base model's default_draft_model. Deprecated: set default_draft_model on the base model instead.
      - `ngramSpeculationLength` integer: The length of previous input sequence to be considered for N-gram speculation.
      - `disableSpeculativeDecoding` boolean: DEPRECATED: This field is a no-op. Speculative decoding is configured on deployment.
      - `enableSessionAffinity` boolean: Whether to apply sticky routing based on `user` field.
      - `numLoraDeviceCached` integer
      - `maxContextLength` integer: The maximum context length supported by the model (context window). If set to 0 or not specified, the model's default maximum context length will be used.
      - `presetType` 'PRESET_TYPE_UNSPECIFIED' | 'MINIMAL' | 'FAST' | 'THROUGHPUT' | 'FULL_PRECISION' | 'AGENTIC_CODING' | 'CHAT' | 'SUMMARIZATION' | 'MULTI_LORA'
    - `validated` boolean: If true, this version has been validated.
    - `public` boolean: If true, this version will be publicly readable.
    - `latestValidated` boolean: If true, this version is the latest validated version. Only one version of the shape can be the latest validated version.
    - `capabilities` DeploymentShapeVersionCapability[]: The capabilities supported by this deployment shape version.
  - `nextPageToken` string: A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
  - `totalSize` integer: The total number of deployment shape versions.

## Changes

- **2026-10-16** `3bf245180173`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fw-ai-external/apis/gateway-rest-api/changes/v1/accounts/:account_id/deploymentShapeVersions:match/post.md)

---

[API](https://skmtc.dev/fw-ai-external/apis/gateway-rest-api.md) - [All operations](https://skmtc.dev/fw-ai-external/apis/gateway-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fw-ai-external/apis/gateway-rest-api/revisions/3bf245180173?raw)