---
title: "Use this endpoint to update user authentication status"
method: POST
path: "/ciba_status_update/{transactionId}"
tags: ["Backchannel Status Update Endpoint"]
---

# Use this endpoint to update user authentication status

`POST /ciba_status_update/{transactionId}`

When using external authenticator that is able to do a callback to OIDC Provider,
this endpoint will be used to update the authentication status.

## Path parameters

- `transactionId` string, required

## Request body

- CibaStatusUpdateRequest — status update payload
  - `status` string, required — Status of the user authentication. The expected value is either 'success' or 'failed'.
  - `metadata` object, required — Metadata associated with the authenticated user. It should be populated when the status is 'success'. This metadata will be used for grant enrichment and it should at least contain the claim indicated by 'subject_attribute_name' in the provider.yml.

## Response `204`

Successful response

## Other responses

- `403` — Invalid bearer token provided
- `404` — Transaction not found

---

[API](https://skmtc.net/ibm/apis/ibm-security-verify-access-oidc-provider.md) · [All operations](https://skmtc.net/ibm/apis/ibm-security-verify-access-oidc-provider/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ibm/ibm-security-verify-access-oidc-provider/revisions/68cfc4d21b73/schema)