Create a concept scheme | Documentation

curl -X POST https://api.contentful.com/organizations/0D9ZC8rLWiw6x5qizZGiRs/taxonomy/concept-schemes \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/vnd.contentful.management.v1+json" \
     -d '{
  "uri": "",
  "prefLabel": {
    "en-US": "Home Products"
  },
  "definition": {
    "en-US": ""
  },
  "topConcepts": [
    {
      "sys": {
        "id": "1Py5SjffQHkGGY3dZ02W14"
      }
    }
  ],
  "concepts": [
    {
      "sys": {
        "id": "1Py5SjffQHkGGY3dZ02W14"
      }
    }
  ]
}'

{
  "sys": {
    "id": "2s0F7127ajju1AVToMaCtE",
    "type": "TaxonomyConceptScheme",
    "organization": {
      "sys": {
        "id": "0D9ZC8rLWiw6x5qizZGiRs",
        "type": "Link",
        "linkType": "Organization"
      }
    },
    "createdAt": "2025-02-28T13:16:34.000Z",
    "createdBy": {
      "sys": {
        "type": "Link",
        "linkType": "User",
        "id": "7BslKh9TdKGOK41VmLDjFZ"
      }
    },
    "updatedAt": "2025-02-28T13:16:34.000Z",
    "updatedBy": {
      "sys": {
        "type": "Link",
        "linkType": "User",
        "id": "4FLrUHftHW3v2BLi9fzfjU"
      }
    },
    "version": 0
  },
  "uri": "",
  "prefLabel": {
    "en-US": "Home Products"
  },
  "definition": {
    "en-US": ""
  },
  "topConcepts": [
    {
      "sys": {
        "id": "1Py5SjffQHkGGY3dZ02W14",
        "type": "Link",
        "linkType": "TaxonomyConcept"
      }
    }
  ],
  "concepts": [
    {
      "sys": {
        "id": "1Py5SjffQHkGGY3dZ02W14",
        "type": "Link",
        "linkType": "TaxonomyConcept"
      }
    }
  ],
  "totalConcepts": 1
}

Authentication

AuthorizationBearer

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

Path parameters

organization_idstringRequired

The 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