menu
Select programming language for code examples

linkShort URLs

Below you will find information about our get subdomain, used for short, friendly distribution URLs. Feel free to point customers to this domain, rather than pointing them directly to our API's artifact endpoints.

For example — rather than,

https://api.keygen.sh/v1/accounts/demo/artifacts/App.zip

You can point them to,

https://get.keygen.sh/demo/1.0.0/App.zip

linkDownload an Artifact

Download an artifact. Redirects to the storage provider, initiating a download.

linkAuthentication

  • linkBearer

    optional

    An authentication token with privileges to read the release artifact: either an admin, the product it belongs to, an entitled license (via license key or a license token), or a user with an entitled license. If the product's distribution strategy is OPEN, no authentication is required.

linkURL Parameters

  • link<account>

    stringrequired

    The identifier (UUID) or slug of your Keygen account.

  • link<release>

    stringrequired

    The identifier (UUID), version or tag of the release to be retrieved.

  • link<artifact>

    stringrequired

    The identifier (UUID) or the filename of the artifact to be retrieved.

Definition

https://get.keygen.sh/<account>/<release>/<artifact>

Example request

curl -vLG -X GET https://get.keygen.sh/demo/latest/App.zip \
  -d 'auth=license:C1B6DE-39A6E3-DE1529-8559A0-4AF593-V3'

Example response / 303 See Other

Location: https://keygen-dist.s3.us-east-2.amazonaws.com/artifacts/30c64dcd-a74d-4f0d-8479-8745172a4817/App.zip?...