> ## Documentation Index
> Fetch the complete documentation index at: https://developers.clay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# workflows actions schema

> Fetch one action's input schema by packageId and actionKey.

Fetch the input schema for one Clay action, so you can wire it into a workflow node's `tools`. Get a `packageId` and `actionKey` from [`clay workflows actions list`](/cli/reference/workflows-actions-list). Always bind inputs using the exact names this command returns — never guess them from the action's name or outputs. For parameters whose options or fields depend on other inputs, resolve them with [`clay workflows actions dynamic-fields`](/cli/reference/workflows-actions-dynamic-fields).

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
clay workflows actions schema <packageId> <actionKey>
```

## Arguments

| Argument    | Description                                                 |
| ----------- | ----------------------------------------------------------- |
| `packageId` | Action package id, from `workflows actions list`. Required. |
| `actionKey` | Action key, from `workflows actions list`. Required.        |

## Output

`inputParameters` is an array of the action's input parameters — one entry per field you can pass when adding this action to a node's tools. Each entry typically has `name`, `displayName`, `type`, `required`, and `description`.

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "packageId": "56058efe-4757-4fe7-a44b-39c2d730c47a",
  "actionKey": "find-email-from-name",
  "displayName": "Find email from name",
  "inputParameters": [
    {
      "name": "fullName",
      "displayName": "Full name",
      "type": "string",
      "required": true,
      "description": "The person's full name."
    }
  ]
}
```

| Field             | Type            | Description                                                                 |
| ----------------- | --------------- | --------------------------------------------------------------------------- |
| `packageId`       | string          | The action's package id.                                                    |
| `actionKey`       | string          | The action's key.                                                           |
| `displayName`     | string          | Human-readable action name.                                                 |
| `inputParameters` | array of object | The action's input parameters. Use each `name` exactly when binding inputs. |

## Errors

| Code               | Exit | Notes                                               |
| ------------------ | ---- | --------------------------------------------------- |
| `validation_error` | 2    | `packageId` and `actionKey` arguments are required. |
| `not_found`        | 6    | No action with that `packageId` / `actionKey`.      |
| `auth_forbidden`   | 3    | The API key lacks permission for this command.      |

## Examples

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
clay workflows actions schema 56058efe-4757-4fe7-a44b-39c2d730c47a find-email-from-name
clay workflows actions schema <packageId> <actionKey> | jq '.inputParameters'
```