Set or change a user's manager (moves their whole sub-tree).

PUT

/admin/org-chart/users/{userId}/manager

curl --request PUT \
  --url https://api.gospl.example/v1/admin/org-chart/users/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/manager \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "managerId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" }'

• Production (placeholder)
• Mock server (generated from this contract)

Rejects any change that would create a cycle (FR-06). Takes effect immediately for downstream access checks (FR-07).

Authorizations

• bearerAuth

Parameters

Path Parameters

userId

required

string format: uuid

Request Body ^required

Media type application/json

object

managerId

required

The new manager. Must not be the user or any of their descendants.

string format: uuid

Example ^generated

{
  "managerId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
}

Responses

200

Updated.

Media type application/json

object

user

required

object

id

required

string format: uuid

name

required

string

jobTitle

string

team

string

managerId

required

One of:

string

string format: uuid

null

null

Example ^generated

{
  "user": {
    "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "name": "example",
    "jobTitle": "example",
    "team": "example"
  },
  "managerId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
}

401

Missing/invalid credentials.

Media type application/json

object

code

required

string

message

required

string

Example ^generated

{
  "code": "example",
  "message": "example"
}

403

Not an admin, or cross-tenant.

Media type application/json

object

code

required

string

message

required

string

Example ^generated

{
  "code": "example",
  "message": "example"
}

404

User not found within the caller’s tenant.

Media type application/json

object

code

required

string

message

required

string

Example ^generated

{
  "code": "example",
  "message": "example"
}

409

Rejected — would create a cycle in the reporting graph (FR-06).

Media type application/json

object

code

required

string

message

required

string

Example ^generated

{
  "code": "example",
  "message": "example"
}