---
title: "Update a single auth request"
method: PATCH
path: "/auth-requests/{authRequestId}"
tags: ["auth-requests"]
---

# Update a single auth request

`PATCH /auth-requests/{authRequestId}`

Requires **auth_requests:read** and **auth_requests:write** scopes.

## Path parameters

- `authRequestId` string, uuid, required

## Request body

- AuthRequestPatch
  - `authParams` object, required
    - `state` string — State returned by financial institution
    - `code` string — Authorization code returned by financial institution
    - `id_token` string — Id token returned by financial institution
    - `error` string — Error returned by financial institution
    - `error_description` string — Error description returned by financial institution

## Response `200`

Successful Auth Request Response

- object
  - `data` AuthRequest
    - `id` string, uuid, required — The id of the auth request
    - `redirectUri` string — The redirect uri sent when creating the auth request
    - `createdAt` string, date-time, required — The date that the auth request was created.
    - `bankId` string, required — The id of the bank
    - `userId` string — The id of the user
    - `scope` string, required — The scope sent when creating the auth request
    - `connectionId` string — Id of the connection
    - `paymentId` string, uuid — Id of the payment when the auth request had the payment scope
    - `syncId` string — Id of the initial sync, can be used to check status of sync
    - `status` 'complete' | 'pending' | 'error' | 'deleted', required — The status of the auth request
  - `meta` object

## Other responses

- `401` — Unsuccessful Response - Not authorised - Missing authorization header - Invalid access Token
- `403` — Unsuccessful Response - Forbidden - Invalid scopes
- `404` — Unsuccessful Response - Resource Not found

---

[API](https://skmtc.net/moneyhubenterprise/apis/moneyhub-identity-service.md) · [All operations](https://skmtc.net/moneyhubenterprise/apis/moneyhub-identity-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/moneyhubenterprise/moneyhub-identity-service/revisions/8841721f7aae/schema)