Public API: where to PUT a new file for one of your tilesets (secret keys)

POST

/v1/tilesets/{name}/uploads

curl --request POST \
  --url https://api.tareky.com/v1/tilesets/example/uploads \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "filename": "example", "bytes": 1 }'

Authorizations

• key
• access_token
• legacy

Parameters

Path Parameters

name

required

string

/^[a-z0-9_-]{1,32}$/

Header Parameters

x-access-key-id

string

Legacy key id (until its sunset)

Request Body^required

Media typeapplication/json

object

filename

required

string

>= 1 characters <= 200 characters

bytes

required

integer

<= 9007199254740991

Example^generated

{
  "filename": "example",
  "bytes": 1
}

Responses

429

Rate limit or monthly quota exceeded; see Retry-After

Media typeapplication/json

object

error

required

object

code

required

Stable machine-readable code, e.g. quota_exceeded, no_route

string

message

required

string

status

required

integer

>= -9007199254740991 <= 9007199254740991

details

For invalid_request: the validation issues

docsUrl

required

string

requestId

string

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "status": 1,
    "details": "example",
    "docsUrl": "example"
  },
  "requestId": "example"
}

default

Any other error, in the /v1 error envelope

Media typeapplication/json

object

error

required

object

code

required

Stable machine-readable code, e.g. quota_exceeded, no_route

string

message

required

string

status

required

integer

>= -9007199254740991 <= 9007199254740991

details

For invalid_request: the validation issues

docsUrl

required

string

requestId

string

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "status": 1,
    "details": "example",
    "docsUrl": "example"
  },
  "requestId": "example"
}