organisation
Add a member
/api/v1/organisation/members
Give a root role to an address. An address with no account gets one and an invitation; an existing account is told. An address attached to another organisation is refused.
key
Required scope: org:admin
Request body application/json
-
emailstring · requiredAddress of the person.
-
rolestring · requiredThe root role to give them.
-
first_namestring · optionalFirst name, for an address with no account yet.
-
last_namestring · optionalLast name, for an address with no account yet.
Response
201
Member
-
idintegerId of the member.
-
emailstringTheir address.
-
first_namestringFirst name; may be empty.
-
last_namestringLast name; may be empty.
-
rolestringRoot role:
admin,editororreader. -
registeredbooleanfalsewhile the person has not accepted their invitation.
Errors
-
401
No valid credential.
-
403
The credential lacks the required scope, or the account may not do this.
-
409
The current state of the content forbids the request.
-
422
A value is missing or malformed.
-
429
Too many requests;
Retry-Aftergives the seconds to wait.