Delete a series

Deletes a series by series ID and brand ID. Validates that the series belongs to the specified brand. All products linked to the series will be moved to the parent brand.

DELETE/api/v1/{team_slug}/{app_slug}/brands/{brand_id}/series/{series_id}
API
Management
Updated
Apr 26, 2026

management-api:DELETE:/api/v1/{team_slug}/{app_slug}/brands/{brand_id}/series/{series_id}

Deletes a series by series ID and brand ID. Validates that the series belongs to the specified brand. All products linked to the series will be moved to the parent brand.

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

The OpenAPI contract defines the method, path, parameters, request body, and responses for this operation.

Operation

  • Method: DELETE
  • Path: /api/v1/\{team_slug\}/\{app_slug\}/brands/\{brand_id\}/series/\{series_id\}
  • Summary: Delete a series
  • Description: Deletes a series by series ID and brand ID. Validates that the series belongs to the specified brand. All products linked to the series will be moved to the parent brand.
  • OpenAPI contract: management-api
  • Operation ID: Not documented in the OpenAPI contract.

Operation key uses API family, method, and path because this OpenAPI contract does not publish an operation ID.

Parameters4 parameters
NameInRequiredTypeDescription
app_slugpathYesstringApp slug
team_slugpathYesstringTeam slug
brand_idpathYesstringId of brand
series_idpathYesstringId of brand
Request bodyNo documented body

Not documented in the OpenAPI contract.

Responses4 statuses
StatusDescriptionContent
200Series deleted successfullyapplication/json (object)
400Invalid request (e.g. bad UUID, validation error)application/json (object)
401Unauthorized accessapplication/json (object)
500Internal server errorapplication/json (object)

200 - object

Message Response

PropertyTypeRequiredDetails
datastringNo-
detailsstring[]NoAdditional contextual information about the response. Used to provide supplementary details beyond the main data payload, such as validation warnings or processing notes
successbooleanNo-

Generated example (synthetic):

{
  "data": "string",
  "details": [
    "string"
  ],
  "success": false
}

400 - object

Error Message

PropertyTypeRequiredDetails
detailsstring[]No-
messagestringNo-
successbooleanNo-

Generated example (synthetic):

{
  "details": [
    "string"
  ],
  "message": "string",
  "success": false
}

401 - object

Error Message

PropertyTypeRequiredDetails
detailsstring[]No-
messagestringNo-
successbooleanNo-

Generated example (synthetic):

{
  "details": [
    "string"
  ],
  "message": "string",
  "success": false
}

500 - object

Error Message

PropertyTypeRequiredDetails
detailsstring[]No-
messagestringNo-
successbooleanNo-

Generated example (synthetic):

{
  "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: DELETE
  • Path: /api/v1/\{team_slug\}/\{app_slug\}/brands/\{brand_id\}/series/\{series_id\}
  • Operation ID: Not documented in the OpenAPI contract.
  • OpenAPI tag: Brands
  • OpenAPI summary: Delete a series

Delete a series

# Delete a series Deletes a series by series ID and brand ID. Validates that the series belongs to the specified brand. All products linked to the series will be moved to the parent brand.
DELETE /api/v1/{team_slug}/{app_slug}/brands/{brand_id}/series/{series_id}
Purpose

Deletes a series by series ID and brand ID.

Required inputs

app_slug path team_slug path brand_id path series_id path

Primary response

200 ยท Series deleted successfully

Operation key

management-api:DELETE:/api/v1/{team_slug}/{app_slug}/brands/{brand_id}/series/{series_id}

## 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: `DELETE` - Path: `/api/v1/{team_slug}/{app_slug}/brands/{brand_id}/series/{series_id}` - Summary: Delete a series - Description: Deletes a series by series ID and brand ID. Validates that the series belongs to the specified brand. All products linked to the series will be moved to the parent brand. - OpenAPI contract: management-api - Operation ID: Not documented in the OpenAPI contract. - Stable operation key: `management-api:DELETE:/api/v1/{team_slug}/{app_slug}/brands/{brand_id}/series/{series_id}` Operation key uses API family, method, and path because this OpenAPI contract does not publish an operation ID. ## Parameters | Name | In | Required | Type | Description | | --- | --- | --- | --- | --- | | app_slug | path | Yes | string | App slug | | team_slug | path | Yes | string | Team slug | | brand_id | path | Yes | string | Id of brand | | series_id | path | Yes | string | Id of brand | ## Request body Not documented in the OpenAPI contract. ## Responses | Status | Description | Content | | --- | --- | --- | | 200 | Series deleted successfully | application/json (object) | | 400 | Invalid request (e.g. bad UUID, validation error) | application/json (object) | | 401 | Unauthorized access | application/json (object) | | 500 | Internal server error | application/json (object) | ### 200 - object #### Message Response | Property | Type | Required | Details | | --- | --- | --- | --- | | `data` | string | 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 | - | **Generated example (synthetic):** ```json { "data": "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 } ``` ### 401 - 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: `DELETE` - Path: `/api/v1/{team_slug}/{app_slug}/brands/{brand_id}/series/{series_id}` - Operation ID: Not documented in the OpenAPI contract. - Stable operation key: `management-api:DELETE:/api/v1/{team_slug}/{app_slug}/brands/{brand_id}/series/{series_id}` - OpenAPI tag: Brands - OpenAPI summary: Delete a series