Skip to main content
DELETE
Delete User Relationship

Authentication and permissions

Token requirements: User-based token (OAuth) or Organization-scoped API key. Send a bearer access token for one of these identities. The permissions and resource restrictions below also apply.
Permissions joined by + are all required; or separates alternatives. Full-access keys still cannot call endpoints marked unsupported. Team keys must allow every team checked by the request. OAuth access depends on the user’s roles and resource access.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

user_id
string
required

Query Parameters

relationshipType
enum<string>
required
Available options:
USER_RELATIONSHIP_TYPE_UNSPECIFIED,
USER_RELATIONSHIP_TYPE_MANAGER
pin
boolean

Pin the cleared state ("no manager") against automation re-assignment. Defaults by principal: user-token deletes pin, API-key deletes don't. Release through UpdateUser's release_fields (MANAGER).

Response

200 - application/json

Success

The response is of type DeleteUserRelationshipResponse · object.