Downloads

Download Download

get

Path parameters

uidintegerRequired

Responses

200

Successful Response

No content

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

get

/api/v2/downloads/{uid}/download

HTTPcURLJavaScriptPython

GET /api/v2/downloads/{uid}/download HTTP/1.1
Accept: */*

No content

Add Tag

post

Path parameters

uidintegerRequired

Body

application/json

namestringRequiredPattern: ^[^:]+$

valuestringRequiredPattern: ^[^:]+$

colorany ofOptional

stringOptional

or

nullOptional

Responses

201

Successful Response

application/json

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

post

/api/v2/downloads/{uid}/tags

HTTPcURLJavaScriptPython

POST /api/v2/downloads/{uid}/tags HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 45

{
  "name": "text",
  "value": "text",
  "color": "text"
}

No content

Update Tag

put

Path parameters

uidintegerRequired

tag_idintegerRequired

Body

application/json

namestringRequiredPattern: ^[^:]+$

valuestringRequiredPattern: ^[^:]+$

colorany ofOptional

stringOptional

or

nullOptional

Responses

200

Successful Response

application/json

Responseany

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

put

/api/v2/downloads/{uid}/tags/{tag_id}

HTTPcURLJavaScriptPython

PUT /api/v2/downloads/{uid}/tags/{tag_id} HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 45

{
  "name": "text",
  "value": "text",
  "color": "text"
}

No content

Delete Tag

delete

Path parameters

uidintegerRequired

tag_idintegerRequired

Responses

204

Successful Response

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

delete

/api/v2/downloads/{uid}/tags/{tag_id}

HTTPcURLJavaScriptPython

DELETE /api/v2/downloads/{uid}/tags/{tag_id} HTTP/1.1
Accept: */*

No content

Read Download

get

Path parameters

uidintegerRequired

Responses

200

Successful Response

application/json

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

get

/api/v2/downloads/{uid}

HTTPcURLJavaScriptPython

GET /api/v2/downloads/{uid} HTTP/1.1
Accept: */*

{
  "id": 1,
  "location": "text",
  "filename": "text",
  "size": 1,
  "created_at": "2026-02-02T17:16:30.270Z",
  "updated_at": "2026-02-02T17:16:30.270Z",
  "tags": [
    {
      "id": 1,
      "name": "text",
      "value": "text",
      "label": "text",
      "color": "text"
    }
  ]
}

Read Downloads

get

Query parameters

limitintegerOptionalDefault: -1

pageintegerOptionalDefault: 1

order_directionstring · enumOptionalDefault: descPossible values:

order_bystring · enumOptionalDefault: updated_atPossible values:

queryany ofOptional

stringOptional

or

nullOptional

sourcesany ofOptional

or

nullOptional

tagsany ofOptional

string[]Optional

or

nullOptional

Responses

200

Successful Response

application/json

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

get

/api/v2/downloads

HTTPcURLJavaScriptPython

GET /api/v2/downloads HTTP/1.1
Accept: */*

{
  "records": [
    {
      "id": 1,
      "location": "text",
      "filename": "text",
      "size": 1,
      "created_at": "2026-02-02T17:16:30.270Z",
      "updated_at": "2026-02-02T17:16:30.270Z",
      "tags": [
        {
          "id": 1,
          "name": "text",
          "value": "text",
          "label": "text",
          "color": "text"
        }
      ]
    }
  ],
  "limit": 1,
  "page": 1,
  "total_pages": 1,
  "total": 1
}

Create Download

post

Body

multipart/form-data

filestring · binaryRequired

Responses

201

Successful Response

application/json

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

post

/api/v2/downloads

HTTPcURLJavaScriptPython

POST /api/v2/downloads HTTP/1.1
Content-Type: multipart/form-data
Accept: */*
Content-Length: 17

{
  "file": "binary"
}

{
  "id": 1,
  "location": "text",
  "filename": "text",
  "size": 1,
  "created_at": "2026-02-02T17:16:30.270Z",
  "updated_at": "2026-02-02T17:16:30.270Z",
  "tags": [
    {
      "id": 1,
      "name": "text",
      "value": "text",
      "label": "text",
      "color": "text"
    }
  ]
}