Create a search index | Documentation

curl -X POST https://api.contentful.com/organizations/0D9ZC8rLWiw6x5qizZGiRs/semantic/search-index \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/vnd.contentful.management.v1+json" \
     -d '{
  "spaceId": "mySpace",
  "locale": "en-US"
}'

{
  "sys": {
    "id": "abc123",
    "type": "ContentSemanticsIndex",
    "organization": {
      "sys": {
        "type": "Link",
        "linkType": "Organization",
        "id": "myOrg"
      }
    },
    "space": {
      "sys": {
        "type": "Link",
        "linkType": "Space",
        "id": "mySpace"
      }
    },
    "environment": {
      "sys": {
        "type": "Link",
        "linkType": "Environment",
        "id": "master"
      }
    },
    "locale": {
      "sys": {
        "type": "Link",
        "linkType": "Locale",
        "id": "locale123"
      }
    },
    "localeCode": "en-US",
    "createdBy": {
      "sys": {
        "type": "Link",
        "linkType": "User",
        "id": "user123"
      }
    },
    "status": "ACTIVE",
    "createdAt": "2025-08-21T13:41:54.274Z",
    "updatedAt": "2025-08-21T13:41:54.274Z"
  }
}

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 - Search index created successfully