---
title: "Get workflow version inputs"
method: GET
path: "/agents/v2/workflows/{workflowId}/versions/{versionId}/inputs"
tags: ["Workflow Versions"]
---

# Get workflow version inputs

`GET /agents/v2/workflows/{workflowId}/versions/{versionId}/inputs`

## Request

- Base URL: `https://odyssey.asteroid.ai`
- URL: `https://odyssey.asteroid.ai/agents/v2/workflows/{workflowId}/versions/{versionId}/inputs`
- Auth: API key in header `X-Api-Key`

Get the input variable names a workflow version accepts at execution time

## Path parameters

- `workflowId` string, uuid, required
- `versionId` string, uuid, required

## Response `200`

The request has succeeded.

- WorkflowsVersionInputs: The typed inputs a workflow version declares
  - `inputs` AgentsWorkflowInput[], required
    - `defaultValue` unknown
    - `description` string
    - `name` string, required: The variable name. Matches [a-zA-Z_][a-zA-Z0-9_]* and is unique within the workflow.
    - `required` boolean, required: Whether a value must be supplied at execution time. Defaults to false.
    - `schema` object, required: A single-field JSON Schema fragment describing the input's type, e.g. {type: "string"}, {type: "number"}, {type: "object", properties: {...}}. Validated adaptively at execution time.

## Other responses

- `400`: The server could not understand the request due to invalid syntax.
- `401`: Access is unauthorized.
- `403`: Access is forbidden.
- `404`: The server cannot find the requested resource.
- `500`: Server error

---

[API](https://skmtc.dev/asteroid/apis/agent-service.md) - [All operations](https://skmtc.dev/asteroid/apis/agent-service/llms.txt) - [OpenAPI document](https://skmtc.dev/asteroid/apis/agent-service/revisions/ccc134d1d510?raw)