---
title: Update a ChatGPT Enterprise integration account
description: Update a ChatGPT Enterprise integration account. Only the fields provided are changed.
breadcrumbs: Docs > API > Update a ChatGPT Enterprise integration account
---

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

# Update a ChatGPT Enterprise integration account

## v2 (latest)

{% alert level="warning" %}
**Note**: This endpoint is in Preview and is subject to change.
If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help.md).
{% /alert %}

| Datadog site      | API endpoint                                                                                               |
| ----------------- | ---------------------------------------------------------------------------------------------------------- |
| app.datadoghq.com | PATCH https://api.datadoghq.com/api/v2/integration-interfaces/chatgpt-enterprise/accounts/{account_id}     |
| us3.datadoghq.com | PATCH https://api.us3.datadoghq.com/api/v2/integration-interfaces/chatgpt-enterprise/accounts/{account_id} |
| us5.datadoghq.com | PATCH https://api.us5.datadoghq.com/api/v2/integration-interfaces/chatgpt-enterprise/accounts/{account_id} |
| app.datadoghq.eu  | PATCH https://api.datadoghq.eu/api/v2/integration-interfaces/chatgpt-enterprise/accounts/{account_id}      |
| ap1.datadoghq.com | PATCH https://api.ap1.datadoghq.com/api/v2/integration-interfaces/chatgpt-enterprise/accounts/{account_id} |
| ap2.datadoghq.com | PATCH https://api.ap2.datadoghq.com/api/v2/integration-interfaces/chatgpt-enterprise/accounts/{account_id} |
| uk1.datadoghq.com | PATCH https://api.uk1.datadoghq.com/api/v2/integration-interfaces/chatgpt-enterprise/accounts/{account_id} |
| app.ddog-gov.com  | PATCH https://api.ddog-gov.com/api/v2/integration-interfaces/chatgpt-enterprise/accounts/{account_id}      |
| us2.ddog-gov.com  | PATCH https://api.us2.ddog-gov.com/api/v2/integration-interfaces/chatgpt-enterprise/accounts/{account_id}  |

### Overview

Update a ChatGPT Enterprise integration account. Only the fields provided are changed.

This endpoint requires the `manage_integrations` permission.

### Arguments

#### Path Parameters

| Field                   | Type   | Description                                   |
| ----------------------- | ------ | --------------------------------------------- |
| account_id [*required*] | string | Unique identifier of the integration account. |

### Request

#### Body Data (required)

