Admin15

API Keys1

Apps5

Authentication23

Automations14

Bootstrap4

Capability Sources65

Cloud4

Codemode Runs2

Config Objects16

Connectors30

Dashboards9

Deprecated12

Desktop Policies8

Diagnostics3

Direct uploads2

Gateway Usage Limits16

GitHub11

Inference10

Inference Providers30

Internal10

Invitations4

LLM Providers18

Marketplaces17

Members3

OAuth16

Organizations14

Plugins17

Resources2

Roles3

SCIM16

SSO12

System3

Teams7

Telemetry4

Users7

Webhooks1

Workers9

Workflow Runs1

Workflows11

Desktop Policies

Apply desktop-policies by stable key

Creates or replaces an organization-scoped resource. Names do not identify resources; existing unkeyed resources are never adopted automatically. Assignments are replaced. Omitted write-only secrets are preserved. Concurrent writes are last-write-wins; conditional headers are not supported on this route.

put/v1/desktop-policies/by-key/{externalKey}

Path parameters

externalKeystring required

Request body

policyNamestring required

priorityinteger

isEnabledboolean

memberIdsstring[]

teamIdsstring[]

rolesstring[]

Response

The existing resource was replaced.

desktopPolicyobject required

Changes

Changed in 3 of the 48 revisions of this API.4

Sep 11, 2026bb8ff73e4ad32See the full diff
- ○
  the endpoint scheme security bearerAuth was added to the API
  api-security-added
- ○
  the endpoint scheme security denApiKey was added to the API
  api-security-added
This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Sep 7, 2026ffcccb610e8a1See the full diff
- ○
  added the new optional request property /
  new-optional-request-property
Sep 5, 2026cb34559d4b4d1See the full diff
- ○
  endpoint added
  endpoint-added

Full history