> 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 fragment optimization variant

PUT https://api.contentful.com/spaces/{spaceId}/environments/{environmentId}/fragments/{id}/optimization_variants/{variantId}/published

Reference: https://contentful-staging.ferndocs.com/developers/docs/references/experiences-management-api/fragment-optimization-variants/fragment-publish-optimization-variant

## Authentication

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

## Request

### Path parameters

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

### Query parameters

- `access_token` (string, optional)

## Response

### 200

200

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaSys, required)
- `name` (string, required)
- `description` (string, required)
- `viewports` (list of SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaViewportsItems, required)
- `designProperties` (map from string to map from string to SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaDesignProperties, required)
- `dimensionKeyMap` (SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaDimensionKeyMap, required)
- `contentBindings` (SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaContentBindings, optional)
- `metadata` (SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaMetadata, optional)
- `slots` (map from string to list of DeleteSpacesSpaceIdEnvironmentsEnvironmentIdExperiencesIdOptimizationVariantsVariantIdArchived26200Schema0Items, optional)

## Errors

### 400 Bad Request Error

400

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)
- `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaI18NContext, optional)

### 401 Unauthorized Error

401

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)
- `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaI18NContext, optional)

### 403 Forbidden Error

403

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)
- `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaI18NContext, optional)

### 404 Not Found Error

404

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)
- `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaI18NContext, optional)

### 409 Conflict Error

409

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)
- `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaI18NContext, optional)

### 422 Unprocessable Entity Error

422

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)
- `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaI18NContext, optional)

### 500 Internal Server Error

