Delete a theme

DELETE

/v2/themes/{themeId}

curl --request DELETE \
  --url https://api.ligr.live/rest/v2/themes/1 \
  --header 'Authorization: Bearer <token>'

• LIGR REST API

Beta. This operation can change between minor versions. See Beta status.

Deletes a theme your organization owns, with every graphic in it. A theme a competition still uses is refused with 409. Remove the theme from the competition first.

Authorizations

• bearer
  themes:write
• api_key
  themes:write

Parameters

Path Parameters

themeId

required

Entity identifier

integer format: int32

>= 1

The theme identifier

Responses

204

Deleted

400

Request is invalid

Media typeapplication/json

object

message

required

string

details

required

object

key

additional properties

Example^generated

{
  "message": "example",
  "details": {
    "additionalProperty": "example"
  }
}

401

Missing or invalid api key

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}

403

Api key provides insufficient access for the request

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}

404

Theme not found

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}

409

A competition still uses the theme

Media typeapplication/json

Body of a 409 answer for a theme a competition still uses.

code is always THEME_IN_USE. details names one competition per line.

object

message

required

string

code

required

string

details

required

Array<string>

Example^generated

{
  "message": "example",
  "code": "example",
  "details": [
    "example"
  ]
}

429

Api key has made too many requests

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}

500

An unexpected error has occured. If problems persist please contact support

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}