Set User Deal Role | termina

Set the user's direct access role for this deal. The user will always end up with exactly one direct role for the deal. Requires admin role to manage members.

Authentication

AuthorizationBearer

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

Path parameters

group_idintegerRequired

deal_idintegerRequired

user_idintegerRequired

Request

This endpoint expects an object.

role_nameenumOptional

The role to set for the user

Allowed values:

notifybooleanOptionalDefaults to false

When true, send an email notification to the user about the shared deal

Response

Successful Response

userobject

Minimal user response for sharing contexts - excludes sensitive fields like email

roleenum

User’s access level for this deal: reader, editor, or admin

Allowed values:

Errors

422

Unprocessable Entity Error

$	curl -X PUT https://app.termina.ai/api/v1/group/1/deal/1/users/1 \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

1	{
2	"user": {
3	"id": 1,
4	"name": "string",
5	"thumbnail_url": "string",
6	"created_at": "2024-01-15T09:30:00Z",
7	"updated_at": "2024-01-15T09:30:00Z"
8	},
9	"role": "admin"
10	}

$	curl -X PUT https://app.termina.ai/api/v1/group/1/deal/1/users/1 \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

1	{
2	"user": {
3	"id": 1,
4	"name": "string",
5	"thumbnail_url": "string",
6	"created_at": "2024-01-15T09:30:00Z",
7	"updated_at": "2024-01-15T09:30:00Z"
8	},
9	"role": "admin"
10	}