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

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

No content

Add Tag

post

Path parameters

uidintegerRequired

Body

namestringRequiredPattern: ^[^:]+$

valuestringRequiredPattern: ^[^:]+$

colorstring · nullableOptional

Responses

201

Successful Response

application/json

anyOptional

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

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

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

namestringRequiredPattern: ^[^:]+$

valuestringRequiredPattern: ^[^:]+$

colorstring · nullableOptional

Responses

200

Successful Response

application/json

anyOptional

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

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

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

No content

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

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

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

idintegerRequired

locationstringRequired

filenamestringRequired

sizeintegerRequired

created_atstring · date-timeRequired

updated_atstring · date-timeRequired

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

get/api/v2/downloads/{uid}

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

{
  "id": 1,
  "location": "text",
  "filename": "text",
  "size": 1,
  "created_at": "2026-01-01T00:00:00.000Z",
  "updated_at": "2026-01-01T00:00:00.000Z",
  "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:

querystring · nullableOptional

tagsstring[] · nullableOptional

Responses

200

Successful Response

application/json

limitintegerRequired

pageintegerRequired

total_pagesintegerRequired

totalintegerRequired

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

get/api/v2/downloads

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

{
  "records": [
    {
      "id": 1,
      "location": "text",
      "filename": "text",
      "size": 1,
      "created_at": "2026-01-01T00:00:00.000Z",
      "updated_at": "2026-01-01T00:00:00.000Z",
      "tags": [
        {
          "id": 1,
          "name": "text",
          "value": "text",
          "label": "text",
          "color": "text"
        }
      ]
    }
  ],
  "limit": 1,
  "page": 1,
  "total_pages": 1,
  "total": 1
}

Create Download

post

Body

filestring · binaryRequired

Responses

201

Successful Response

application/json

idintegerRequired

locationstringRequired

filenamestringRequired

sizeintegerRequired

created_atstring · date-timeRequired

updated_atstring · date-timeRequired

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

post/api/v2/downloads

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-01-01T00:00:00.000Z",
  "updated_at": "2026-01-01T00:00:00.000Z",
  "tags": [
    {
      "id": 1,
      "name": "text",
      "value": "text",
      "label": "text",
      "color": "text"
    }
  ]
}