Add a team member

POSThttps://api.shadw.cloud/v1/teams/{slug}/members

Add a member to a team, or change an existing member's role. Returns the updated team.

Authentication

AuthorizationbearerToken

A platform API key (hive_…, created under Settings → API Keys) or a JWT of at most 1 hour from POST /v1/token, which is server-only once HIVE_JWT_SECRET is set. An API key scopes the request to the team it was created under.

Path parameters

slugstringRequired

The team slug.

Body parameters

emailstringRequired

The member's email.

role"owner" | "admin" | "member" | "viewer"Optional

Role to assign (default member).

ts

const response = await fetch('https://api.shadw.cloud/v1/teams/{slug}/members', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY', // hive_… (Settings → API Keys)
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "email": "email",
    "role": "owner"
  }),
});

const data = await response.json();
console.log(data);

Response

json

{
  "slug": "acme",
  "name": "Acme",
  "plan": "pro",
  "created_ms": 1781906630000,
  "members": [
    { "email": "dev@acme.com", "role": "member", "name": "", "added_ms": 1781906630000 }
  ],
  "sso_enabled": false,
  "updated_ms": 1781906630000
}

APIs & SDKs/shadw REST API/Add a team member