getReleaseBuildIds

Returns the released builds for a given app.

Request

GET /v1/getReleaseBuildIds?appId={appId}

Query Parameters

ParameterTypeRequiredDescription
appIdstringYesThe ToDesktop app ID.

Response

Successful responses return released builds in descending releasedAt order.

{
  "releases": [
    {
      "buildId": "240229r7vjixpjp",
      "version": "1.2.3",
      "releasedAt": "2024-02-29T12:34:56.000Z"
    }
  ],
  "count": 1
}

Response Fields

FieldTypeDescription
releasesArray<{ buildId: string; version: string; releasedAt: string }>The released builds for the app.
countnumberThe number of released builds returned.

Example

curl "https://api.todesktop.com/v1/getReleaseBuildIds?appId=your-app-id"

Errors

  • 400 if appId is missing.
  • 404 with { "message": "No released builds found" } when the app has no released builds.