Team & Invitations
Invite colleagues into your org and manage roles safely.
Savannah Cloud uses a token-based invite flow. An org owner or admin generates a link, sends it to a teammate, and the recipient completes signup inside the org.
Invite flow
Owner → POST /org/invite → receives invite_url
Owner → sends link to teammate
Teammate → opens /join?token=... → sets password
Teammate → is added to the org and logged inSend an invite
From the dashboard:
- go to Team
- enter the teammate email
- choose a role
- send the invite
Via API:
curl -X POST http://localhost:8080/org/invite \
-H "Authorization: Bearer YOUR_JWT" \
-H "Content-Type: application/json" \
-d '{"email":"dev@company.com","role":"member"}'Response:
{
"invite_url": "https://your-app.com/join?token=abc123...",
"email": "dev@company.com",
"expires_at": "2026-05-27T10:00:00Z"
}Manage members
List current org members:
curl http://localhost:8080/org/members \
-H "Authorization: Bearer YOUR_JWT"Remove a member:
curl -X DELETE http://localhost:8080/org/members/usr_def \
-H "Authorization: Bearer YOUR_JWT"Role reference
| Role | Who assigns it | What they can do |
|---|---|---|
owner | auto-assigned to org creator | full access, billing, deploys, invites, and member management |
admin | owner may assign | manage deployments and internal permissions |
member | default for invited users | work on basic project tasks and job access |
Invite links expire after 72 hours and are single-use. Reissue an invite if it expires before acceptance.