# API Workflow

> API Workflow node for calling a deployed UiPath API workflow and using its output, with its configuration fields and output variables.

Invokes a UiPath Studio Web API workflow and returns its output.

## Choosing between API Workflow and HTTP Request

Use the **API Workflow** node when the logic you need to call is built as an API workflow and deployed, for example structured data processing or multi-step integrations authored by your team. Use the [HTTP Request](node-http-request.md) node when you are calling any external Representational State Transfer (REST) endpoint outside the UiPath Platform.

## Configuration

| Field | Required | Description |
|---|---|---|
| **API workflow** | Yes | The Studio Web API workflow to invoke. Select from the list of deployed API workflows in your organization. |
| **Input** | No | Key-value pairs mapped to the API workflow's input parameters. Supports variable references. |
| **Timeout** | No | Maximum time to wait for the workflow to complete. |

## Output variables

| Variable | Description |
|---|---|
| `output` | The response returned by the API workflow, according to its output schema. |
| `error` | Error details when the call fails. Use it with [error handling](error-handling.md) to branch on failures. |

## Examples

Reference the API workflow's output downstream with an expression:

```
$vars.apiWorkflow1.output
```

To use a single field from the output, append the field name defined by the API workflow's output schema, for example `$vars.apiWorkflow1.output.<field>`.

## Common issues

| Issue | Resolution |
|---|---|
| API workflow not listed in the dropdown | Make sure the API workflow is deployed and you have permission to call it. |
| Timeout error | Increase the Timeout value or make the API workflow faster. |
| Input type mismatch | Check that the variable types you are passing match the API workflow's declared input parameter types. |

## Next steps
- [HTTP Request](node-http-request.md): call an external REST endpoint.
- [RPA Workflow](node-rpa-workflow.md): start a robot-executed process.
- [Error handling](error-handling.md): route failures from the node.
- [Community](community.md): ask questions and share workflows with other builders on the UiPath Forum.
