---
title: "Update Okta account"
method: PATCH
path: "/api/v2/integrations/okta/accounts/{account_id}"
tags: ["Okta Integration"]
---

# Update Okta account

`PATCH /api/v2/integrations/okta/accounts/{account_id}`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/integrations/okta/accounts/{account_id}`
- Auth: API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`

Update an Okta account.

## Path parameters

- `account_id` string, required

## Request body

- OktaAccountUpdateRequest: Payload schema when updating an Okta account.
  - `data` OktaAccountUpdateRequestData, required: Data object for updating an Okta account.
    - `attributes` OktaAccountUpdateRequestAttributes: Attributes object for updating an Okta account.
      - `api_key` string: The API key of the Okta account.
      - `auth_method` string, required: The authorization method for an Okta account.
      - `client_id` string: The Client ID of an Okta app integration.
      - `client_secret` string: The client secret of an Okta app integration.
      - `domain` string, required: The domain associated with an Okta account.
    - `type` 'okta-accounts': Account type for an Okta account.

## Response `200`

OK

- OktaAccountResponse: Response object for an Okta account.
  - `data` OktaAccount: Schema for an Okta account.
    - `attributes` OktaAccountAttributes, required: Attributes object for an Okta account.
      - `api_key` string: The API key of the Okta account.
      - `auth_method` string, required: The authorization method for an Okta account.
      - `client_id` string: The Client ID of an Okta app integration.
      - `client_secret` string: The client secret of an Okta app integration.
      - `domain` string, required: The domain of the Okta account.
      - `name` string, required: The name of the Okta account.
    - `id` string: The ID of the Okta account, a UUID hash of the account name.
    - `type` 'okta-accounts', required: Account type for an Okta account.

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)