Skip to main content
POST
/
v2
/
environments
/
{environmentId}
/
members
Add Member
curl --request POST \
  --url https://api.tusky.io/v2/environments/{environmentId}/members \
  --header 'Content-Type: application/json' \
  --data '
{
  "address": "<string>",
  "role": "<string>"
}
'
{
  "id": "<string>",
  "address": "<string>",
  "role": "<string>",
  "environmentId": "<string>",
  "createdAt": "<string>"
}
Add a new member to an environment by their Sui wallet address. Members can be assigned different roles that control their level of access.

Path Parameters

environmentId
string
required
The unique identifier of the environment.

Request Body

address
string
required
The Sui wallet address of the user to add as a member.
role
string
required
The role to assign to the member. One of:
  • viewer — read-only access to environment files
  • manager — can upload, download, and delete files
  • owner — full access including member management

Response

id
string
Unique identifier for the membership.
address
string
The Sui wallet address of the member.
role
string
The assigned role (viewer, manager, or owner).
environmentId
string
The environment this membership belongs to.
createdAt
string
ISO 8601 timestamp of when the member was added.

Example

curl -X POST https://api.tusky.io/v2/environments/env_abc123def456/members \
  -H "Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "0x1a2b3c4d5e6f7890abcdef1234567890abcdef12",
    "role": "manager"
  }'

Response

{
  "id": "member_stu901vwx234",
  "address": "0x1a2b3c4d5e6f7890abcdef1234567890abcdef12",
  "role": "manager",
  "environmentId": "env_abc123def456",
  "createdAt": "2025-07-02T10:00:00.000Z"
}
Only the environment owner can add new members. The invited user’s Sui wallet address must be valid.