> ## Documentation Index
> Fetch the complete documentation index at: https://cobalt-55-abhishek.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Workflow Request Structure

> Get the request body structure a workflow expects on execute.

Return the structure a workflow expects when you [execute](/legacy/api-reference/workflows/execute-workflow) it — its JSON Schema (if defined) and/or a structure derived from the workflow's `manual_execution_payload`. Use this to build a valid execute payload.

<Note>
  This authenticates as a linked account, so it resolves the structure for that account's **private** workflow.
</Note>

## Authentication

This endpoint is scoped to a linked account, so it accepts **either** authentication method.

**Option 1 — API key**

<ParamField header="x-api-key" type="string">Your Refold API key.</ParamField>
<ParamField header="linked_account_id" type="string">The linked account that owns the workflow.</ParamField>

**Option 2 — Session token**

<ParamField header="Authorization" type="string">Session token. **Format:** `Bearer YOUR_SESSION_TOKEN`</ParamField>

## Path Parameters

<ParamField path="workflow_id" type="string" required>The workflow ID.</ParamField>

## Response

<Tabs>
  <Tab title="200 OK">
    <ResponseField name="payload" type="object">A sample payload derived from `manual_execution_payload`, or `null`.</ResponseField>
    <ResponseField name="schema" type="object">The workflow's JSON Schema, or `null`.</ResponseField>
    <ResponseField name="schema_interpreted" type="object">A friendly interpretation of the schema, or `null`.</ResponseField>
  </Tab>

  <Tab title="404 Not Found">
    <ResponseField name="status_code" type="integer">HTTP status code.</ResponseField>
    <ResponseField name="http_error_type" type="string">Error category.</ResponseField>
    <ResponseField name="error_code" type="string">Internal error code.</ResponseField>
    <ResponseField name="message" type="string">Human-readable error description.</ResponseField>
  </Tab>
</Tabs>

<ResponseExample>
  ```json 200 No schema defined theme={null}
  {
    "payload": null,
    "schema": null,
    "schema_interpreted": null
  }
  ```

  ```json 200 With schema theme={null}
  {
    "payload": { "email": "jane@example.com" },
    "schema": {
      "type": "object",
      "required": ["email"],
      "properties": { "email": { "type": "string" } }
    },
    "schema_interpreted": { "email": "string (required)" }
  }
  ```
</ResponseExample>

<RequestExample>
  ```bash cURL (API key) theme={null}
  curl -X GET "https://app.refold.ai/api/v2/public/workflow/request-structure/{workflow_id}" \
    -H "x-api-key: YOUR_API_KEY" \
    -H "linked_account_id: YOUR_LINKED_ACCOUNT_ID"
  ```

  ```bash cURL (session token) theme={null}
  curl -X GET "https://app.refold.ai/api/v2/public/workflow/request-structure/{workflow_id}" \
    -H "Authorization: Bearer YOUR_SESSION_TOKEN"
  ```
</RequestExample>