Skip to main content
PUT

Authorizations

Authorization
string
header
required

A Modus personal access token (modus_<orgUuid>_<prefix>_<secret>) or an OAuth 2.1 access token, sent as Authorization: Bearer <token>.

Path Parameters

id
number
required

Numeric scope id.

Example:

42

Body

application/json
subordinateAgentIds
number[]
required

Replacement list of subordinate scope ids. The previous list is fully replaced; pass [] to clear.

Example:

Response

supervisorAgentId
number
required

Numeric id of the scope that supervises the listed subordinates. Echoes the :id from the URL path.

Example:

42

subordinateAgentIds
number[]
required

Numeric ids of the scopes supervised by supervisorAgentId. The order is preserved across writes and reads.

Example: