Check status of a Distribution Release

post

https://cdn.lingohub.com/v1/distributions/check

Checks whether a new Distribution Release is available for the given environment, type, and optional version/release filters. Requires a valid CDN key as a Bearer token in the Authorization header. Returns 200 with release details if a matching release exists, or 204 if no release matches.

Body Params

clientUser

string | null

An identifier for the end-user of the client application. Used for logging purposes only.

clientAgent

string | null

The user-agent string of the client application. Used for logging purposes only.

clientLanguageCode

string | null

The ISO language code of the client. Used for logging purposes only.

clientVersion

string | null

The semantic version of the client application. Used as an optional filter to match a version-specific distribution.

clientRelease

string | null

The release identifier of the client application. Used as an optional filter.

distributionEnvironment

string

enum

required

The target distribution environment. This is a mandatory filter.

Allowed:

distributionType

string

enum

required

The target distribution type. This is a mandatory filter.

Allowed:

Headers

Authorization

string

required

CDN key as Bearer token. Format: 'Bearer cdn_<jwt_token>'.

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Bearer

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

*/*

200A matching Distribution Release was found.

204No Distribution Release matches the given filter. The response body is empty.

401Unauthorized: The Authorization header is missing, malformed, or contains an invalid/expired CDN key.

404Not Found: No distribution or distribution release matches the given environment, type, and version.

422Unprocessable Entity: The request body failed validation (e.g. invalid language code or semantic version format).

429Too Many Requests: The workspace's CDN usage budget has been exceeded. Please add more CDN budget.

500Internal Server Error: An unexpected error occurred.