---
title: "Retrieve available swaps for a given entrypoint snapshot"
method: GET
path: "/api/v1/entrypoints/{id}/snapshots/{snapshotId}/swaps"
tags: ["Entrypoints"]
---

# Retrieve available swaps for a given entrypoint snapshot

`GET /api/v1/entrypoints/{id}/snapshots/{snapshotId}/swaps`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/v1/entrypoints/{id}/snapshots/{snapshotId}/swaps`
- Auth: none declared
- TypeScript: <https://skmtc.dev/usnistgov/apis/dioptra-rest-api/docs/api/v1/entrypoints/:id/snapshots/:snapshotId/swaps/get.ts> (a function with typed inputs; its response is checked against the schema)

## Headers

- `X-Fields` string, mask

## Response `200`

Success

- SwapInfo[]
  - `swapName` string, required: The name of the swap this definition belongs to.
  - `taskAlias` string, required: Alias for the task definition.
  - `taskName` string, required: Name of the task that can be swapped in.
  - `entrypointKeywordArgs` string[], required: A list of the keyword arguments that need to be specified for this task.
  - `pluginFileResourceSnapshotId` integer, required: Resource snapshot ID of the plugin file containing the task.

## Changes

- **2026-09-30** `7615a76631a4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/usnistgov/apis/dioptra-rest-api/changes/api/v1/entrypoints/:id/snapshots/:snapshotId/swaps/get.md)

---

[API](https://skmtc.dev/usnistgov/apis/dioptra-rest-api.md) - [All operations](https://skmtc.dev/usnistgov/apis/dioptra-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/usnistgov/apis/dioptra-rest-api/revisions/e1a0ec3a40b2?raw)