Ftoni një anëtar
Me email, me një rol dhe, sipas dëshirës, me adresa e domene të tëra që i kalojnë sapo ta pranojë ftesën.
Ekzekuton thirrjen reale kundrejt hapësirës suaj të punës, me çelësin tuaj.
POST /members
Me email, me një rol dhe, sipas dëshirës, me adresa e domene të tëra që i kalojnë sapo ta pranojë ftesën.
Shembull
Kërkon members:write. Kthen 202 me ftesën. Askush nuk është në hapësirën e punës derisa ta pranojë atë. access si parazgjedhje është member dhe vlen për çdo id te addressIds dhe domainIds.
curl -X POST "$OE/members" -H "$AUTH" -H "Content-Type: application/json" \ -d '{ "email": "[email protected]", "roleId": "role_2b81de079c1f0a4b7e05d386", "domainIds": ["93542ff8-2baa-4f2f-841d-5ceaa074ab0d"], "access": "member" }'{ "object": "invitation", "id": "winv_6bb640f5b99e47deb758f1f5", "email": "[email protected]", "role": { "id": "role_2b81de079c1f0a4b7e05d386", "name": "Support", "builtin": null }, "addresses": [], "domains": [ { "domainId": "93542ff8-2baa-4f2f-841d-5ceaa074ab0d", "domain": "acme.com", "access": "member" } ], "expiresAt": "2026-10-02T14:07:31.000Z", "delivered": true, "deliveryError": null, "createdAt": "2026-09-18T14:07:31.000Z"}TË GJITHË FTOHEN. Pavarësisht nëse adresa ka tashmë një llogari OpenEmail, përgjigjja është një ftesë dhe një 202, kurrë një anëtar. Askush nuk futet në një hapësirë pune pa e pranuar, dhe ky endpoint i nënshtrohet të njëjtit rregull si aplikacioni. Dikush që është tashmë në hapësirën e punës refuzohet me member_is_owner, një 422: ndryshoni çfarë mund të bëjë me PATCH /members/{userId} dhe me thirrjet e dhënies së të drejtave.
Ftesa mbart rolin, adresat dhe domenet e tëra që emërtoni, dhe i jep pikërisht ato në çastin kur pranohet. Asgjë nuk jepet para kësaj. Një domen i tërë mbulon çdo adresë mbi të, përfshirë ato të krijuara pas dërgimit të ftesës.
POST e jo PUT mbi një id përdoruesi, sepse thirrësi nuk e di id-në e përdoruesit dhe mund të jetë duke ftuar dikë që nuk ka ende llogari. Ai di një adresë emaili.
Kërkesa e dytë brenda dhjetë minutash është invitation_too_soon, një 409. Pas kësaj, ftesa e vetme në pritje rifreskohet, krijohet një lidhje e re dhe e vjetra tërhiqet, në vend që të dërgohet një e dytë.
delivered: false do të thotë se ftesa ekziston, por emaili nuk doli nga serveri i postës. deliveryError thotë se çfarë tha serveri. Askujt nuk i mbërriti asgjë, ndaj dërgojeni sërish nga aplikacioni sapo të kalojë pritja.
invitedBy lihet qëllimisht null në vend që t’i atribuohet pronarit të hapësirës së punës. Kolona regjistron se cili PERSON ftoi dikë, dhe një çelës API nuk është person.
Pronari i hapësirës së punës refuzohet me member_is_owner, një 422. Ai nuk është anëtar dhe nuk mund të bëhet i tillë.