---
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-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
- **2026-02-10** `9a5377c1edab` — 1 breaking
  - removed `#/components/schemas/OpenIDClientProfile, subschema #2` from the `openId` request property `oneOf` list
- **2026-02-03** `8e6d9f2115bf` — 6 info
  - added the new optional request property `openId/oneOf[#/components/schemas/OpenIDClientProfile]/dcql_query`
  - added the new optional request property `openId/oneOf[#/components/schemas/OpenIDClientProfile]/presentation_definition`
  - added the new optional request property `openId/oneOf[#/components/schemas/OpenIDClientProfile]/response_uri`
  - added the new optional request property `openId/oneOf[subschema #2]/clientProfiles/additionalProperties/dcql_query`
  - …2 more
- **2026-01-28** `9de603962d52` — 1 info
  - added `#/components/schemas/OpenIDClientProfile, subschema #2` to the `openId` request property `oneOf` list

[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/bbb07fe41f28/schema)