Savannah Cloud

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 in

Send 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

RoleWho assigns itWhat they can do
ownerauto-assigned to org creatorfull access, billing, deploys, invites, and member management
adminowner may assignmanage deployments and internal permissions
memberdefault for invited userswork 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.

On this page