---
title: "PATCH /api/v1/auth/oidc-auth/identities/{identityId}"
method: PATCH
path: "/api/v1/auth/oidc-auth/identities/{identityId}"
tags: ["OIDC Auth"]
---

# PATCH /api/v1/auth/oidc-auth/identities/{identityId}

`PATCH /api/v1/auth/oidc-auth/identities/{identityId}`

Update OIDC Auth configuration on machine identity

## Path parameters

- `identityId` string, required

## Request body

- object
  - `oidcDiscoveryUrl` string, uri — The new URL used to retrieve the OpenID Connect configuration from the identity provider.
  - `caCert` string — The new PEM-encoded CA cert for establishing secure communication with the Identity Provider endpoints.
  - `boundIssuer` string — The new unique identifier of the identity provider issuing the JWT.
  - `boundAudiences` string — The new list of intended recipients.
  - `boundClaims` object — The new attributes that should be present in the JWT for it to be valid.
  - `claimMetadataMapping` object — The new attributes that should be present in the permission metadata from the JWT.
  - `boundSubject` string — The new expected principal that is the subject of the JWT.
  - `accessTokenTrustedIps` object[] — The new IPs or CIDR ranges that access tokens can be used from.
    - `ipAddress` string, required
  - `accessTokenTTL` integer — The new lifetime for an access token in seconds.
  - `accessTokenMaxTTL` integer — The new maximum lifetime for an access token in seconds.
  - `accessTokenNumUsesLimit` integer — The new maximum number of times that an access token can be used.

## Response `200`

Default Response

- object
  - `identityOidcAuth` object, required
    - `id` string, uuid, required
    - `accessTokenTTL` number
    - `accessTokenMaxTTL` number
    - `accessTokenNumUsesLimit` number
    - `accessTokenTrustedIps` unknown
    - `identityId` string, uuid, required
    - `oidcDiscoveryUrl` string, required
    - `boundIssuer` string, required
    - `boundAudiences` string, required
    - `boundClaims` unknown
    - `claimMetadataMapping` unknown
    - `boundSubject` string, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `caCert` string, required

## Other responses

- `400` — Default Response
- `401` — Default Response
- `403` — Default Response
- `404` — Default Response
- `422` — Default Response
- `500` — Default Response

---

[API](https://skmtc.net/infisical/apis/infisical-api.md) · [All operations](https://skmtc.net/infisical/apis/infisical-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/infisical/infisical-api/versions/885aef3e6c11/schema)