{% tabs %}
{% tab label="Model" %}
| Parent field                       | Field                              | Type    | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| ---------------------------------- | ---------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|                                    | data [*required*]                  | object  | Data envelope for updating a ChatGPT Enterprise integration account.                                                                                                                                                                                                                                                                                                                                                                                                                     |
| data                               | attributes [*required*]            | object  | Writable attributes used to update a ChatGPT Enterprise integration account. Every field is optional. Only the provided fields are changed. When `dataflows` is provided, only the dataflow IDs in the request are modified. Dataflows omitted from the map keep their current configuration.                                                                                                                                                                                            |
| attributes                         | authentication                     | <oneOf> | Authentication for updating the ChatGPT Enterprise integration account. Exactly one method is set.                                                                                                                                                                                                                                                                                                                                                                                       |
| authentication                     | <auth_type=bearer_token>           | object  | Bearer token authentication. Use an admin key with the **Costs** permission set to **Read**. Create the key in the OpenAI Admin Console of your ChatGPT Enterprise workspace, not in the API Platform admin-key console. Only the provided fields are changed. To keep the stored token, omit `token`.                                                                                                                                                                                   |
| <auth_type=bearer_token>           | auth_type [*required*]             | enum    | The authentication method type. Allowed enum values: `bearer_token`. Default: `bearer_token`.                                                                                                                                                                                                                                                                                                                                                                                            |
| <auth_type=bearer_token>           | token                              | string  | Secret token used to authenticate with ChatGPT Enterprise.                                                                                                                                                                                                                                                                                                                                                                                                                               |
| attributes                         | dataflows                          | object  | Data Datadog collects from ChatGPT Enterprise, keyed by dataflow ID. Each dataflow turns on a distinct type of collection. Set `enabled` to start or stop a dataflow. The default for each dataflow applies when the account is created. On update, omitted fields keep their current values. Every dataflow requires a ChatGPT Enterprise workspace with access to the OpenAI Costs API. If you enable a dataflow without this access, Datadog stores the setting but collects no data. |
| dataflows                          | chatgpt-enterprise-agent-console   | object  | Activity, token consumption, credits, and estimated usage costs across ChatGPT Chat, ChatGPT Work, and Codex, shown in Agent Console with breakdowns by product, model, and user where OpenAI provides them. Data already available from OpenAI appears within 1 hour after you enable this dataflow.                                                                                                                                                                                    |
| chatgpt-enterprise-agent-console   | enabled [*required*]               | boolean | Whether Datadog collects this data. Defaults to `true`. Set to `false` to stop collection.                                                                                                                                                                                                                                                                                                                                                                                               |
| dataflows                          | chatgpt-enterprise-cloud-cost-data | object  | ChatGPT Enterprise costs from the OpenAI Costs API, which you can analyze in [Cloud Cost Management](https://docs.datadoghq.com/cloud_cost_management.md). These costs are excluded from Cloud Cost Management spend-monitored billing. Reported costs are estimates, not final invoice amounts.                                                                                                                                                                                         |
| chatgpt-enterprise-cloud-cost-data | enabled                            | boolean | Whether Datadog collects this data. Defaults to `false`. Set to `true` to start collection.                                                                                                                                                                                                                                                                                                                                                                                              |
| attributes                         | name                               | string  | Human-readable name of the ChatGPT Enterprise integration account.                                                                                                                                                                                                                                                                                                                                                                                                                       |
| attributes                         | settings                           | object  | Settings for updating the ChatGPT Enterprise integration account. Only the fields provided are changed.                                                                                                                                                                                                                                                                                                                                                                                  |
| settings                           | openai_org_id                      | string  | OpenAI API Platform organization ID (`org-...`) that the Costs API uses for your Enterprise usage. This is not the ChatGPT workspace UUID or your Datadog organization ID. A value that does not match `^org-[A-Za-z0-9]+$` is rejected with a `422` response.                                                                                                                                                                                                                           |
| data                               | id [*required*]                    | string  | Unique identifier of the ChatGPT Enterprise integration account to update.                                                                                                                                                                                                                                                                                                                                                                                                               |
| data                               | type [*required*]                  | enum    | The type of the integration account resource. Always `integration-account`. Allowed enum values: `integration-account`. Default: `integration-account`.                                                                                                                                                                                                                                                                                                                                  |
{% /tab %}

{% tab label="Example" %}
```json
{
  "data": {
    "attributes": {
      "authentication": {
        "auth_type": "bearer_token",
        "token": "your-token"
      },
      "dataflows": {
        "chatgpt-enterprise-agent-console": {
          "enabled": true
        },
        "chatgpt-enterprise-cloud-cost-data": {
          "enabled": true
        }
      },
      "name": "chatgpt-enterprise-acme",
      "settings": {
        "openai_org_id": "org-AbC123dEf456"
      }
    },
    "id": "3e8a1f6b-9c2d-4b7e-8a5f-6d1c4e9b2a03",
    "type": "integration-account"
  }
}
```
{% /tab %}
{% /tabs %}

### Response

{% tabs %}
{% tab label="200" %}
OK

{% tabs %}
{% tab label="Model" %}
Response payload for a single ChatGPT Enterprise integration account.

| Parent field                       | Field                              | Type      | Description                                                                                                                                                                                                                                                                                      |
| ---------------------------------- | ---------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|                                    | data [*required*]                  | object    | Data envelope of a ChatGPT Enterprise integration account, including server-assigned identity.                                                                                                                                                                                                   |
| data                               | attributes [*required*]            | object    | Attributes of a ChatGPT Enterprise integration account returned in responses.                                                                                                                                                                                                                    |
| attributes                         | authentication                     | <oneOf>   | Authentication configured on the ChatGPT Enterprise integration account.                                                                                                                                                                                                                         |
| authentication                     | <auth_type=bearer_token>           | object    | The bearer token authentication method configured on the account.                                                                                                                                                                                                                                |
| <auth_type=bearer_token>           | auth_type [*required*]             | enum      | The authentication method type. Allowed enum values: `bearer_token`. Default: `bearer_token`.                                                                                                                                                                                                    |
| attributes                         | dataflows                          | object    | Data Datadog collects from ChatGPT Enterprise, keyed by dataflow ID.                                                                                                                                                                                                                             |
| dataflows                          | chatgpt-enterprise-agent-console   | object    | Activity, token consumption, credits, and estimated usage costs across ChatGPT Chat, ChatGPT Work, and Codex, shown in Agent Console with breakdowns by product, model, and user where OpenAI provides them.                                                                                     |
| chatgpt-enterprise-agent-console   | enabled                            | boolean   | Whether Datadog collects this data.                                                                                                                                                                                                                                                              |
| chatgpt-enterprise-agent-console   | status                             | object    | Read-only collection status of a dataflow. Read-only.                                                                                                                                                                                                                                            |
| status                             | health                             | enum      | Collection health of a single dataflow. Allowed enum values: `DATAFLOW_HEALTH_OK`, `DATAFLOW_HEALTH_BROKEN`, `DATAFLOW_HEALTH_UNKNOWN`.                                                                                                                                                          |
| status                             | message                            | string    | Human-readable detail, populated when the dataflow is not healthy.                                                                                                                                                                                                                               |
| status                             | updated_at                         | date-time | Time the status was last computed.                                                                                                                                                                                                                                                               |
| dataflows                          | chatgpt-enterprise-cloud-cost-data | object    | ChatGPT Enterprise costs from the OpenAI Costs API, which you can analyze in [Cloud Cost Management](https://docs.datadoghq.com/cloud_cost_management.md). These costs are excluded from Cloud Cost Management spend-monitored billing. Reported costs are estimates, not final invoice amounts. |
| chatgpt-enterprise-cloud-cost-data | enabled                            | boolean   | Whether Datadog collects this data.                                                                                                                                                                                                                                                              |
| chatgpt-enterprise-cloud-cost-data | status                             | object    | Read-only collection status of a dataflow. Read-only.                                                                                                                                                                                                                                            |
| status                             | health                             | enum      | Collection health of a single dataflow. Allowed enum values: `DATAFLOW_HEALTH_OK`, `DATAFLOW_HEALTH_BROKEN`, `DATAFLOW_HEALTH_UNKNOWN`.                                                                                                                                                          |
| status                             | message                            | string    | Human-readable detail, populated when the dataflow is not healthy.                                                                                                                                                                                                                               |
| status                             | updated_at                         | date-time | Time the status was last computed.                                                                                                                                                                                                                                                               |
| attributes                         | name [*required*]                  | string    | Human-readable name of the ChatGPT Enterprise integration account.                                                                                                                                                                                                                               |
| attributes                         | settings [*required*]              | object    | Settings configured on the ChatGPT Enterprise integration account.                                                                                                                                                                                                                               |
| settings                           | openai_org_id [*required*]         | string    | OpenAI API Platform organization ID (`org-...`) that the Costs API uses for your Enterprise usage. This is not the ChatGPT workspace UUID or your Datadog organization ID. A value that does not match `^org-[A-Za-z0-9]+$` is rejected with a `422` response.                                   |
| data                               | id [*required*]                    | string    | Server-generated unique identifier of the ChatGPT Enterprise integration account. Read-only.                                                                                                                                                                                                     |
| data                               | type [*required*]                  | enum      | The type of the integration account resource. Always `integration-account`. Allowed enum values: `integration-account`. Default: `integration-account`.                                                                                                                                          |
{% /tab %}

{% tab label="Example" %}
```json
{
  "data": {
    "attributes": {
      "authentication": {
        "auth_type": "bearer_token"
      },
      "dataflows": {
        "chatgpt-enterprise-agent-console": {
          "enabled": true,
          "status": {
            "health": "DATAFLOW_HEALTH_OK",
            "message": "",
            "updated_at": "2026-06-25T08:30:50Z"
          }
        },
        "chatgpt-enterprise-cloud-cost-data": {
          "enabled": true,
          "status": {
            "health": "DATAFLOW_HEALTH_OK",
            "message": "",
            "updated_at": "2026-06-25T08:30:50Z"
          }
        }
      },
      "name": "chatgpt-enterprise-acme",
      "settings": {
        "openai_org_id": "org-AbC123dEf456"
      }
    },
    "id": "3e8a1f6b-9c2d-4b7e-8a5f-6d1c4e9b2a03",
    "type": "integration-account"
  }
}
```
{% /tab %}
{% /tabs %}
{% /tab %}

{% tab label="400" %}
Bad Request

{% tabs %}
{% tab label="Model" %}
API error response.

| Parent field | Field               | Type     | Description                                                                     |
| ------------ | ------------------- | -------- | ------------------------------------------------------------------------------- |
|              | errors [*required*] | [object] | A list of errors.                                                               |
| errors       | code                | string   | An application-specific error code.                                             |
| errors       | detail              | string   | A human-readable explanation specific to this occurrence of the error.          |
| errors       | meta                | object   | Non-standard meta-information about the error                                   |
| errors       | source              | object   | References to the source of the error.                                          |
| source       | header              | string   | A string indicating the name of a single request header which caused the error. |
| source       | parameter           | string   | A string indicating which URI query parameter caused the error.                 |
| source       | pointer             | string   | A JSON pointer to the value in the request document that caused the error.      |
| errors       | status              | string   | Status code of the response.                                                    |
| errors       | title               | string   | Short human-readable summary of the error.                                      |
{% /tab %}

{% tab label="Example" %}
```json
{
  "errors": [
    {
      "code": "invalid_request",
      "detail": "Missing required attribute in body",
      "meta": {},
      "source": {
        "header": "Authorization",
        "parameter": "limit",
        "pointer": "/data/attributes/title"
      },
      "status": "400",
      "title": "Bad Request"
    }
  ]
}
```
{% /tab %}
{% /tabs %}
{% /tab %}

{% tab label="403" %}
Forbidden

{% tabs %}
{% tab label="Model" %}
API error response.

| Field               | Type     | Description       |
| ------------------- | -------- | ----------------- |
| errors [*required*] | [string] | A list of errors. |
{% /tab %}

{% tab label="Example" %}
```json
{
  "errors": [
    "Bad Request"
  ]
}
```
{% /tab %}
{% /tabs %}
{% /tab %}

{% tab label="404" %}
Not Found

{% tabs %}
{% tab label="Model" %}
API error response.

| Parent field | Field               | Type     | Description                                                                     |
| ------------ | ------------------- | -------- | ------------------------------------------------------------------------------- |
|              | errors [*required*] | [object] | A list of errors.                                                               |
| errors       | code                | string   | An application-specific error code.                                             |
| errors       | detail              | string   | A human-readable explanation specific to this occurrence of the error.          |
| errors       | meta                | object   | Non-standard meta-information about the error                                   |
| errors       | source              | object   | References to the source of the error.                                          |
| source       | header              | string   | A string indicating the name of a single request header which caused the error. |
| source       | parameter           | string   | A string indicating which URI query parameter caused the error.                 |
| source       | pointer             | string   | A JSON pointer to the value in the request document that caused the error.      |
| errors       | status              | string   | Status code of the response.                                                    |
| errors       | title               | string   | Short human-readable summary of the error.                                      |
{% /tab %}

{% tab label="Example" %}
```json
{
  "errors": [
    {
      "code": "invalid_request",
      "detail": "Missing required attribute in body",
      "meta": {},
      "source": {
        "header": "Authorization",
        "parameter": "limit",
        "pointer": "/data/attributes/title"
      },
      "status": "400",
      "title": "Bad Request"
    }
  ]
}
```
{% /tab %}
{% /tabs %}
{% /tab %}

{% tab label="422" %}
The server cannot process the request because it contains invalid data.

{% tabs %}
{% tab label="Model" %}
API error response.

| Parent field | Field               | Type     | Description                                                                     |
| ------------ | ------------------- | -------- | ------------------------------------------------------------------------------- |
|              | errors [*required*] | [object] | A list of errors.                                                               |
| errors       | code                | string   | An application-specific error code.                                             |
| errors       | detail              | string   | A human-readable explanation specific to this occurrence of the error.          |
| errors       | meta                | object   | Non-standard meta-information about the error                                   |
| errors       | source              | object   | References to the source of the error.                                          |
| source       | header              | string   | A string indicating the name of a single request header which caused the error. |
| source       | parameter           | string   | A string indicating which URI query parameter caused the error.                 |
| source       | pointer             | string   | A JSON pointer to the value in the request document that caused the error.      |
| errors       | status              | string   | Status code of the response.                                                    |
| errors       | title               | string   | Short human-readable summary of the error.                                      |
{% /tab %}

{% tab label="Example" %}
```json
{
  "errors": [
    {
      "code": "invalid_request",
      "detail": "Missing required attribute in body",
      "meta": {},
      "source": {
        "header": "Authorization",
        "parameter": "limit",
        "pointer": "/data/attributes/title"
      },
      "status": "400",
      "title": "Bad Request"
    }
  ]
}
```
{% /tab %}
{% /tabs %}
{% /tab %}

{% tab label="429" %}
Too many requests

{% tabs %}
{% tab label="Model" %}
API error response.

| Field               | Type     | Description       |
| ------------------- | -------- | ----------------- |
| errors [*required*] | [string] | A list of errors. |
{% /tab %}

{% tab label="Example" %}
```json
{
  "errors": [
    "Bad Request"
  ]
}
```
{% /tab %}
{% /tabs %}
{% /tab %}
{% /tabs %}

### Code Example

{% tabs %}
{% tab label="Curl" %}
```bash
# Path parameters
export account_id="CHANGE_ME"

# Set your Datadog site and credentials
export DD_SITE="datadoghq.com" # Or us3.datadoghq.com, us5.datadoghq.com, datadoghq.eu, ap1.datadoghq.com, ap2.datadoghq.com, uk1.datadoghq.com, ddog-gov.com, us2.ddog-gov.com
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X PATCH "https://api.${DD_SITE}/api/v2/integration-interfaces/chatgpt-enterprise/accounts/${account_id}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "authentication": {
        "auth_type": "bearer_token",
        "token": "your-token"
      },
      "dataflows": {
        "chatgpt-enterprise-agent-console": {
          "enabled": true
        },
        "chatgpt-enterprise-cloud-cost-data": {
          "enabled": true
        }
      },
      "name": "chatgpt-enterprise-acme",
      "settings": {
        "openai_org_id": "org-AbC123dEf456"
      }
    },
    "id": "3e8a1f6b-9c2d-4b7e-8a5f-6d1c4e9b2a03",
    "type": "integration-account"
  }
}
EOF
```
{% /tab %}
{% /tabs %}
