Skip to content

API za člane ekipe

Avtorizacija

DejanjeOwnerAdminMember
Seznam članovDaDaDa
Povabilo članaDaDaNe
Sprememba vlogeDaNeNe
Odstranitev članaDaNeNe

Seznam članov ekipe

Vrne vse člane overjenega najemniškega računa.

GET /tenants/me/members

Primer zahteve

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

Primer odgovora

json
{
  "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
    }
  ]
}

Polja odgovora

PoljeVrstaOpis
idstringIdentifikator člana
emailstringE-poštni naslov člana
statusstringactive ali pending
rolestringowner, admin ali member
invitedAtstringČasovni žig ISO 8601 povabila
joinedAtstring ali nullČasovni žig ISO 8601, ko je bilo povabilo sprejeto

Povabilo člana ekipe

Pošlje povabilo po e-pošti novemu članu ekipe.

POST /tenants/me/members/invite

Telo zahteve

json
{
  "email": "newmember@example.com",
  "role": "member"
}
PoljeVrstaZahtevanoOpis
emailstringDaE-poštni naslov za povabilo
rolestringNeadmin ali member (privzeto: member)

Primer zahteve

bash
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"}'

Primer odgovora

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

Napake

KodaHTTPOpis
MEMBER_LIMIT_REACHED429Omejitev članov paketa je dosežena
MEMBER_ALREADY_EXISTS409Ta e-poštni naslov je že aktiven član ali ima čakajoče povabilo
VALIDATION_ERROR400Neveljaven e-poštni naslov

Sprememba vloge člana

Spremeni vlogo člana ekipe. Vloge lahko spreminja samo lastnik računa.

PATCH /tenants/me/members/{memberId}/role

Telo zahteve

json
{
  "role": "admin"
}
PoljeVrstaZahtevanoOpis
rolestringDaadmin ali member

WARNING

Vloge lastnika računa ni mogoče spremeniti. Za prenos lastništva se obrnite na podporo.

Primer zahteve

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

Primer odgovora

json
{
  "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"
  }
}

Odstranitev člana ekipe

Odstrani člana iz računa. Takoj izgubi dostop.

DELETE /tenants/me/members/{memberId}

WARNING

Odstranitev lastnika računa ni dovoljena. Za prenos lastništva se obrnite na podporo.

Primer zahteve

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

Primer odgovora

json
{
  "success": true,
  "data": null
}
Je bila ta stran uporabna?