Update an AI provider | Documentation

curl -X PATCH https://api.contentful.com/organizations/0D9ZC8rLWiw6x5qizZGiRs/ai/providers/3aab1ce0-442c-42eb-b1e4-c17d9206189a \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json-patch+json" \
     -d '[
  {
    "op": "replace",
    "path": "/credentials",
    "value": {
      "apiKey": "a-new-gemini-api-key"
    }
  }
]'

{
  "selectedModels": [
    {
      "id": "gemini-2.0-flash-exp",
      "name": "Gemini 2.0 Flash"
    },
    {
      "id": "gemini-1.5-pro",
      "name": "Gemini 1.5 Pro"
    }
  ],
  "sys": {
    "createdAt": "2025-11-16T10:30:00Z",
    "createdBy": {
      "sys": {
        "id": "1xGZIRXr2WPnsLkKfREo0z",
        "linkType": "User",
        "type": "Link"
      }
    },
    "id": "3aab1ce0-442c-42eb-b1e4-c17d9206189a",
    "organization": {
      "sys": {
        "id": "0D9ZC8rLWiw6x5qizZGiRs",
        "linkType": "Organization",
        "type": "Link"
      }
    },
    "updatedAt": "2025-11-17T14:45:00Z",
    "updatedBy": {
      "sys": {
        "id": "1xGZIRXr2WPnsLkKfREo0z",
        "linkType": "User",
        "type": "Link"
      }
    },
    "verifiedAt": "2025-11-16T10:30:01Z"
  },
  "type": "google-gemini"
}

Use this endpoint to update a specific AI provider using JSON Patch format. This is useful for updating credentials, configuration, or selected models without replacing the entire provider configuration.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

organization_idstringRequired

ID of the organization

provider_idstringRequired

ID of the AI provider

Request

This endpoint expects a map from strings to any.

Response headers

Content-TypestringOptional

Content-Type

Response

OK - Request successful