Assign a role to a managed System Account

Assigns a role to a managed system account. Returns 409 if role is already assigned.

post
https://global.api.konghq.com/v3/internal/system-accounts/{accountId}/assigned-roles

Path Parameters

accountIdstringrequired

ID of the system account.

Body

application/json

The request schema for assigning a role.

A parameterized assigned role is a role that has been assigned to a managed system account.

role_namestring

The desired role.

Example:Connector

entity_idstring(uuid)

The ID of the entity.

Example:e67490ce-44dc-4cbd-b65e-b52c746fc26a

entity_type_namestring

The type of entity.

Example:Mesh Control Planes

entity_regionstring

The region to scope the role assignment to.

Allowed values:useuaumeinsg*

Example:eu

parametersobject

Example:{"zoneName":"zone3"}

Response

application/json

A get response of a single parameterized assigned role.

ParameterizedAssignedRole

A parameterized assigned role is a role that has been assigned to a managed system account with additional parameters.

idstring(uuid)

The ID of the role assignment.

Example:eaf7adf1-32c8-4bbf-b960-d1f8456afe67

role_namestring

Name of the role being assigned.

Example:Viewer

entity_idstring(uuid)

A RBAC entity ID.

Example:817d0422-45c9-4d88-8d64-45aef05c1ae7

entity_type_namestring

Name of the entity type the role is being assigned to.

Example:Control Planes

entity_regionstring

Region of the entity.

Allowed values:useuaumeinsg*

Example:eu

parametersobject

Additional parameters for the role assignment.

* Additional properties are allowed.
post/internal/system-accounts/{accountId}/assigned-roles

Body

{ "id": "eaf7adf1-32c8-4bbf-b960-d1f8456afe67", "role_name": "Connector", "entity_id": "18ee2573-dec0-4b83-be99-fa7700bcdc61", "entity_type_name": "Mesh Control Planes", "entity_region": "eu", "parameters": { "zoneName": "zone4" } }
 
application/json

Authentication

Refresh Token

Issues new tokens. Returns 401 if a) the user is no longer active, b) the token has exceeded its lifetime limit, or c) the token has been revoked.

post
https://global.api.konghq.com/v3/refresh

Response

No Content

post/refresh
 

Log Out

Clears the auth cookies.

post
https://global.api.konghq.com/v3/logout

Response

201 application/json

Logout response

Logout Response

login_pathstringrequired

The login path.

post/logout
 
201 application/json

AWS