---
title: "Handoff submission"
method: PUT
path: "/workflow/{workflowPath}/handoff"
tags: ["Workflow"]
---

# Handoff submission

`PUT /workflow/{workflowPath}/handoff`

Hands off existing submission to specified workflow. This endpoint is available to "Administrator" users only.
### Authorization Required:
  - Express Super User or Designer Administrator

## Path parameters

- `workflowPath` string, required

## Request body

- HandoffSubmissionToWorkflowRequest
  - `submissionId` string, required — ID of submission to use.
  - `startNode` string — Path of the start node in handoff workflow. Default start node will be used when startNode is not provided.

## Response `200`

Successfully handed off submission

- HandoffSubmissionToWorkflowResponse
  - `submissionId` string — ID of submission
  - `workflowId` string — ID of workflow after handoff
  - `state` string — Current state of the submission
  - `statusCode` 200
  - `submission` object — Submission data

## Other responses

- `default` — Failed to hand off submission

---

[API](https://skmtc.net/unqork/apis/unqork-customer-api.md) · [All operations](https://skmtc.net/unqork/apis/unqork-customer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unqork/unqork-customer-api/revisions/112399a67ebb/schema)