---
title: "Consume a credential-request token and store the value"
method: POST
path: "/v1/credential-requests/submit"
tags: ["credential-requests"]
---

# Consume a credential-request token and store the value

`POST /v1/credential-requests/submit`

Single-use: atomically claims the link, forwards the value to the assistant's credential store, and marks the link redeemed.

## Request body

- object
  - `token` string, required
  - `value` string, required

## Response `200`

Successful response

- union
  - object
    - `ok` boolean, required
  - object
    - `error` object, required
      - `code` 'INVALID' | 'EXPIRED' | 'USED', required
      - `message` string, required

---

[API](https://skmtc.net/vellum-ai/apis/vellum-gateway-api.md) · [All operations](https://skmtc.net/vellum-ai/apis/vellum-gateway-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vellum-ai/vellum-gateway-api/versions/0ce2a9dec32d/schema)