Skip to main content
POST
/
v1
/
regions
/
global
/
iam
/
groups
/
{groupId}
/
members
Add member to group
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({userId: 'user-v5w6x7'})
};

fetch('https://api.k0rdent.ai/v1/regions/global/iam/groups/{groupId}/members', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "id": "member-a1b2c3",
  "groupId": "group-d5e6f7",
  "userId": "user-v5w6x7",
  "addedAt": "2023-11-07T05:31:56Z",
  "selfLink": "/v1/regions/global/iam/groups/group-d5e6f7/members/member-a1b2c3",
  "displayName": "<string>",
  "email": "jsmith@example.com",
  "addedBy": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer token authentication using OAuth2/OIDC tokens

Path Parameters

​
groupId
string
required

Group resource identifier.

Body

application/json
​
userId
string
required

User identifier to add as a group member.

Example:

"user-v5w6x7"

Response

Member added to the group.

A membership record linking a user to a group. Addressable as a sub-resource of the parent group.

​
uid
string<uuid>
required

Server-generated UUID. Immutable.

​
id
string
required

Resource identifier. Server-generated, immutable.

Example:

"member-a1b2c3"

​
groupId
string
required

The parent group this membership belongs to.

Example:

"group-d5e6f7"

​
userId
string
required

User identifier of the group member.

Example:

"user-v5w6x7"

​
addedAt
string<date-time>
required

Timestamp when the member was added to the group.

​
selfLink
string<uri>

Server-defined URL for this resource.

Example:

"/v1/regions/global/iam/groups/group-d5e6f7/members/member-a1b2c3"

​
displayName
string

Display name of the member (read-only, denormalized from the user record).

​
email
string<email>

Email of the member (read-only, denormalized from the user record).

​
addedBy
string

User or service account ID that added this member.