Update My User Account

Updates the user account for the user identified in the token of the request.

patch
https://global.api.konghq.com/v2/users/me

Body

application/json

The request schema for the update user request.

full_namestring

The user’s full name.

Match pattern:^[\w \W]+$

<= 250 characters

Example:James C. Woods

preferred_namestring

The user’s desired name.

<= 250 characters

Example:Jimmy

Response

application/json

A get action response of a single user.

User

The user object contains information about an individual user who can use the Konnect application and API.

idstring(uuid)read-only

The User ID.

Example:7f9fd312-a987-4628-b4c5-bb4f4fddd5f7

emailstring(email)

The email registered to the user.

<= 250 characters

Example:user@email.com

full_namestring

The User’s full name.

Match pattern:^[\w \W]+$

<= 250 characters

Example:Jane Doe

preferred_namestring

The User’s preferred name.

<= 250 characters

Example:Jane

activebooleanread-only

Returns True if a user has verified their email address.

Default:true

inferred_regionstringread-only

The Konnect region closest to the user’s IP address. This property might only be set for users on signup through Konnect’s build-in native authentication.

Example:us

created_atstring(date-time)read-only

The time stamp for the date the account was registered.

Example:2022-02-07T17:46:57.52Z

updated_atstring(date-time)read-only

A Unix timestamp representation of the most recent change to the User account.

Example:2022-10-08T17:00:00.52Z

patch/users/me

Body

{ "full_name": "James C Woods", "preferred_name": "Jimmy" }
 
application/json

Update My User Account Password

Update the password of the user identified in the token of the request.

patch
https://global.api.konghq.com/v2/users/me/password

Body

application/json
old_passwordstringrequired

Old password.

new_passwordstringrequired

New Password.

Response

Accepted

patch/users/me/password

Body

{ "old_password": "old_password", "new_password": "new_password" }
 

Get My Permissions

Returns the permissions for the current user

get
https://global.api.konghq.com/v2/users/me/permissions

Query Parameters

filterobject

Filter permissions returned in the response.

Show Child Parameters

Response

application/json

Example response

dataarray[object]
Show Child Parameters
get/users/me/permissions
 
application/json

Get My Organization

Returns the organization of the user identified in the token of the request.

get
https://global.api.konghq.com/v2/organizations/me

Response

application/json

Example response

idstring(uuid)read-only

UUID of the organization.

namestring

Name of the organization.

owner_idstring

Owner ID of the organization.

login_pathstring

Path to organization-specific login when single sign on (SSO) is enabled. Blank otherwise.

created_atstring(date-time)read-only

Date the organization was created.

updated_atstring(date-time)read-only

Date the organization was last updated.

statestring

State of the organization

Allowed values:activeinactivedeletingdeleted

retention_period_daysinteger

The number of days an organization spends inactive before being deleted.

get/organizations/me
 
application/json

Updates the current user's organization

This operation allows you to change the organization’s owner. The new user must be part of the organization’s admin team.

patch
https://global.api.konghq.com/v2/organizations/me

Body

application/json

The request schema to update an organization.

owner_idstring

The user id of the new owner of the organization. Must be a member of the organization’s admin team.

Example:YOUR_OWNER_ID

namestring

The new name of the organization.

Example:Kong Inc

Response

application/json

Example response

idstring(uuid)read-only

UUID of the organization.

namestring

Name of the organization.

owner_idstring

Owner ID of the organization.

login_pathstring

Path to organization-specific login when single sign on (SSO) is enabled. Blank otherwise.

created_atstring(date-time)read-only

Date the organization was created.

updated_atstring(date-time)read-only

Date the organization was last updated.

statestring

State of the organization

Allowed values:activeinactivedeletingdeleted

retention_period_daysinteger

The number of days an organization spends inactive before being deleted.

patch/organizations/me

Body

{ "owner_id": "df120cb4-f60b-47bc-a2f8-6a28e6a3c63b", "name": "Kong Inc" }
 
application/json