---
title: "Update a Nebius Cloud integration account"
method: PATCH
path: "/api/v2/integration-interfaces/nebius-cloud/accounts/{account_id}"
tags: ["Nebius Cloud Integration"]
---

# Update a Nebius Cloud integration account

`PATCH /api/v2/integration-interfaces/nebius-cloud/accounts/{account_id}`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/integration-interfaces/nebius-cloud/accounts/{account_id}`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token`

Update a Nebius Cloud integration account. Only the fields provided are changed.

## Path parameters

- `account_id` string, required

## Request body

- NebiusCloudIntegrationAccountUpdateRequest: Request payload to update a Nebius Cloud integration account.
  - `data` NebiusCloudIntegrationAccountUpdateData, required: Data envelope for updating a Nebius Cloud integration account.
    - `attributes` NebiusCloudIntegrationAccountUpdateAttributes, required: Writable attributes used to update a Nebius Cloud integration account. Every field is optional; only the fields provided are changed. When `dataflows` is provided, only the dataflow ids included in the request are modified; dataflows omitted from the map keep their current configuration, as do the settings of an included dataflow that provides only `enabled`.
      - `authentication` NebiusCloudIntegrationAccountAuthenticationUpdate: Service-account key pair authentication, the only method Nebius Cloud integration accounts support. Only the fields provided are changed; omit `private_key` and `static_api_key` to keep the stored ones.
        - `auth_type` 'nebius_service_account', required: The authentication method type.
        - `private_key` string: The private key of the authorized key pair, in PEM format. Omit it to keep the stored one; an empty string is rejected with a `422` response.
        - `public_key_id` string, nullable: ID of the public key half of the authorized key pair. Omit it to keep the stored public key ID, send `null` or an empty string to remove it, or send a value to replace it. Removing it is rejected with a `422` response while log, resource, or service-quota collection is enabled.
        - `service_account_id` string: Non-secret ID of the Nebius service account the account authenticates as. It cannot be cleared; sending `null` or an empty string is rejected with a `422` response.
        - `static_api_key` string: Nebius static API key with the OBSERVABILITY scope. Omit it to keep the stored one; an empty string is rejected with a `422` response.
      - `dataflows` NebiusCloudIntegrationDataflowsRequest: Data Datadog collects from Nebius Cloud, keyed by dataflow id. Each dataflow turns on a distinct kind of collection: set `enabled` to stop or start it, and use `settings` to configure what it collects. Defaults listed on each dataflow apply when the account is created; on update, omitted fields keep their current values. Every dataflow except `nebius-cloud-cost-collection` runs as the service account in `authentication`, using its authorized key pair and the static API key; enabling one of them without those keys is rejected with a `422` response, and one enabled with keys that later expire is stored but collects no data.
        - `nebius-cloud-cost-collection` NebiusCloudCostCollectionIntegrationDataflowRequest: Cloud cost data read from a Nebius Object Storage bucket export and used by [Cloud Cost Management](https://docs.datadoghq.com/cloud_cost_management/). Enabling it requires a bucket holding your cost export and a Nebius access key pair that can read it; a request that enables this dataflow without them is rejected with a `422` response.
          - `enabled` boolean: Whether Datadog collects this data. Defaults to `false`; set to `true` to start collection.
          - `settings` NebiusCloudCostCollectionIntegrationDataflowSettingsRequest: Settings of the Cloud Cost Management dataflow. Only the fields provided are changed.
            - `access_key_id` string: ID of the Nebius Object Storage (S3-compatible) access key used to read the cost export bucket. Required when this dataflow is enabled.
            - `access_key_secret` string: Secret access key for the access key ID. Required when this dataflow is enabled. Omit it on update to keep the stored one; an empty string is rejected with a `422` response.
            - `bucket_name` string: Name of the Nebius Object Storage bucket holding your cost export. Required when this dataflow is enabled; a request that enables it without the bucket fields and access keys is rejected with a `422` response.
            - `bucket_prefix_path` string: Prefix path within the bucket that locates the cost export, combining the export name and path prefix.
            - `bucket_region` string: Region of the Nebius Object Storage bucket, such as `eu-north1`. Required when this dataflow is enabled.
        - `nebius-cloud-logs` NebiusCloudLogsIntegrationDataflowRequest: Logs from your Nebius tenant: Kubernetes control plane and audit logs, tenant-level audit events, compute serial console logs, cloud apps and AI inference logs, PostgreSQL logs, and MLflow logs, collected from the services named in `settings.enabled_services`. `enabled_services` is the sole source of truth for what is collected; `enabled` set to `false` stops log collection, while `true` on its own changes nothing. Defaults to no services.
          - `enabled` boolean: Whether Datadog collects logs. Defaults to `false`. Set to `false` to stop log collection; sending `true` on its own changes nothing, because `settings.enabled_services` is the sole source of truth.
          - `settings` NebiusCloudLogsIntegrationDataflowSettingsRequest: Settings of the logs dataflow. Only the fields provided are changed.
            - `enabled_services` string[]: Nebius log integrations to collect. One of `nebius-cloud-compute`, `nebius-cloud-kubernetes`, `nebius-cloud-mlflow`, `nebius-cloud-postgresql`, `nebius-cloud-applications`, or `default` for the streams shared by every service. A non-empty list is the sole source of truth and replaces the stored list: those services are collected and any others stop. An empty list stops log collection entirely. Omit it to keep the stored list.
        - `nebius-cloud-resources` NebiusCloudResourcesIntegrationDataflowRequest: Metadata about resources in your Nebius tenant, such as compute instances and Kubernetes clusters.
          - `enabled` boolean: Whether Datadog collects this data. Defaults to enabled when `authentication.public_key_id` is set; set to `false` to stop collection.
        - `nebius-cloud-service-quota-collection` NebiusCloudServiceQuotaCollectionIntegrationDataflowRequest: Usage metrics tracked against your Nebius service quotas, such as `nebius_cloud.servicequota.percentage_used` and `nebius_cloud.servicequota.limit`.
          - `enabled` boolean: Whether Datadog collects this data. Defaults to `false`; set to `true` to start collection.
      - `name` string: Human-readable name of the Nebius Cloud integration account.
      - `settings` NebiusCloudIntegrationAccountSettingsUpdate: Settings for updating the Nebius Cloud integration account. Only the fields provided are changed.
        - `account_tags` string[]: Tags applied to all metrics, logs, and resources collected from this Nebius Cloud account. Sending it replaces the whole list; send an empty array to remove all tags, or omit it to keep the stored list.
        - `metrics_config` NebiusCloudIntegrationAccountMetricsConfigUpdate: Configuration for metric collection. Only the fields provided are changed.
          - `cluster_filters` string[]: Tag-filter rules limiting metric collection to matching Kubernetes clusters. Sending metrics_config replaces the stored object's cluster_filters list; omit it to keep the stored value. Include rules (`key:value`) are combined with OR, exclusion rules (`!key:value`) are then applied with AND, and `?` and `*` are wildcards.
        - `tenant_id` string: ID of the Nebius tenant to monitor. An empty value is ignored and the stored tenant ID is kept.
    - `id` string, required: Unique identifier of the Nebius Cloud integration account to update.
    - `type` 'integration-account', required: The type of the integration account resource. Always `integration-account`.

## Response `200`

OK

- NebiusCloudIntegrationAccountResponse: Response payload for a single Nebius Cloud integration account.
  - `data` NebiusCloudIntegrationAccountResponseData, required: Data envelope of a Nebius Cloud integration account, including server-assigned identity.
    - `attributes` NebiusCloudIntegrationAccountResponseAttributes, required: Attributes of a Nebius Cloud integration account returned in responses.
      - `authentication` NebiusCloudIntegrationAccountAuthenticationResponse: The service-account key pair authentication method configured on the account.
        - `auth_type` 'nebius_service_account', required: The authentication method type.
        - `public_key_id` string: ID of the public key half of the authorized key pair. Omitted when unset.
        - `service_account_id` string, required: ID of the Nebius service account the account authenticates as.
      - `dataflows` NebiusCloudIntegrationDataflowsResponse: Data Datadog collects from Nebius Cloud, keyed by dataflow id.
        - `nebius-cloud-cost-collection` NebiusCloudCostCollectionIntegrationDataflowResponse: Cloud cost data read from a Nebius Object Storage bucket export and used by [Cloud Cost Management](https://docs.datadoghq.com/cloud_cost_management/). Requires a bucket holding your cost export and a Nebius access key pair that can read it; without both this dataflow collects no data.
          - `enabled` boolean: Whether Datadog collects this data. Absent when the dataflow has never been configured.
          - `settings` NebiusCloudCostCollectionIntegrationDataflowSettingsResponse: Settings of the Cloud Cost Management dataflow.
            - `access_key_id` string: ID of the Nebius Object Storage access key used to read the cost export bucket.
            - `bucket_name` string: Name of the Nebius Object Storage bucket holding the cost export.
            - `bucket_prefix_path` string: Prefix path within the bucket that locates the cost export.
            - `bucket_region` string: Region of the Nebius Object Storage bucket, such as `eu-north1`.
        - `nebius-cloud-logs` NebiusCloudLogsIntegrationDataflowResponse: Logs from your Nebius tenant: Kubernetes control plane and audit logs, tenant-level audit events, compute serial console logs, cloud apps and AI inference logs, PostgreSQL logs, and MLflow logs, collected from the services named in `settings.enabled_services`.
          - `enabled` boolean: Whether Datadog collects logs. Absent when no service is enabled.
          - `settings` NebiusCloudLogsIntegrationDataflowSettingsResponse: Settings of the logs dataflow.
            - `enabled_services` string[]: Nebius log integrations collected, such as `nebius-cloud-compute` and `default`. Absent when no service is enabled.
        - `nebius-cloud-resources` NebiusCloudResourcesIntegrationDataflowResponse: Metadata about resources in your Nebius tenant, such as compute instances and Kubernetes clusters.
          - `enabled` boolean: Whether Datadog collects this data. Absent when the dataflow has never been configured, in which case collection runs when `authentication.public_key_id` is set.
        - `nebius-cloud-service-quota-collection` NebiusCloudServiceQuotaCollectionIntegrationDataflowResponse: Usage metrics tracked against your Nebius service quotas, such as `nebius_cloud.servicequota.percentage_used` and `nebius_cloud.servicequota.limit`.
          - `enabled` boolean: Whether Datadog collects this data. Absent when the dataflow has never been configured.
      - `name` string, required: Human-readable name of the Nebius Cloud integration account.
      - `settings` NebiusCloudIntegrationAccountSettingsResponse, required: Settings configured on the Nebius Cloud integration account.
        - `account_tags` string[]: Tags applied to all data collected from this Nebius Cloud account.
        - `metrics_config` NebiusCloudIntegrationAccountMetricsConfigResponse: Metric collection settings configured on the Nebius Cloud integration account. Absent or empty when no filters are configured.
          - `cluster_filters` string[]: Tag-filter rules limiting metric collection to matching Kubernetes clusters.
        - `tenant_id` string, required: ID of the Nebius tenant being monitored.
    - `id` string, required: Server-generated unique identifier of the Nebius Cloud integration account.
    - `type` 'integration-account', required: The type of the integration account resource. Always `integration-account`.

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `422`: The server cannot process the request because it contains invalid data.
- `429`: Too many requests

## Changes

- **2026-11-20** `3b1c63e31740`: 4 warning
  - the optional response header `X-RateLimit-Limit` removed for the status `429`
  - the optional response header `X-RateLimit-Period` removed for the status `429`
  - the optional response header `X-RateLimit-Remaining` removed for the status `429`
  - the optional response header `X-RateLimit-Reset` removed for the status `429`
- **2026-11-18** `ba1d12f79c75`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/changes/api/v2/integration-interfaces/nebius-cloud/accounts/:account_id/patch.md)

---

[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/4ba32926196d?raw)
