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 Any string
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 BrandsCreate request

  • Sample Response (Success in async mode):

    HTTP Code : 200

{
    "status": {
        "state": "SUCCESS"
    },
    "result": {
        "poolingCallback": "https://origin.build/equinox/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 ""