Convida un membre
Per correu electrònic, amb un rol i, opcionalment, amb adreces i dominis sencers que s'atorguen quan accepten.
Executa la crida real contra el teu espai de treball, amb la teva pròpia clau.
POST /members
Per correu electrònic, amb un rol i, opcionalment, amb adreces i dominis sencers que s'atorguen quan accepten.
Exemple
Necessita members:write. Retorna 202 amb la invitació. Ningú no és a l'espai de treball fins que l'accepta. access té el valor predeterminat member i s'aplica a tots els id d'addressIds i 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"}TOTHOM ÉS CONVIDAT. Tant si l'adreça ja té un compte d'OpenEmail com si no, la resposta és una invitació i un 202, mai un membre. Ningú no entra en un espai de treball sense acceptar-ho, i aquest endpoint està subjecte a la mateixa regla que l'aplicació. Algú que ja és a l'espai de treball es rebutja amb member_is_owner, un 422: canvia el que pot fer amb PATCH /members/{userId} i les crides de concessió.
La invitació porta el rol, les adreces i els dominis sencers que hi indiques, i concedeix exactament això en el moment en què s'accepta. Abans, no es concedeix res. Un domini sencer cobreix totes les adreces que té, incloses les creades després d'enviar la invitació.
POST en comptes de PUT sobre un id d'usuari, perquè qui fa la crida no coneix l'id d'usuari i pot estar convidant algú que encara no té compte. El que coneix és una adreça de correu.
Demanar-ho dues vegades en deu minuts dona invitation_too_soon, un 409. Passat aquest temps, refresca l'única invitació pendent, encunya un enllaç nou i retira l'antic, en comptes d'enviar-ne una segona.
delivered: false vol dir que la invitació existeix però que el correu no ha sortit del servidor de correu. deliveryError diu què ha dit el servidor. No els ha arribat res, així que torna-la a enviar des de l'aplicació un cop passat el període d'espera.
invitedBy es deixa deliberadament a null en comptes d'atribuir-lo al propietari de l'espai de treball. La columna registra quina PERSONA ha convidat algú, i una clau d'API no és una persona.
El propietari de l'espai de treball es rebutja amb member_is_owner, un 422. No és un membre i no se'n pot fer un.