500

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)
- `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaI18NContext, optional)

## Types

### SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaSys

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

### SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaViewportsItems

- `id` (string, required)
- `query` (string, required)
- `displayName` (string, required)
- `previewSize` (string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaDesignProperties

### SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaDimensionKeyMap

- `designProperties` (map from string to SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaDimensionKeyMapDesignProperties, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaContentBindings

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaContentBindingsSys, required)
- `parameters` (map from string to SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaContentBindingsParameters, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaMetadata

- `tags` (list of SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaMetadataTagsItems, optional)
- `concepts` (list of SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaMetadataConceptsItems, optional)
- `name` (string, optional)

### DeleteSpacesSpaceIdEnvironmentsEnvironmentIdExperiencesIdOptimizationVariantsVariantIdArchived26200Schema0Items

### SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaI18NContext

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

### SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaDesignProperties0

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

### SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaDesignProperties1

- `type` ("ManualDesignValue", required)
- `value` (SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaDesignPropertiesOneOf1Value, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaDimensionKeyMapDesignProperties

- `breakpoint` (string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaContentBindingsSys

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

### SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaContentBindingsParameters

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaContentBindingsParametersSys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaMetadataTagsItems

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaMetadataTagsItemsSys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaMetadataConceptsItems

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaMetadataConceptsItemsSys, required)

### DeleteSpacesSpaceIdEnvironmentsEnvironmentIdExperiencesIdOptimizationVariantsVariantIdArchived26200Schema0Items0

- `id` (string, required)
- `nodeType` ("Fragment", required)
- `fragment` (DeleteSpacesSpaceIdEnvironmentsEnvironmentIdExperiencesIdOptimizationVariantsVariantIdArchived26200Schema0ItemsOneOf0Fragment, required)
- `name` (string, optional)

### DeleteSpacesSpaceIdEnvironmentsEnvironmentIdExperiencesIdOptimizationVariantsVariantIdArchived26200Schema0Items1

- `id` (string, required)
- `nodeType` ("InlineFragment", required)
- `componentType` (DeleteSpacesSpaceIdEnvironmentsEnvironmentIdExperiencesIdOptimizationVariantsVariantIdArchived26200Schema0ItemsOneOf1ComponentType, required)
- `designProperties` (map from string to map from string to DeleteSpacesSpaceIdEnvironmentsEnvironmentIdExperiencesIdOptimizationVariantsVariantIdArchived26200Schema0ItemsOneOf1DesignProperties, required)
- `contentBindings` (DeleteSpacesSpaceIdEnvironmentsEnvironmentIdExperiencesIdOptimizationVariantsVariantIdArchived26200Schema0ItemsOneOf1ContentBindings, optional)
- `slots` (map from string to list of DeleteSpacesSpaceIdEnvironmentsEnvironmentIdExperiencesIdOptimizationVariantsVariantIdArchived26200Schema0Items, optional)

### SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaI18NContextParameters

### SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaDesignPropertiesOneOf1Value

### SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaContentBindingsParametersSys

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

### SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaMetadataTagsItemsSys

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

### SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaMetadataConceptsItemsSys

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

### DeleteSpacesSpaceIdEnvironmentsEnvironmentIdExperiencesIdOptimizationVariantsVariantIdArchived26200Schema0ItemsOneOf0Fragment

- `sys` (DeleteSpacesSpaceIdEnvironmentsEnvironmentIdExperiencesIdOptimizationVariantsVariantIdArchived26200Schema0ItemsOneOf0FragmentSys, required)

### DeleteSpacesSpaceIdEnvironmentsEnvironmentIdExperiencesIdOptimizationVariantsVariantIdArchived26200Schema0ItemsOneOf1ComponentType

- `sys` (DeleteSpacesSpaceIdEnvironmentsEnvironmentIdExperiencesIdOptimizationVariantsVariantIdArchived26200Schema0ItemsOneOf1ComponentTypeSys, required)

### DeleteSpacesSpaceIdEnvironmentsEnvironmentIdExperiencesIdOptimizationVariantsVariantIdArchived26200Schema0ItemsOneOf1DesignProperties

### DeleteSpacesSpaceIdEnvironmentsEnvironmentIdExperiencesIdOptimizationVariantsVariantIdArchived26200Schema0ItemsOneOf1ContentBindings

- `sys` (DeleteSpacesSpaceIdEnvironmentsEnvironmentIdExperiencesIdOptimizationVariantsVariantIdArchived26200Schema0ItemsOneOf1ContentBindingsSys, required)
- `parameters` (map from string to DeleteSpacesSpaceIdEnvironmentsEnvironmentIdExperiencesIdOptimizationVariantsVariantIdArchived26200Schema0ItemsOneOf1ContentBindingsParameters, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaI18NContextParameters0

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

### SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaI18NContextParameters1

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

### SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaI18NContextParameters2

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

### SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaI18NContextParameters3

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

### SpacesSpaceIdEnvironmentsEnvironmentIdFragmentsIdOptimizationVariantsVariantIdPublishedPutResponsesContentApplicationJsonSchemaI18NContextParameters4

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

### DeleteSpacesSpaceIdEnvironmentsEnvironmentIdExperiencesIdOptimizationVariantsVariantIdArchived26200Schema0ItemsOneOf0FragmentSys

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

### DeleteSpacesSpaceIdEnvironmentsEnvironmentIdExperiencesIdOptimizationVariantsVariantIdArchived26200Schema0ItemsOneOf1ComponentTypeSys

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

### DeleteSpacesSpaceIdEnvironmentsEnvironmentIdExperiencesIdOptimizationVariantsVariantIdArchived26200Schema0ItemsOneOf1DesignProperties0

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

### DeleteSpacesSpaceIdEnvironmentsEnvironmentIdExperiencesIdOptimizationVariantsVariantIdArchived26200Schema0ItemsOneOf1DesignProperties1

- `type` ("ManualDesignValue", required)
- `value` (DeleteSpacesSpaceIdEnvironmentsEnvironmentIdExperiencesIdOptimizationVariantsVariantIdArchived26200Schema0ItemsOneOf1DesignPropertiesOneOf1Value, required)

### DeleteSpacesSpaceIdEnvironmentsEnvironmentIdExperiencesIdOptimizationVariantsVariantIdArchived26200Schema0ItemsOneOf1ContentBindingsSys

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

### DeleteSpacesSpaceIdEnvironmentsEnvironmentIdExperiencesIdOptimizationVariantsVariantIdArchived26200Schema0ItemsOneOf1ContentBindingsParameters

- `sys` (DeleteSpacesSpaceIdEnvironmentsEnvironmentIdExperiencesIdOptimizationVariantsVariantIdArchived26200Schema0ItemsOneOf1ContentBindingsParametersSys, required)

### DeleteSpacesSpaceIdEnvironmentsEnvironmentIdExperiencesIdOptimizationVariantsVariantIdArchived26200Schema0ItemsOneOf1DesignPropertiesOneOf1Value

### DeleteSpacesSpaceIdEnvironmentsEnvironmentIdExperiencesIdOptimizationVariantsVariantIdArchived26200Schema0ItemsOneOf1ContentBindingsParametersSys

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

## Examples

**Response**

```json
{
  "sys": {
    "id": "string",
    "type": "string",
    "space": {
      "sys": {
        "type": "string",
        "linkType": "string",
        "id": "string"
      }
    },
    "environment": {
      "sys": {
        "type": "string",
        "linkType": "string",
        "id": "string"
      }
    },
    "componentType": {
      "sys": {
        "type": "string",
        "linkType": "string",
        "urn": "string"
      }
    },
    "archivedAt": "string",
    "archivedBy": {
      "sys": {
        "type": "string",
        "linkType": "string",
        "id": "string"
      }
    },
    "archivedVersion": 1.1,
    "createdAt": "string",
    "updatedAt": "string",
    "createdBy": {
      "sys": {
        "type": "string",
        "linkType": "string",
        "id": "string"
      }
    },
    "updatedBy": {
      "sys": {
        "type": "string",
        "linkType": "string",
        "id": "string"
      }
    },
    "variant": "string",
    "variantType": "string",
    "variantDimension": "string",
    "publishedAt": "string",
    "publishedVersion": 1.1,
    "publishedCounter": 1.1,
    "firstPublishedAt": "string",
    "publishedBy": {
      "sys": {
        "type": "string",
        "linkType": "User",
        "id": "string"
      }
    },
    "version": 1.1
  },
  "name": "string",
  "description": "string",
  "viewports": [
    {
      "id": "string",
      "query": "string",
      "displayName": "string",
      "previewSize": "string"
    }
  ],
  "designProperties": {},
  "dimensionKeyMap": {
    "designProperties": {}
  },
  "contentBindings": {
    "sys": {
      "type": "string",
      "linkType": "string",
      "urn": "string"
    },
    "parameters": {}
  },
  "metadata": {
    "tags": [
      {
        "sys": {
          "type": "string",
          "linkType": "string",
          "id": "string"
        }
      }
    ],
    "concepts": [
      {
        "sys": {
          "type": "string",
          "linkType": "string",
          "id": "string"
        }
      }
    ],
    "name": "string"
  },
  "slots": {}
}
```