> This page is for API Reference.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://contentful-staging.ferndocs.com/developers/docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://contentful-staging.ferndocs.com/developers/docs/_mcp/server.

# Create a new data assembly

POST https://api.contentful.com/spaces/{spaceId}/environments/{environmentId}/data_assemblies
Content-Type: application/json

Reference: https://contentful-staging.ferndocs.com/developers/docs/references/experiences-management-api/data-assemblies/create-data-assembly

## Authentication

- `Authorization` header (bearer token, required) — Contentful Management API token

## Request

### Path parameters

- `spaceId` (string, required)
- `environmentId` (string, required)

### Query parameters

- `access_token` (string, optional)

### Body (application/json)

This endpoint expects an object.

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostRequestBodyContentApplicationJsonSchemaSys, required)
- `metadata` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostRequestBodyContentApplicationJsonSchemaMetadata, required)
- `name` (string, required)
- `description` (string, required)
- `parameters` (map from string to SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostRequestBodyContentApplicationJsonSchemaParameters, required)
- `resolvers` (map from string to SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostRequestBodyContentApplicationJsonSchemaResolvers, required)
- `return` (delete__spaces__spaceId__environments__environmentId__data_assemblies__dataAssemblyId__published_10_200___schema2, required)

## Response

### 201

201

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaSys, required)
- `metadata` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaMetadata, required)
- `name` (string, required)
- `description` (string, required)
- `parameters` (map from string to SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaParameters, required)
- `resolvers` (map from string to SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaResolvers, required)
- `return` (delete__spaces__spaceId__environments__environmentId__data_assemblies__dataAssemblyId__published_10_200___schema2, required)

## Errors

### 400 Bad Request Error

400

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)
- `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaI18NContext, optional)

### 401 Unauthorized Error

401

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)
- `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaI18NContext, optional)

### 403 Forbidden Error

403

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)
- `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaI18NContext, optional)

### 404 Not Found Error

404

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)
- `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaI18NContext, optional)

### 409 Conflict Error

409

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)
- `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaI18NContext, optional)

### 422 Unprocessable Entity Error

422

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)
- `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaI18NContext, optional)

### 500 Internal Server Error

