> 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.

# Update a data assembly by ID

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

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

## Authentication

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

## Request

### Path parameters

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

### Query parameters

- `access_token` (string, optional)

### Body (application/json)

This endpoint expects an object.

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutRequestBodyContentApplicationJsonSchemaSys, required)
- `metadata` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutRequestBodyContentApplicationJsonSchemaMetadata, required)
- `name` (string, required)
- `description` (string, required)
- `parameters` (map from string to SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutRequestBodyContentApplicationJsonSchemaParameters, required)
- `resolvers` (map from string to SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutRequestBodyContentApplicationJsonSchemaResolvers, required)
- `return` (delete__spaces__spaceId__environments__environmentId__data_assemblies__dataAssemblyId__published_10_200___schema2, required)

## Response

### 200

200

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaSys, required)
- `metadata` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaMetadata, required)
- `name` (string, required)
- `description` (string, required)
- `parameters` (map from string to SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaParameters, required)
- `resolvers` (map from string to SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaResolvers, required)
- `return` (delete__spaces__spaceId__environments__environmentId__data_assemblies__dataAssemblyId__published_10_200___schema2, required)

### 201

201

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaSys, required)
- `metadata` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaMetadata, required)
- `name` (string, required)
- `description` (string, required)
- `parameters` (map from string to SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaParameters, required)
- `resolvers` (map from string to SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaResolvers, required)
- `return` (delete__spaces__spaceId__environments__environmentId__data_assemblies__dataAssemblyId__published_10_200___schema2, required)

## Errors

### 400 Bad Request Error

400

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)
- `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaI18NContext, optional)

### 401 Unauthorized Error

401

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)
- `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaI18NContext, optional)

### 403 Forbidden Error

403

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)
- `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaI18NContext, optional)

### 404 Not Found Error

404

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)
- `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaI18NContext, optional)

### 409 Conflict Error

409

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)
- `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaI18NContext, optional)

### 422 Unprocessable Entity Error

422

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)
- `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaI18NContext, optional)

### 500 Internal Server Error

500

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)
- `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaI18NContext, optional)

## Types

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutRequestBodyContentApplicationJsonSchemaSys

- `id` (string, required)
- `type` ("DataAssembly", required)
- `dataType` (list of SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutRequestBodyContentApplicationJsonSchemaSysDataTypeItems, required)
- `variant` (string, optional)
- `version` (double, optional)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutRequestBodyContentApplicationJsonSchemaMetadata

- `tags` (list of SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutRequestBodyContentApplicationJsonSchemaMetadataTagsItems, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutRequestBodyContentApplicationJsonSchemaParameters

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutRequestBodyContentApplicationJsonSchemaResolvers

### delete__spaces__spaceId__environments__environmentId__data_assemblies__dataAssemblyId__published_10_200___schema2

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaSys

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaMetadata

- `tags` (list of SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaMetadataTagsItems, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaParameters

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaResolvers

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaI18NContext

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutRequestBodyContentApplicationJsonSchemaSysDataTypeItems

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutRequestBodyContentApplicationJsonSchemaMetadataTagsItems

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutRequestBodyContentApplicationJsonSchemaMetadataTagsItemsSys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutRequestBodyContentApplicationJsonSchemaParameters0

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutRequestBodyContentApplicationJsonSchemaParameters1

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutRequestBodyContentApplicationJsonSchemaResolvers0

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutRequestBodyContentApplicationJsonSchemaResolvers1

- `source` ("Contentful:DataAssembly", required)
- `dataAssembly` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutRequestBodyContentApplicationJsonSchemaResolversOneOf1DataAssembly, 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)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaMetadataTagsItems

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaMetadataTagsItemsSys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaParameters0

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaParameters1

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaResolvers0

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaResolvers1

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaI18NContextParameters

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutRequestBodyContentApplicationJsonSchemaSysDataTypeItems1

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutRequestBodyContentApplicationJsonSchemaMetadataTagsItemsSys

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutRequestBodyContentApplicationJsonSchemaParametersOneOf1AllowedResourcesItems

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutRequestBodyContentApplicationJsonSchemaResolversOneOf1DataAssembly

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutRequestBodyContentApplicationJsonSchemaResolversOneOf1DataAssemblySys, 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)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaMetadataTagsItemsSys

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaParametersOneOf1AllowedResourcesItems

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaResolversOneOf1DataAssembly

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaResolversOneOf1DataAssemblySys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaI18NContextParameters0

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaI18NContextParameters1

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaI18NContextParameters2

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaI18NContextParameters3

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaI18NContextParameters4

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutRequestBodyContentApplicationJsonSchemaResolversOneOf1DataAssemblySys

- `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)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPutResponsesContentApplicationJsonSchemaResolversOneOf1DataAssemblySys

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

## Examples

### Example 1

**Request**

```json
{
  "sys": {
    "id": "string",
    "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": {}
  }
}
```

### Example 2

**Request**

```json
{
  "sys": {
    "id": "string",
    "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": {}
  }
}
```