---
title: "Mint an update-mode link token and start the parked workflow"
method: POST
path: "/api/plaid/linkToken/update"
tags: ["Plaid"]
---

# Mint an update-mode link token and start the parked workflow

`POST /api/plaid/linkToken/update`

## Request body

- object
  - `mode` 'add-accounts' | 'add-products' | 'reauth', required
  - `plaidItemId` string, required

## Response `200`

Link token minted; workflow parked on hook. Client must echo the Plaid Link outcome via /resolveLink

- object
  - `hookToken` string, required
  - `institutionLogo` string, nullable
  - `institutionName` string, nullable
  - `institutionUrl` string, nullable
  - `link_token` string, required
  - `mode` 'update' | 'reauth'
  - `plaidItemId` string
  - `runId` string, required

## Other responses

- `400` — Unsupported update mode
- `401` — Unauthorized
- `404` — Plaid item not found
- `422` — Validation failed
- `502` — Plaid API failed

---

[API](https://skmtc.net/cobaltpf/apis/cobalt-api.md) · [All operations](https://skmtc.net/cobaltpf/apis/cobalt-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cobaltpf/cobalt-api/revisions/8ef0dfb5d23c/schema)