Add member to group - ByCloud API

post/v1/iam/groups/{group_id}/members

Add member to group

Add a user or service account to a group

Path Parameters

group_id

string<uuid>required

path

Group ID

Example: "550e8400-e29b-41d4-a716-446655440000"

Request Body

required

Content-Type: application/json

principal_type

stringrequired

Enum: "user", "service_account"

principal_id

string<uuid>required

Responses

201

Member added

Content-Type: application/json

member

objectoptional

A member of a group (can be a user or service account)

400

Invalid request parameters

Content-Type: application/json

error

objectrequired

401

Authentication required or token invalid

Content-Type: application/json

error

objectrequired

403

Insufficient permissions

Content-Type: application/json

error

objectrequired

404

Resource not found

Content-Type: application/json

error

objectrequired

409

Already a member

Content-Type: application/json

error

objectrequired

500

Internal server error

Content-Type: application/json

error

objectrequired

curl -X POST "https://api.spo1.mycloud.com/v1/iam/groups/550e8400-e29b-41d4-a716-446655440000/members" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "principal_type": "user",
    "principal_id": "550e8400-e29b-41d4-a716-446655440000"
  }'