---
title: "Get the full configuration of a specific revision"
method: GET
path: "/v1/deployments/{id}/revisions/{revisionIdentifier}"
tags: ["Deployments"]
---

# Get the full configuration of a specific revision

`GET /v1/deployments/{id}/revisions/{revisionIdentifier}`

## Request

- Base URL: `https://api.together.ai`
- URL: `https://api.together.ai/v1/deployments/{id}/revisions/{revisionIdentifier}`
- Auth: HTTP bearer

Returns the deployment configuration defined by the specified revision.
Only the 50 most recent revisions per deployment retain their configuration; older revisions return 404 even while they still appear in the revision history.
The deployment's currently active revision is always available, regardless of age.

## Path parameters

- `id` string, required: Deployment ID or name.
- `revisionIdentifier` string, required: Revision number or revision ID.

## Response `200`

Configuration of the specified revision

- RevisionDetailResponse: Deployment configuration captured for one retained revision.
  - `object` 'revision', required: The object type, which is always `revision`.
  - `revision_id` string, required: Unique revision identifier.
  - `image` string, required: Container image used by this revision.
  - `min_replicas` integer, required: Minimum number of replicas configured for this revision.
  - `max_replicas` integer, required: Maximum number of replicas configured for this revision.
  - `port` integer, required: Container port exposed by this revision.
  - `protocol` string, required: Network protocol served by the deployment revision.
  - `capacity_type` 'stable' | 'preemptible', required: Capacity behavior for replicas above reserved capacity.
  - `command` string[], required: Entrypoint command run by the container.
  - `args` string[], required: Arguments passed to the container command.
  - `environment_variables` EnvironmentVariable[], required: Environment variables configured on this revision.
    - `name` string, required: Name is the environment variable name (e.g., "DATABASE_URL"). Must start with a letter or underscore, followed by letters, numbers, or underscores
    - `value` string: Value is the plain text value for the environment variable. Use this for non-sensitive values. Either Value or ValueFromSecret must be set, but not both
    - `value_from_secret` string: ValueFromSecret references a secret by name or ID to use as the value. Use this for sensitive values like API keys or passwords. Either Value or ValueFromSecret must be set, but not both
    - `value_from_secret_expires_at` string, date-time: ValueFromSecretExpiresAt is the ISO8601 timestamp when the referenced secret expires and is deleted. Read-only, ignored in requests
  - `volumes` VolumeMount[], required: Volume mounts attached to this revision.
    - `mount_path` string, required: MountPath is the path in the container where the volume mounts (e.g., "/data").
    - `name` string, required: Name is the name of the volume to mount. Must reference an existing volume by name or ID
    - `version` integer: Version is the volume version to mount. On create, defaults to the latest version. On update, defaults to the currently mounted version.
  - `gpu_type` string, required: GPU hardware type configured for this revision.
  - `gpu_count` integer, required: Number of GPUs allocated to each replica.
  - `cpu` number, required: CPU cores allocated to each replica.
  - `memory` number, required: Memory allocated to each replica in GiB.
  - `storage` integer, required: Ephemeral storage allocated to each replica.
  - `health_check_path` string, required: HTTP path used for health checks.
  - `autoscaling` union: Autoscaling configuration captured for this revision.
    - HTTPAutoscalingConfig: Autoscaling config for HTTPTotalRequests and HTTPAvgRequestDuration metrics
      - `metric` 'HTTPTotalRequests' | 'HTTPAvgRequestDuration': Metric must be HTTPTotalRequests or HTTPAvgRequestDuration
      - `target` number: Target is the threshold value. Default: 100 for HTTPTotalRequests, 500 (ms) for HTTPAvgRequestDuration
      - `time_interval_minutes` integer: TimeIntervalMinutes is the rate window in minutes. Default: 10
    - QueueAutoscalingConfig: Autoscaling config for QueueBacklogPerWorker metric
      - `metric` 'QueueBacklogPerWorker': Metric must be QueueBacklogPerWorker
      - `model` string: Model overrides the model name for queue status lookup. Defaults to the deployment app name
      - `target` number: Target is the threshold value. Default: 1.01
    - CustomMetricAutoscalingConfig: Autoscaling config for CustomMetric metric
      - `custom_metric_name` string: CustomMetricName is the Prometheus metric name. Must match [a-zA-Z_:][a-zA-Z0-9_:]*
      - `metric` 'CustomMetric': Metric must be CustomMetric
      - `target` number: Target is the threshold value. Default: 500
  - `termination_grace_period_seconds` integer: Seconds to wait for graceful shutdown before forcefully terminating a replica.
  - `created_at` string, date-time, required: Time when this revision was created.

## Other responses

- `400`: Invalid revision identifier
- `404`: Deployment not found, or revision not found / no longer retained
- `500`: Internal server error

## Changes

- **2026-10-28** `93438ddac711`: 1 info
  - added the optional property `environment_variables/items/value_from_secret_expires_at` to the response with the `200` status
- **2026-10-22** `bb5257b3173a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/together/apis/together-apis/changes/v1/deployments/:id/revisions/:revisionIdentifier/get.md)

---

[API](https://skmtc.dev/together/apis/together-apis.md) - [All operations](https://skmtc.dev/together/apis/together-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/together/apis/together-apis/revisions/93438ddac711?raw)