---
title: "Find Input References Endpoint"
method: POST
path: "/protocols/input_references"
tags: ["protocols"]
---

# Find Input References Endpoint

`POST /protocols/input_references`

Find all input references from a protocol.

This endpoint extracts all input references of the form input["name"]
from the provided protocol. The protocol can be provided as a dictionary
(JSON), YAML string, or Protocol object serialized as dict.

Parameters
----------
body : FindInputReferencesRequest
    Request containing the protocol to analyze

Returns
-------
list[str]
    List of input reference names found in the protocol

Raises
------
BadRequestError
    If protocol parsing fails or input references cannot be extracted

## Request body

- FindInputReferencesRequest — Request body for finding input references in a protocol.
  - `protocol` union, required — Protocol as a dictionary (JSON), list, or string. Can be a protocol dict, list of steps, YAML string, or Protocol object serialized.
    - object
    - string
    - unknown[]
      - unknown

## Response `200`

Successful Response

- string[]

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/ionworks/apis/fastapi.md) · [All operations](https://skmtc.dev/ionworks/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ionworks/fastapi/revisions/7337a3cbdaf2/schema)