Bulk Create Channel Content Overrides
# Bulk Create Channel Content Overrides
Creates or updates multiple channel content overrides for products or variants in a single operation. Supports partial success — individual failures don't affect successful creations.
POST
/api/v1/{team_slug}/{app_slug}/channels/{channel_id}/content/bulk
PurposeCreates or updates multiple channel content overrides for products or variants in a single operation.
Required inputsteam_slug path app_slug path channel_id path
Primary response201 · Created
Operation keymanagement-api:POST:/api/v1/{team_slug}/{app_slug}/channels/{channel_id}/content/bulk
## API ownership
- API family: Management API
- Best for: Trusted back-office workflows that create, update, organize, or delete merchant-owned data.
- Do not use from: Browser-only storefront code or public clients.
- Guide route: [/apis/management/latest](/apis/management/latest)
The OpenAPI contract defines the method, path, parameters, request body, and responses for this operation.
## Operation
- Method: `POST`
- Path: `/api/v1/{team_slug}/{app_slug}/channels/{channel_id}/content/bulk`
- Summary: Bulk Create Channel Content Overrides
- Description: Creates or updates multiple channel content overrides for products or variants in a single operation. Supports partial success — individual failures don't affect successful creations.
- OpenAPI contract:
management-api
- Operation ID: Not documented in the OpenAPI contract.
- Stable operation key: `management-api:POST:/api/v1/{team_slug}/{app_slug}/channels/{channel_id}/content/bulk`
Operation key uses API family, method, and path because this OpenAPI contract does not publish an operation ID.
## Parameters
| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| team_slug | path | Yes | string | Team slug |
| app_slug | path | Yes | string | App slug |
| channel_id | path | Yes | string | Channel ID |
## Request body
- Required: Yes
- Description: Channel content data to create
- Content: application/json (object)
### Bulk Create Channel Content Payload
| Property | Type | Required | Details |
| --- | --- | --- | --- |
| `content` | object[] | Yes | maxItems: 100 |
#### Input Create Channel Content
| Property | Type | Required | Details |
| --- | --- | --- | --- |
| `field_type` | enum("name", "description", "short_description", "html_description", "html_short_description", "meta_title", "meta_description", "slug", "category", "collection", "tag", "attribute", "image") | Yes | - |
| `parent_id` | string | Yes | - |
| `parent_type` | enum("product", "variant") | Yes | - |
| `relationships` | string[] | No | - |
| `translations` | object[] | No | - |
| `value` | string | No | - |
#### Localized Value
| Property | Type | Required | Details |
| --- | --- | --- | --- |
| `language_code` | string | No | - |
| `value` | string | No | - |
**Generated example (synthetic):**
```json
{
"content": [
{
"field_type": "name",
"parent_id": "string",
"parent_type": "product",
"relationships": [
"string"
],
"translations": [
{
"language_code": null,
"value": null
}
],
"value": "string"
}
]
}
```
## Responses
| Status | Description | Content |
| --- | --- | --- |
| 201 | Created | application/json (object) |
| 400 | Bad Request | application/json (object) |
| 404 | Not Found | application/json (object) |
| 500 | Internal Server Error | application/json (object) |
### 201 - object
#### Bulk Create Channel Content Response
| Property | Type | Required | Details |
| --- | --- | --- | --- |
| `data` | object | No | - |
| `details` | string[] | No | Additional contextual information about the response. Used to provide supplementary details beyond the main data payload, such as validation warnings or processing notes |
| `success` | boolean | No | - |
##### Bulk Create Channel Content
| Property | Type | Required | Details |
| --- | --- | --- | --- |
| `failed` | object[] | No | - |
| `successful` | object[] | No | - |
##### Bulk Create Channel Content Failed Creation
| Property | Type | Required | Details |
| --- | --- | --- | --- |
| `payload` | object | No | - |
| `reason` | string | No | - |
##### Channel Content
| Property | Type | Required | Details |
| --- | --- | --- | --- |
| `created_at` | string | No | - |
| `field_type` | string | No | - |
| `id` | string | No | - |
| `parent_id` | string | No | - |
| `parent_type` | string | No | - |
| `preview` | string[] | No | - |
| `relationships` | string[] | No | - |
| `translations` | object[] | No | - |
| `updated_at` | string | No | - |
| `value` | string | No | - |
**Generated example (synthetic):**
```json
{
"data": {
"failed": [
{
"payload": {
"field_type": null,
"parent_id": null,
"parent_type": null,
"relationships": null,
"translations": null,
"value": null
},
"reason": "string"
}
],
"successful": [
{
"created_at": "string",
"field_type": "string",
"id": "string",
"parent_id": "string",
"parent_type": "string",
"preview": [],
"relationships": [],
"translations": [],
"updated_at": "string",
"value": "string"
}
]
},
"details": [
"string"
],
"success": false
}
```
### 400 - object
#### Error Message
| Property | Type | Required | Details |
| --- | --- | --- | --- |
| `details` | string[] | No | - |
| `message` | string | No | - |
| `success` | boolean | No | - |
**Generated example (synthetic):**
```json
{
"details": [
"string"
],
"message": "string",
"success": false
}
```
### 404 - object
#### Error Message
| Property | Type | Required | Details |
| --- | --- | --- | --- |
| `details` | string[] | No | - |
| `message` | string | No | - |
| `success` | boolean | No | - |
**Generated example (synthetic):**
```json
{
"details": [
"string"
],
"message": "string",
"success": false
}
```
### 500 - object
#### Error Message
| Property | Type | Required | Details |
| --- | --- | --- | --- |
| `details` | string[] | No | - |
| `message` | string | No | - |
| `success` | boolean | No | - |
**Generated example (synthetic):**
```json
{
"details": [
"string"
],
"message": "string",
"success": false
}
```
## Contract identity
Use these fields to confirm you are implementing the intended endpoint contract.
- API family: Management API
- Method: `POST`
- Path: `/api/v1/{team_slug}/{app_slug}/channels/{channel_id}/content/bulk`
- Operation ID: Not documented in the OpenAPI contract.
- Stable operation key: `management-api:POST:/api/v1/{team_slug}/{app_slug}/channels/{channel_id}/content/bulk`
- OpenAPI tag: Channels, ChannelContent, Bulk
- OpenAPI summary: Bulk Create Channel Content Overrides