ToDesktop API Reference

The ToDesktop API exposes a small set of HTTP endpoints for checking release state, listing released builds, reading build metadata, and releasing a build.

Base URL

All endpoints in this section are rooted at:

https://api.todesktop.com/v1

Authentication

  • getBuild requires an Authorization: Bearer <access-token> header.
  • releaseBuild requires an Authorization: Bearer <access-token> header and a request body that includes the account email.
  • The remaining endpoints documented here do not perform bearer-token authentication in this worker.

Endpoints

MethodEndpointDescription
GET/getReleaseStatusReturns whether a specific build has been released.
GET/getReleaseBuildIdsReturns released builds for an app, ordered by release time.
GET/getBuildReturns build metadata for a specific build.
POST/releaseBuildReleases a build for distribution after validating access and build readiness.

Error Handling

Request validation errors raised by this worker return a JSON response with a message and numeric code:

{
  "message": "Parameter appId is required in search params",
  "code": 1
}

Unhandled worker errors return:

{
  "message": "Internal server error",
  "code": 2
}

Some handlers also return endpoint-specific error payloads, especially authentication failures on getBuild and release validation errors on releaseBuild.