DELETE /api/:space/competitions/:competitionId/contests/:contestId

Description:

Deletes a specified contest from a specified competition.

Resource URL:

https://<apphost>.competitionlabs.com/api/<your-space-name>/competitions/<competitionId>/contests/<contestId>

Request header

Key	Value	Required
X-API-KEY		Yes
Content-Type	application/json	Yes

Request URL parameter

Parameter	Type	Required	Description
space	String	Yes	This is the space name which is linked to the account
competitionId	String	Yes	Competition identifier retrieved from GET Competitions resource
contestId	String	Yes	Contest identifier retrieved from GET Contests request

EXAMPLE

Request

curl
--header "X-API-KEY: <your-api-key>"
--request DELETE https://app.competitionlabs.com/api/your_space_name/comeptitions/TcwMVGcB4wBRS3KFAkGl/contests/ZMwQVGcB4wBRS3KFLUGU

Response

Response Header: 200

ERROR CODES

Code

HTTP Status

Description

Example

1007

404

Contest with CL-contestId not found for the CL-competitionId

Error Response 404

{
    "errors": [
        {
            "message": "Contest with CL-contestId: Z7Pww2UBOmEkXOJnMWPYa not found for the CL-competitionId: ZbPvw2UBOmEkXOJnxGMs.",
            "code": 1007,
            "status": 404
        }
    ]
}

4004

406

Contest in active, ready, finished or canceled state cannot be deleted.

Error Response 406

{
    "errors": [
        {
            "message": "Contest in active, ready, finished or canceled state cannot be deleted.",
            "code": 4004,
            "status": 406
        }
    ]
}

404

Error Response 404

{
    "status": 404
}