Skip to content
Developers

Create a logo upload

POST/v1/teams/{teamId}/logo/uploads

POST
/v1/teams/{teamId}/logo/uploads
curl --request POST \
  --url https://api.ligr.live/rest/v1/teams/1/logo/uploads \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "contentType": "image/png", "size": 1, "sha256": "example" }'

Opens a signed upload for one team logo. Declare the exact PNG or JPEG file you will send. Upload the bytes with one PUT to url and send headers with it. Then send uploadId to PUT /v1/teams/{teamId}/logo within one hour.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
teamId
required

Entity identifier

integer format: int32
>= 1

The team id

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json

Declare the exact logo file you will upload.

object
contentType
required
string
Allowed values: image/png image/jpeg
size
required

Byte count of the file. The limit is 500 KB.

integer format: int32
>= 1 <= 500000
sha256
required

Lowercase hexadecimal SHA-256 of the exact bytes you will PUT.

string

Responses

Section titled “Responses”

201

Section titled “201”

Created

Media typeapplication/json
object
uploadId
required

Send it as uploadId to PUT /v1/teams/{teamId}/logo.

number format: double
url
required

Signed URL for one PUT of the exact bytes.

string
expiresAt
required

Time after which url no longer accepts the PUT.

string
headers
required
object
x-amz-checksum-sha256
required

Base64 SHA-256 of the file. Send it unchanged with the PUT.

string
Examplegenerated
{
  "uploadId": 1,
  "url": "example",
  "expiresAt": "example",
  "headers": {
    "x-amz-checksum-sha256": "example"
  }
}

400

Section titled “400”

Request is invalid

Media typeapplication/json
object
message
required
string
details
required
object
key
additional properties
Examplegenerated
{
  "message": "example",
  "details": {
    "additionalProperty": "example"
  }
}

401

Section titled “401”

Missing or invalid api key

Media typeapplication/json
object
message
required
string
Examplegenerated
{
  "message": "example"
}

403

Section titled “403”

Api key provides insufficient access for the request

Media typeapplication/json
object
message
required
string
Examplegenerated
{
  "message": "example"
}

404

Section titled “404”

Team not found

Media typeapplication/json
object
message
required
string
Examplegenerated
{
  "message": "example"
}

429

Section titled “429”

Api key has made too many requests

Media typeapplication/json
object
message
required
string
Examplegenerated
{
  "message": "example"
}

500

Section titled “500”

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

Media typeapplication/json
object
message
required
string
Examplegenerated
{
  "message": "example"
}