Logo
Workato DocsStatus PageAutomation InstituteGet a trialWorkato.com
  • Developer API
    • Authentication
    • API clients and roles
    • GitHub secret scanning
    • Response codes
    • Rate limits
    • Resources
  • Embedded API
    • Authentication
    • Supported formats
    • Response codes
    • Resources
    • Rate limits
    • Embedded API FAQs
Workato DocsStatus PageAutomation InstituteGet a trialWorkato.com
Embedded APIResourcesCustomer workspace collaborators

PUT
/managed_users/:managed_user_id/environment_roles/:id
PUT
/api/managed_users/:managed_user_id/environment_roles/:id
1curl -X PUT https://www.workato.com/api/managed_users/managed_user_id/environment_roles/id \
2 -H "Authorization: Bearer <token>" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "environment_role": {
6 "name": "Builder",
7 "config": {
8 "team": {
9 "privileges": "all"
10 }
11 }
12 }
13}'
Try it
200Updated
1{
2 "data": {
3 "id": 1,
4 "name": "Builder",
5 "config": {
6 "team": {
7 "privileges": "all"
8 }
9 },
10 "members_count": 0,
11 "type": "custom",
12 "created_at": "2024-01-15T09:30:00Z",
13 "updated_at": "2024-01-15T09:30:00Z"
14 }
15}
Was this page helpful?
Previous

Delete an environment role in a customer workspace

Next
Built with
Updates an existing environment role in an Embedded workspace by its ID. <Warning title="EARLY ACCESS FEATURE"> This access control endpoint is in limited preview. The access control model is under active development and may change. Contact your Customer Success Manager to participate in early access testing.</Warning>
Update an environment role in a customer workspace

Path parameters

managed_user_idstringRequired
The Embedded customer ID or external ID. External IDs must be URL encoded and prefixed with an `E`, for example: `EA2300`.
idstringRequired
The ID of the environment role to update.

Headers

AuthorizationstringRequired

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

Request

This endpoint expects an object.
environment_roleobjectRequired

Response

Success reply
dataobject or null

Errors

Success reply

The Embedded customer ID or external ID. External IDs must be URL encoded and prefixed with an E, for example: EA2300.

Updates an existing environment role in an Embedded workspace by its ID.

EARLY ACCESS FEATURE
This access control endpoint is in limited preview. The access control model is under active development and may change. Contact your Customer Success Manager to participate in early access testing.