API för teammedlemmar

Underhålls av: Aether365 Team Målgrupp: Utvecklare Omfattning: API-endpoints för teammedlemmar - hantera användaråtkomst

Auktorisering

Endpoints för teammedlemmar använder rollbaserad åtkomstkontroll:

Endpoint	Tillåtna roller
Lista medlemmar	Owner, Admin, Member
Bjuda in en medlem	Owner, Admin
Ändra en medlems roll	Owner
Ta bort en medlem	Owner

---

Lista teammedlemmar

Returnerar alla medlemmar i det autentiserade tenant-kontot.

GET /tenants/me/members

Exempelbegäran

curl https://api.aether365.io/tenants/me/members \
  -H "Authorization: Bearer <token>"

Exempelsvar

{
  "success": true,
  "data": [
    {
      "id": "mem_abc123",
      "email": "alice@example.com",
      "status": "active",
      "role": "owner",
      "invitedAt": "2026-01-15T10:00:00Z",
      "joinedAt": "2026-01-15T10:30:00Z"
    },
    {
      "id": "mem_def456",
      "email": "bob@example.com",
      "status": "active",
      "role": "member",
      "invitedAt": "2026-02-01T09:00:00Z",
      "joinedAt": "2026-02-01T11:00:00Z"
    },
    {
      "id": "mem_ghi789",
      "email": "carol@example.com",
      "status": "pending",
      "role": "member",
      "invitedAt": "2026-04-10T08:00:00Z",
      "joinedAt": null
    }
  ]
}

Svarsfält

Fält	Typ	Beskrivning
id	string	Medlemsidentifierare
email	string	Medlemmens e-postadress
status	string	active eller pending
role	string	owner, admin eller member
invitedAt	string	ISO 8601-tidsstämpel för inbjudan
joinedAt	string eller null	ISO 8601-tidsstämpel när inbjudan accepterades

---

Bjuda in en teammedlem

Skickar en inbjudan via e-post till en ny teammedlem.

POST /tenants/me/members/invite

Begärandekropp

{
  "email": "newmember@example.com",
  "role": "member"
}

Fält	Typ	Obligatoriskt	Standard	Beskrivning
email	string	Ja	-	E-postadress att bjuda in
role	string	Nej	"member"	"member" eller "admin"

Exempelbegäran

curl -X POST https://api.aether365.io/tenants/me/members/invite \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"email": "newmember@example.com", "role": "member"}'

Exempelsvar

{
  "success": true,
  "data": {
    "id": "mem_xyz999",
    "email": "newmember@example.com",
    "status": "pending",
    "role": "member",
    "invitedAt": "2026-04-12T10:00:00Z",
    "joinedAt": null
  }
}

Fel

Kod	HTTP	Beskrivning
MEMBER_LIMIT_REACHED	429	Plangräns för medlemmar nådd
MEMBER_ALREADY_EXISTS	409	E-postadressen är redan medlem eller har en väntande inbjudan
VALIDATION_ERROR	400	Ogiltig e-postadress

---

Ändra en medlems roll

Ändrar rollen för en befintlig teammedlem.

PATCH /tenants/me/members/{memberId}

WARNING

Endast kontoägaren (Owner) kan ändra roller. Admins kan inte ändra roller.

Begärandekropp

{
  "role": "admin"
}

Fält	Typ	Obligatoriskt	Beskrivning
role	string	Ja	Ny roll: "member" eller "admin"

Exempelbegäran

curl -X PATCH https://api.aether365.io/tenants/me/members/mem_def456 \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"role": "admin"}'

Exempelsvar

{
  "success": true,
  "data": {
    "id": "mem_def456",
    "email": "bob@example.com",
    "status": "active",
    "role": "admin",
    "invitedAt": "2026-02-01T09:00:00Z",
    "joinedAt": "2026-02-01T11:00:00Z"
  }
}

---

Ta bort en teammedlem

Tar bort en medlem från kontot. De förlorar omedelbart åtkomst.

DELETE /tenants/me/members/{memberId}

WARNING

Det är inte tillåtet att ta bort kontoägaren. Kontakta support för att överföra ägarskap.

Exempelbegäran

curl -X DELETE https://api.aether365.io/tenants/me/members/mem_def456 \
  -H "Authorization: Bearer <token>"

Exempelsvar

{
  "success": true,
  "data": null
}