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

# Publish a data assembly by ID

PUT https://api.contentful.com/spaces/{spaceId}/environments/{environmentId}/data_assemblies/{dataAssemblyId}/published

Reference: https://contentful-staging.ferndocs.com/developers/docs/references/experiences-management-api/data-assemblies/publish-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)

## Response

### 200

200

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaSys, required)
- `metadata` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaMetadata, required)
- `name` (string, required)
- `description` (string, required)
- `parameters` (map from string to SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaParameters, required)
- `resolvers` (map from string to SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaResolvers, required)
- `return` (delete__spaces__spaceId__environments__environmentId__data_assemblies__dataAssemblyId__published_10_200___schema2, required)

## Errors

### 400 Bad Request Error

400

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)
- `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaI18NContext, optional)

### 401 Unauthorized Error

401

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)
- `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaI18NContext, optional)

### 403 Forbidden Error

403

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)
- `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaI18NContext, optional)

### 404 Not Found Error

404

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)
- `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaI18NContext, optional)

### 409 Conflict Error

409

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)
- `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaI18NContext, optional)

### 422 Unprocessable Entity Error

422

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)
- `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaI18NContext, optional)

### 500 Internal Server Error

500

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)
- `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaI18NContext, optional)

## Types

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaSys

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaMetadata

- `tags` (list of SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaMetadataTagsItems, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaParameters

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaResolvers

### delete__spaces__spaceId__environments__environmentId__data_assemblies__dataAssemblyId__published_10_200___schema2

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaI18NContext

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaMetadataTagsItems

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaMetadataTagsItemsSys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaParameters0

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaParameters1

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaResolvers0

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaResolvers1

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaI18NContextParameters

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaMetadataTagsItemsSys

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaParametersOneOf1AllowedResourcesItems

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaResolversOneOf1DataAssembly

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaI18NContextParameters0

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaI18NContextParameters1

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaI18NContextParameters2

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaI18NContextParameters3

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaI18NContextParameters4

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDataAssembliesDataAssemblyIdPublishedPutResponsesContentApplicationJsonSchemaResolversOneOf1DataAssemblySys

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

## Examples

**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": {}
  }
}
```