Skip to main content
PUT
Set Organization Default Platform
Sets the organization-wide default placement for new sessions. This is the same setting as Settings > Devin > Default platform in the webapp. Sessions created without an explicit platform use the creator’s personal default first, then this one.

Permissions

Requires a service user or personal access token with the ManageOrgSettings permission at the organization level.

Request fields

Send at most one of:
  • platform: a hosted platform label configured for the organization (for example linux, windows, or macos) or the name of a shared outpost pool, case-insensitive. Platforms take priority when a name matches both.
  • outpost_pool_id: the ID of a shared outpost pool available to the organization.
Send an empty JSON object ({}), or both fields as null, to clear the default. The request body is required. Only shared outpost pools qualify. Personal outposts can’t be the organization default because only their owner can launch sessions on them.

Outposts-only organizations

When the enterprise is in outposts-only mode, only outpost pools are accepted. Hosted platform labels return 400.

Errors

  • 400 when platform matches no configured platform or shared outpost pool, matches several outpost pools, or names a hosted platform in an outposts-only organization; or when outpost_pool_id isn’t a shared pool available to the organization. The error body lists the available platforms and outpost pools.
  • 403 when the caller lacks ManageOrgSettings.
  • 422 when both platform and outpost_pool_id are set.

Example

Authorizations

Authorization
string
header
required

Service User credential (prefix: cog_)

Path Parameters

org_id
string
required

Organization ID (prefix: org-)

Example:

"org-abc123def456"

Body

application/json

Set the organization's default placement for new sessions.

Send at most one of platform and outpost_pool_id; send both as null (for example {}) to clear the default.

outpost_pool_id
string | null

ID of a shared outpost pool available to the organization.

Maximum string length: 128
platform
string | null

A hosted platform label configured for the organization (e.g. 'linux', 'windows', 'macos') or the name of a shared outpost pool, case-insensitive; platforms take priority when a name matches both. Unrecognized values are rejected with a 400 that lists the available platforms and outpost pools.

Maximum string length: 128

Response

Successful Response

The organization's default placement for new sessions.

outpost_pool_id
string | null
required

Outpost pool new sessions run on by default. Null when the default is a hosted platform or unset.

outpost_pool_name
string | null
required

Name of the default outpost pool. Null when the default is not an outpost pool, or the pool is no longer available to the organization.

platform
string | null
required

Hosted platform label (e.g. 'linux', 'windows') new sessions run on by default. Null when the default is an outpost pool or unset.