Create an AI provider | Documentation

curl -X POST https://api.contentful.com/organizations/0D9ZC8rLWiw6x5qizZGiRs/ai/providers \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/vnd.contentful.management.v1+json" \
     -d '{
  "type": "aws_bedrock",
  "credentials": {
    "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
    "secretAccessKey": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
  },
  "config": {
    "region": "us-east-1"
  },
  "selectedModels": [
    {
      "id": "anthropic.claude-3-5-sonnet-20241022-v2:0",
      "name": "Claude 3.5 Sonnet v2"
    },
    {
      "id": "anthropic.claude-3-sonnet-20240229-v1:0",
      "name": "Claude 3 Sonnet"
    }
  ]
}'

{
  "type": "aws_bedrock",
  "config": {
    "region": "us-east-1"
  },
  "selectedModels": [
    {
      "id": "anthropic.claude-3-5-sonnet-20241022-v2:0",
      "name": "Claude 3.5 Sonnet v2"
    },
    {
      "id": "anthropic.claude-3-sonnet-20240229-v1:0",
      "name": "Claude 3 Sonnet"
    }
  ],
  "sys": {
    "id": "3aab1ce0-442c-42eb-b1e4-c17d9206189a",
    "organization": {
      "sys": {
        "id": "0D9ZC8rLWiw6x5qizZGiRs",
        "type": "Link",
        "linkType": "Organization"
      }
    },
    "createdAt": "2025-11-16T10:30:00Z",
    "updatedAt": "2025-11-17T14:45:00Z",
    "createdBy": {
      "sys": {
        "id": "1xGZIRXr2WPnsLkKfREo0z",
        "type": "Link",
        "linkType": "User"
      }
    },
    "updatedBy": {
      "sys": {
        "id": "1xGZIRXr2WPnsLkKfREo0z",
        "type": "Link",
        "linkType": "User"
      }
    },
    "verifiedAt": "2025-11-16T10:30:01Z"
  }
}

Use this endpoint to create a new AI Provider of a specified type for an organization.

Authentication

AuthorizationBearer

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

Path parameters

organization_idstringRequired

ID of the organization

Request

This endpoint expects a map from strings to any.

Response headers

Content-Typestring

Content-Type

Response

Created - Resource created successfully