v2 > Services > BrandsDelete

Delete one or more brands in Origin. The Main Brand cannot be deleted (See result.data[].isMainBrand in BrandsGet)

URL

/connect/v2/brands/delete

/connect/v2/async/brands/delete
Method:

POST
URL Params

none
Request :

Field	Type	Required	Description	Domain of value
`brands[]`	array of object	At least one	The list of brands to delete	Brand object(s)
`brands[].originId`	string	Only if no `brands[].externalId`	The brand unique origin ID	A UUID
`brands[].externalId`	string	Only if no `brands[].originId`	The brand unique ID in your system	Any string

Sample Request

{
  "brands": [
    {
      "originId": "13949a9b-ee17-4760-93e9-7749ff2faa79"
    }
  ]
}

Response :

Field	Type	Presence	Description	Domain of value
`status`	object	Always	The execution status	A status object
`status.state`	string	Always	The state of execution	'SUCCESS' or 'ERROR'
`status.code`	string	On error	The general error code and message	See Errors reference
`status.messages[]`	array of string	On error	List of error causes	A validation message or other causes
`result`	object	On success	The execution result	A result object
`result.entityType`	string	On success	The type of entity this result is about	'BRAND'
`result.result`	object	On success	A simple completion message	'Delete completed.'
`connectRequest`	object	Always	The exact request sent that produced this response	A BrandsDelete request

Sample Response (Success in sync mode)

HTTP Code : 200

{
  "status": {
    "state": "SUCCESS"
  },
  "result": {
    "entityType": "BRAND",
    "result": "Delete completed."
  },
  "connectRequest": {
    "brands": [
      {
        "originId": "13949a9b-ee17-4760-93e9-7749ff2faa79"
      }
    ]
  }
}

Response (async mode):

Field	Type	Presence	Description	Domain of value
`status`	object	Always	The execution status	A status object
`status[].state`	string	Always	The state of execution	'SUCCESS' or 'ERROR'
`status[].code`	string	On error	The general error code and message	See Errors reference
`status[].messages[]`	array of string	On error	List of error causes	A validation message or other causes
`result`	object	On success	The execution result	A result object
`result.poolingCallback`	string	On success	The URL callback to pool using the ResultGet endpoint	A URL
`connectRequest`	object	Always	The exact request you sent that produced this response	A BrandsDelete request

Sample Response (Success in async mode)

HTTP Code : 200

{
  "status": {
    "state": "SUCCESS"
  },
  "result": {
    "poolingCallback": "https://origin.build/connect/v2/result/brands_delete/batch/1c8a06b6-45be-4e68-9e2d-5c1f075e6ca2"
  },
  "connectRequest": {
    "brands": [
      {
        "originId": "13949a9b-ee17-4760-93e9-7749ff2faa79"
      }
    ]
  }
}

Sample Response (Error)

HTTP Code : 400, 500

{
  "status": {
    "state": "ERROR",
    "code": "CE00001 - Connect request failed validation. Refer to provided messages for details.",
    "messages": [
      "brands[1] require one originId or externalId."
    ]
  },
  "connectRequest": {
    "brands": [
      {
        "locale": "en"
      }
    ]
  }
}

Sample Response Delete Main Brand (Error)

HTTP Code : 400, 500

{
  "status": {
    "state": "ERROR",
    "code": "CE00000 - An unexpected error occured and the request was not processed. Contact API support.",
    "messages": [
      "org.gigabase.equinox.connect.api.exception.ConnectDataProviderInvocationException: org.gigabase.equinox.web.service.data.DataProviderException: CodeException[INVALIDINFO][400][The Main Brand cannot be deleted]"
    ]
  },
  "connectRequest": {
    "brands": [
      {
        "originId": "6f24a3fc-46b8-45ab-a687-6604b273837a"
      }
    ]
  }
}

results matching ""

No results matching ""