For AI agents: A markdown version of this page is available at https://docs.datadoghq.com/api/latest/users/update-identity-provider-overrides-for-a-user.md. A documentation index is available at /llms.txt.

Update identity provider overrides for a user

PATCH https://api.ap1.datadoghq.com/api/v2/users/{user_id}/relationships/identity_providershttps://api.ap2.datadoghq.com/api/v2/users/{user_id}/relationships/identity_providershttps://api.datadoghq.eu/api/v2/users/{user_id}/relationships/identity_providershttps://api.ddog-gov.com/api/v2/users/{user_id}/relationships/identity_providershttps://api.us2.ddog-gov.com/api/v2/users/{user_id}/relationships/identity_providershttps://api.uk1.datadoghq.com/api/v2/users/{user_id}/relationships/identity_providershttps://api.datadoghq.com/api/v2/users/{user_id}/relationships/identity_providershttps://api.us3.datadoghq.com/api/v2/users/{user_id}/relationships/identity_providershttps://api.us5.datadoghq.com/api/v2/users/{user_id}/relationships/identity_providers

Overview

Set the identity provider overrides for a specific user in the organization. Pass an empty list to remove all overrides, reverting the user to the organization’s default identity providers. This endpoint requires the user_access_manage permission.

OAuth apps require the user_access_manage authorization scope to access this endpoint.

Arguments

Path Parameters

Name

Type

Description

user_id [required]

string

The ID of the user.

Request

Body Data (required)

Expand All

Field

Type

Description

data [required]

[object]

List of identity provider resource identifiers for a relationship update.

id [required]

string

The unique identifier of the identity provider.

type [required]

enum

The resource type for identity providers. Allowed enum values: identity_providers

{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000001",
      "type": "identity_providers"
    }
  ]
}

Response

No Content

Bad Request

API error response.

Expand All

Field

Type

Description

errors [required]

[string]

A list of errors.

{
  "errors": [
    "Bad Request"
  ]
}

Authentication error

API error response.

Expand All

Field

Type

Description

errors [required]

[string]

A list of errors.

{
  "errors": [
    "Bad Request"
  ]
}

Not found

API error response.

Expand All

Field

Type

Description

errors [required]

[string]

A list of errors.

{
  "errors": [
    "Bad Request"
  ]
}

Too many requests

API error response.

Expand All

Field

Type

Description

errors [required]

[string]

A list of errors.

{
  "errors": [
    "Bad Request"
  ]
}

Code Example

                  ## default
# 

# Path parameters
export user_id="00000000-0000-9999-0000-000000000000"
# Curl command
curl -X PATCH "https://api.ap1.datadoghq.com"https://api.ap2.datadoghq.com"https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.us2.ddog-gov.com"https://api.uk1.datadoghq.com"https://api.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/api/v2/users/${user_id}/relationships/identity_providers" \ -H "Content-Type: application/json" \ -H "DD-API-KEY: ${DD_API_KEY}" \ -H "DD-APPLICATION-KEY: ${DD_APP_KEY}" \ -d @- << EOF { "data": [ { "id": "00000000-0000-0000-0000-000000000001", "type": "identity_providers" } ] } EOF