---
title: "POST /v1/requests"
method: POST
path: "/v1/requests"
---

# POST /v1/requests

`POST /v1/requests`

## Request

- Base URL: `https://api.vault.sandbox.pci-proxy.com`
- URL: `https://api.vault.sandbox.pci-proxy.com/v1/requests`
- Auth: API key in header `pci-proxy-api-key`

Generate Document Vault upload request link

## Request body

- object
  - `reference` string, required
  - `successUrl` string, required
  - `cancelUrl` string, required
  - `errorUrl` string, required
  - `webhookEndpoint` string
  - `context` object

## Response `200`

Success

- object
  - `link` string: URL of the public Document Vault upload page

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not found

---

[API](https://skmtc.dev/pci-proxy/apis/document-vault.md) - [All operations](https://skmtc.dev/pci-proxy/apis/document-vault/llms.txt) - [OpenAPI document](https://skmtc.dev/pci-proxy/apis/document-vault/revisions/fc4b44e0e51c?raw)