Set per-OS pinned target versions for an org

Sets linux, mac, and windows pins (all three fields required). Use an empty string to clear a pin for that OS. At least one OS version must be non-empty. Versions accept optional leading "v" and are stored as v-prefixed strings. Clears legacy targetVersion.

Request
path Parameters
orgId
required
string
Request Body schema: application/json
orgId
string
linux
string

Canonical v-prefixed semantic version for Linux agents

mac
string

Canonical v-prefixed semantic version for Mac agents

windows
string

Canonical v-prefixed semantic version for Windows agents

Responses
200

Updated org targetVersion

400

Bad Request. The request parameters (or body) were malformed or invalid. Fix the issues with the request and try again.

401

Unauthorized request. Make sure token was included and is valid and try again.

403

Forbidden. You are not permitted to access the requested resource.

404

Not Found. The specified resource (or resource referred to by id) was not found

put/endpoint-control-service/v1/org-config/{orgId}/target-version
Request samples
application/json
{
  • "orgId": "string",
  • "linux": "v1.2.3",
  • "mac": "v1.2.3",
  • "windows": "v1.2.3"
}
Response samples
application/json
{
  • "orgId": "string",
  • "linux": "v1.2.3",
  • "mac": "v1.2.3",
  • "windows": "v1.2.3"
}