Savannah Cloud

Team Management

Manage members, roles, and invitations inside an org.

Team management is restricted to owners and admins.


List members

GET /org/members
Authorization: Bearer <token>

Response 200

[
  {
    "id": "usr_abc",
    "email": "admin@acme.com",
    "role": "owner",
    "joined_at": "2026-05-01T09:00:00Z"
  },
  {
    "id": "usr_def",
    "email": "dev@acme.com",
    "role": "member",
    "joined_at": "2026-05-10T14:30:00Z"
  }
]

Invite a member

POST /org/invite
Authorization: Bearer <token>
Content-Type: application/json

Request body

{
  "email": "dev@company.com",
  "role": "member"
}

Response 201

{
  "invite_url": "https://your-app.com/join?token=abc123...",
  "email": "dev@company.com",
  "expires_at": "2026-05-27T10:00:00Z"
}

Invite links are single-use and expire after 72 hours.


Remove a member

DELETE /org/members/{user_id}
Authorization: Bearer <token>

Response 204 No Content

Owners cannot remove themselves.


Role reference

RoleInviteRemove membersManage jobsManage API keys
owner✓✓✓✓
admin✓✗✓✓
member✗✗✓✓

Quick examples

# List members
curl http://localhost:8080/org/members \
  -H "Authorization: Bearer YOUR_JWT"

# Invite a member
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"}'

# Remove member
curl -X DELETE http://localhost:8080/org/members/usr_def \
  -H "Authorization: Bearer YOUR_JWT"

On this page