Docs
ExtensionsDownloads

API Reference

The download endpoints: issue, deliver, revoke, and manage files.

Issuing and delivering links are public (the license is the credential). Managing builds and files uses your Kora API key (Authorization: Bearer <key>). Change the host variable in the playground to point at your own instance.

POST
/downloads/issue

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://example.com/downloads/issue" \  -H "Content-Type: application/json" \  -d '{    "license_key": "string",    "file": "string"  }'
{  "build_id": "string",  "token": "string",  "url": "string",  "product": "string",  "customer": "string",  "version": "string",  "file": "string",  "expires_at": "2019-08-24T14:15:22Z",  "max_uses": 0}
GET
/download/{token}

Path Parameters

token*string

Response Body

application/octet-stream

curl -X GET "https://example.com/download/string"
"string"
GET
/downloads
AuthorizationBearer <token>

Your Kora API key, sent as Authorization: Bearer <key>.

In: header

Query Parameters

build_id?string
license?string
customer?string
product?string
file?string

Response Body

application/json

curl -X GET "https://example.com/downloads"
[  {    "build_id": "string",    "file": "string",    "license": "string",    "customer": "string",    "product": "string",    "addon": "string",    "version": "string",    "max_uses": 0,    "uses": 0,    "expires_at": "2019-08-24T14:15:22Z",    "delivered_at": "2019-08-24T14:15:22Z",    "revoked": true  }]
POST
/downloads/revoke
AuthorizationBearer <token>

Your Kora API key, sent as Authorization: Bearer <key>.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

curl -X POST "https://example.com/downloads/revoke" \  -H "Content-Type: application/json" \  -d '{    "build_id": "string"  }'
Empty
DELETE
/downloads
AuthorizationBearer <token>

Your Kora API key, sent as Authorization: Bearer <key>.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

curl -X DELETE "https://example.com/downloads" \  -H "Content-Type: application/json" \  -d '{    "build_id": "string"  }'
Empty
GET
/files
AuthorizationBearer <token>

Your Kora API key, sent as Authorization: Bearer <key>.

In: header

Query Parameters

name?string

Response Body

application/json

curl -X GET "https://example.com/files"
[  {    "name": "string",    "product": "string",    "addon": "string",    "repo": "string",    "asset": "string",    "prerelease": false,    "id": 0  }]
POST
/files
AuthorizationBearer <token>

Your Kora API key, sent as Authorization: Bearer <key>.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://example.com/files" \  -H "Content-Type: application/json" \  -d '{}'
{  "name": "string",  "product": "string",  "addon": "string",  "repo": "string",  "asset": "string",  "prerelease": false,  "id": 0}
PATCH
/files
AuthorizationBearer <token>

Your Kora API key, sent as Authorization: Bearer <key>.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

curl -X PATCH "https://example.com/files" \  -H "Content-Type: application/json" \  -d '{}'
Empty
DELETE
/files
AuthorizationBearer <token>

Your Kora API key, sent as Authorization: Bearer <key>.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

curl -X DELETE "https://example.com/files" \  -H "Content-Type: application/json" \  -d '{    "name": "string"  }'
Empty
GET
/files/repos
AuthorizationBearer <token>

Your Kora API key, sent as Authorization: Bearer <key>.

In: header

Response Body

application/json

curl -X GET "https://example.com/files/repos"
[  "string"]