500

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)
- `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaI18NContext, optional)

## Types

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostRequestBodyContentApplicationJsonSchemaSys

- `type` ("DataAssembly", required)
- `dataType` (list of SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostRequestBodyContentApplicationJsonSchemaSysDataTypeItems, required)
- `variant` (string, optional)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostRequestBodyContentApplicationJsonSchemaMetadata

- `tags` (list of SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostRequestBodyContentApplicationJsonSchemaMetadataTagsItems, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostRequestBodyContentApplicationJsonSchemaParameters

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostRequestBodyContentApplicationJsonSchemaResolvers

### delete__spaces__spaceId__environments__environmentId__data_assemblies__dataAssemblyId__published_10_200___schema2

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaSys

- `id` (string, required)
- `type` ("Error", required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaMetadata

- `tags` (list of SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaMetadataTagsItems, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaParameters

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaResolvers

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaI18NContext

- `code` (string, required)
- `pluralCount` (double, optional)
- `parameters` (map from string to SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaI18NContextParameters, optional)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostRequestBodyContentApplicationJsonSchemaSysDataTypeItems

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostRequestBodyContentApplicationJsonSchemaMetadataTagsItems

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostRequestBodyContentApplicationJsonSchemaMetadataTagsItemsSys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostRequestBodyContentApplicationJsonSchemaParameters0

- `type` ("Link", required)
- `linkType` (string, required)
- `allowedContentTypes` (list of string, required)
- `name` (string, optional)
- `description` (string, optional)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostRequestBodyContentApplicationJsonSchemaParameters1

- `type` ("ResourceLink", required)
- `linkType` (string, required)
- `allowedResources` (list of SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostRequestBodyContentApplicationJsonSchemaParametersOneOf1AllowedResourcesItems, required)
- `name` (string, optional)
- `description` (string, optional)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostRequestBodyContentApplicationJsonSchemaResolvers0

- `source` ("Contentful:GraphQL", required)
- `query` (string, required)
- `parameters` (delete__spaces__spaceId__environments__environmentId__data_assemblies__dataAssemblyId__published_10_200___schema2, optional)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostRequestBodyContentApplicationJsonSchemaResolvers1

- `source` ("Contentful:DataAssembly", required)
- `dataAssembly` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostRequestBodyContentApplicationJsonSchemaResolversOneOf1DataAssembly, required)
- `parameters` (delete__spaces__spaceId__environments__environmentId__data_assemblies__dataAssemblyId__published_10_200___schema2, optional)

### DeleteSpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublished10200Schema21

- `$from` (DeleteSpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublished10200Schema2OneOf1From, required)

### DeleteSpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublished10200Schema22

- `$literal` (DeleteSpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublished10200Schema2OneOf2Literal, required, nullable)

### DeleteSpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublished10200Schema23

- `$object` (map from string to delete__spaces__spaceId__environments__environmentId__data_assemblies__dataAssemblyId__published_10_200___schema2, required)

### DeleteSpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublished10200Schema24

- `$on` (DeleteSpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublished10200Schema2OneOf4On, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaMetadataTagsItems

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaMetadataTagsItemsSys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaParameters0

- `type` ("Link", required)
- `linkType` (string, required)
- `allowedContentTypes` (list of string, required)
- `name` (string, optional)
- `description` (string, optional)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaParameters1

- `type` ("ResourceLink", required)
- `linkType` (string, required)
- `allowedResources` (list of SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaParametersOneOf1AllowedResourcesItems, required)
- `name` (string, optional)
- `description` (string, optional)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaResolvers0

- `source` ("Contentful:GraphQL", required)
- `query` (string, required)
- `parameters` (delete__spaces__spaceId__environments__environmentId__data_assemblies__dataAssemblyId__published_10_200___schema2, optional)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaResolvers1

- `source` ("Contentful:DataAssembly", required)
- `dataAssembly` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaResolversOneOf1DataAssembly, required)
- `parameters` (delete__spaces__spaceId__environments__environmentId__data_assemblies__dataAssemblyId__published_10_200___schema2, optional)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaI18NContextParameters

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostRequestBodyContentApplicationJsonSchemaSysDataTypeItems1

- `id` (string, required)
- `name` (string, required)
- `type` (string, required)
- `required` (boolean, optional)
- `source` (string, optional)
- `ref` (any, optional)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostRequestBodyContentApplicationJsonSchemaMetadataTagsItemsSys

- `type` ("Link", required)
- `linkType` (string, required)
- `id` (string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostRequestBodyContentApplicationJsonSchemaParametersOneOf1AllowedResourcesItems

- `type` (string, required)
- `source` (string, required)
- `allowedTypes` (list of string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostRequestBodyContentApplicationJsonSchemaResolversOneOf1DataAssembly

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostRequestBodyContentApplicationJsonSchemaResolversOneOf1DataAssemblySys, required)

### DeleteSpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublished10200Schema2OneOf1From

### DeleteSpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublished10200Schema2OneOf2Literal

### DeleteSpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublished10200Schema2OneOf4On

- `type` (map from string to delete__spaces__spaceId__environments__environmentId__data_assemblies__dataAssemblyId__published_10_200___schema2, required)
- `default` (delete__spaces__spaceId__environments__environmentId__data_assemblies__dataAssemblyId__published_10_200___schema2, optional)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaMetadataTagsItemsSys

- `type` ("Link", required)
- `linkType` (string, required)
- `id` (string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaParametersOneOf1AllowedResourcesItems

- `type` (string, required)
- `source` (string, required)
- `allowedTypes` (list of string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaResolversOneOf1DataAssembly

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaResolversOneOf1DataAssemblySys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaI18NContextParameters0

- `type` ("string", required)
- `value` (string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaI18NContextParameters1

- `type` ("number", required)
- `value` (double, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaI18NContextParameters2

- `type` ("date", required)
- `value` (string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaI18NContextParameters3

- `type` ("array.string", required)
- `value` (list of string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaI18NContextParameters4

- `type` ("array.number", required)
- `value` (list of double, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostRequestBodyContentApplicationJsonSchemaResolversOneOf1DataAssemblySys

- `type` ("ResourceLink", required)
- `linkType` ("Contentful:DataAssembly", required)
- `urn` (string, required)

### DeleteSpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublished10200Schema2OneOf1From1

- `source` (string, required)
- `select` (delete__spaces__spaceId__environments__environmentId__data_assemblies__dataAssemblyId__published_10_200___schema2, optional)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesPostResponsesContentApplicationJsonSchemaResolversOneOf1DataAssemblySys

- `type` ("ResourceLink", required)
- `linkType` ("Contentful:DataAssembly", required)
- `urn` (string, required)

## Examples

**Request**

```json
{
  "sys": {
    "type": "string",
    "dataType": [
      {
        "name": "string",
        "type": "String",
        "id": "string"
      }
    ]
  },
  "metadata": {
    "tags": [
      {
        "sys": {
          "type": "string",
          "linkType": "string",
          "id": "string"
        }
      }
    ]
  },
  "name": "string",
  "description": "string",
  "parameters": {},
  "resolvers": {},
  "return": {
    "$literal": {}
  }
}
```

**Response**

```json
{
  "sys": {
    "id": "string",
    "type": "string",
    "dataType": [
      {
        "name": "string",
        "required": true,
        "type": "String",
        "id": "string"
      }
    ],
    "version": 1.1,
    "space": {
      "sys": {
        "type": "string",
        "linkType": "string",
        "id": "string"
      }
    },
    "environment": {
      "sys": {
        "type": "string",
        "linkType": "string",
        "id": "string"
      }
    },
    "createdBy": {
      "sys": {
        "type": "string",
        "linkType": "string",
        "id": "string"
      }
    },
    "updatedBy": {
      "sys": {
        "type": "string",
        "linkType": "string",
        "id": "string"
      }
    },
    "publishedVersion": 1.1,
    "publishedCounter": 1.1,
    "publishedBy": {
      "sys": {
        "type": "string",
        "linkType": "string",
        "id": "string"
      }
    },
    "variant": "string"
  },
  "metadata": {
    "tags": [
      {
        "sys": {
          "type": "string",
          "linkType": "string",
          "id": "string"
        }
      }
    ]
  },
  "name": "string",
  "description": "string",
  "parameters": {},
  "resolvers": {},
  "return": {
    "$literal": {}
  }
}
```