---
title: "Creates a new exchange and returns location of exchange metadata in a response header."
method: POST
path: "/workflows/{localWorkflowId}/exchanges"
tags: ["Credentials"]
---

# Creates a new exchange and returns location of exchange metadata in a response header.

`POST /workflows/{localWorkflowId}/exchanges`

Creates a new exchange and returns location of exchange metadata in a response header.

## Parameters

- `./components/parameters/path/LocalWorkflowId.yml` — unresolved $ref

## Request body

- CreateExchangeRequest — unresolved $ref

## Response `201`

Exchange successfully created (with data)

## Other responses

- `204` — Exchange successfully created (without data)
- `400` — Invalid input
- `401` — Not Authorized
- `500` — Internal Error

## Changes

- **2026-08-11** `a64614f0016a` — 2 breaking, 6 info
  - removed `subschema #1, subschema #2` from the `openId/oneOf[#/components/schemas/OpenIDClientProfile]/` request property `oneOf` list
  - removed `subschema #1, subschema #2` from the `openId/oneOf[subschema #2]/clientProfiles/additionalProperties/` request property `oneOf` list
  - added the new optional request property `openId/oneOf[#/components/schemas/OpenIDClientProfile]/authorizationRequest`
  - added the new optional request property `openId/oneOf[#/components/schemas/OpenIDClientProfile]/createAuthorizationRequest`
  - …4 more
- **2026-08-04** `10a8511c33c1` — 2 breaking, 4 warning, 2 info
  - removed `subschema #1, subschema #2` from the `openId/oneOf[#/components/schemas/OpenIDClientProfile]/` request property `oneOf` list
  - removed `subschema #1, subschema #2` from the `openId/oneOf[subschema #2]/clientProfiles/additionalProperties/` request property `oneOf` list
  - removed the request property `openId/oneOf[#/components/schemas/OpenIDClientProfile]/authorizationRequest`
  - removed the request property `openId/oneOf[#/components/schemas/OpenIDClientProfile]/createAuthorizationRequest`
  - …4 more
- **2026-03-10** `848345580ee6` — 1 warning
  - removed the request property `variables/results`
- **2026-02-17** `47fa1e7a1f9e` — 1 info
  - added `#/components/schemas/OpenIDClientProfile, subschema #2` to the `openId` request property `oneOf` list
- …earlier changes not shown

[Full history](https://skmtc.dev/w3c/apis/verifiable-credential-api-for-lifecycle-management/changes/workflows/:localWorkflowId/exchanges/post.md)

---

[API](https://skmtc.dev/w3c/apis/verifiable-credential-api-for-lifecycle-management.md) · [All operations](https://skmtc.dev/w3c/apis/verifiable-credential-api-for-lifecycle-management/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/w3c/verifiable-credential-api-for-lifecycle-management/revisions/3ba233461759/schema)