---
type: api
title: Get the external input form for a paused workflow execution
description: **Spaces method and path for this operation:**
url: https://www.elastic.co/elastic/docs-builder/docs/4493/api/doc/kibana/operation/operation-get-workflows-executions-executionid-steps-stepid-resume-external-form
resource: https://www.elastic.co/elastic/docs-builder/docs/4493/api/doc/kibana/operation/operation-get-workflows-executions-executionid-steps-stepid-resume-external-form
products:
  - Kibana
---

# Get the external input form for a paused workflow execution

Availability: Generally available since 9.4

- Server: `https://{kibana_url}`

## Paths

- `GET` `/api/workflows/executions/{executionId}/steps/{stepId}/resume/external/form`
- `GET` `/s/{space_id}/api/workflows/executions/{executionId}/steps/{stepId}/resume/external/form`

#### Path parameters

- `executionId` (string · max length: 128) — required
  Workflow execution ID
- `stepId` (string · max length: 128) — required
  Workflow step execution ID

## Description

Refer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.

Returns an HTML form for submitting external input to a paused waitForInput step. Does not resume the execution.

## Authentication

- Api key: `Authorization: <value>`
  These APIs use key-based authentication. You must create an API key and use the encoded value in the request header. For example: `Authorization: ApiKey base64AccessApiKey`
- Basic: `Authorization: Basic <credentials>`

## Query string parameters

- `token` (string · max length: 128) — required
  The resume token authenticating this request.

## Response

HTML form page for submitting external input to a paused waitForInput step

`text/html`

Type: `string`

## Code examples

#### Console

```console
GET kbn://api/workflows/executions/{executionId}/steps/{stepId}/resume/external/form?token={resumeToken}
```

#### curl

```curl
curl \
  -X GET "${KIBANA_URL}/api/workflows/executions/{executionId}/steps/{stepId}/resume/external/form?token=${RESUME_TOKEN}"
```

## Response examples

#### External resume form

Form page for external input submission

```json
<!DOCTYPE html><html><body><h1>Submit your response</h1><form method="POST"><button type="submit">Submit</button></form></body></html>
```

