---
title: "Submit data for processing"
method: POST
path: "/workers/{idOrName}/process"
---

# Submit data for processing

`POST /workers/{idOrName}/process`

Required role: set by AUTHTYPE in worker 

Submit data/document/file for processing such as for instance signing and get back the result (i.e. signature).

## Path parameters

- `idOrName` string, required

## Request body

- ProcessRequest — POJO that represents a process request.
  - `data` string, required — The input data to be processed (i.e. signed).
  - `encoding` 'NONE' | 'BASE64' — Choice of additional encoding of the data.
  - `metaData` object — Additional request metadata for the worker.

## Response `200`

The response data

- ProcessResponse — POJO that represents a process response.
  - `data` string — The resulting data (i.e the signature) in Base64 encoding
  - `requestId` string
  - `archiveId` string
  - `signerCertificate` string
  - `metaData` object

## Other responses

- `400` — Bad request from the client
- `403` — Access is forbidden!
- `404` — No such worker
- `500` — The server were unable to process the request. See server-side logs for more details.
- `503` — Crypto Token not available

## Changes

- **2026-07-17** `d1bc41f9bf6b` — 1 breaking, 3 info
  - `path` request parameter `idOrName` list-of-types was narrowed by removing types `integer`
  - added the media type `multipart/form-data` to the request body
  - for the `path` request parameter `idOrName`, the type/format was generalized from ``/`` to `string`/``
  - added the media type `application/octet-stream` for the response with the status `200`
- **2024-10-08** `dc6dab9b10b8` — 1 breaking, 1 warning
  - the `encoding` request property type/format changed from ``/`` to `string`/``
  - removed `subschema #2` from the `encoding` request property `allOf` list
- **2023-11-23** `d5ee0ae7ba00` — 1 info
  - added the non-success response with the status `403`
- **2023-11-20** `a90e50559d02` — 1 breaking
  - request body became required
- **2023-11-16** `d4cad3f34ce0` — 4 breaking, 4 info
  - removed the media type `multipart/form-data` from the request body
  - added `subschema #2` to the `encoding` request property `allOf` list
  - the `encoding` request property type/format changed from `string`/`` to ``/``
  - removed the media type `application/octet-stream` for the response with the status `200`
  - …4 more

[Change history](https://skmtc.dev/keyfactor/apis/signserver-rest-interface/changes/workers/:idOrName/process/post.md)

---

[API](https://skmtc.dev/keyfactor/apis/signserver-rest-interface.md) · [All operations](https://skmtc.dev/keyfactor/apis/signserver-rest-interface/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/keyfactor/signserver-rest-interface/revisions/d1bc41f9bf6b/schema)