Graph
Systems

Manage associations of a System

This endpoint allows you to manage the direct associations of a System.

A direct association can be a non-homogeneous relationship between 2 different objects, for example Systems and Users.

Sample Request

curl -X POST https://console.jumpcloud.com/api/v2/systems/{System_ID}/associations \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -d '{
    "attributes": {
      "sudo": {
        "enabled": true,
        "withoutPassword": false
      }
    },
    "op": "add",
    "type": "user",
    "id": "UserID"
  }'
post/api/v2/systems/{system_id}/associations

Request

Headers

Datestring

Current date header for the System Context API

Authorizationstring

Authorization header for the System Context API

x-org-idstring

Organization identifier that can be obtained from console settings.

Request body

idstring required

The ObjectID of graph object being added or removed as an association.

op'add' | 'remove' | 'update' required

How to modify the graph connection.

type'command' | 'policy' | 'policy_group' | 'user' | 'user_group' required

Targets which a "system" can be associated to.

Response

OK

Changes

No recorded changes to this operation across all 1 revision of this API.