kobotoolbox / kpi / 12945523124

81%

master: 76%

push

github

feat(organizations): create endpoints to handle organization invitations TASK-969 (#5395)

### 📣 Summary
Implemented endpoints for organization invitations, allowing
organization owners to invite existing users or unregistered users to
join their organization. The invitee can either accept or decline the
invitation. If the invitee accepts, their assets will be transferred to
the organization.

### 📖 Description

- Organization owners can send invitations to users (both registered and
unregistered) via email or username.
- The invitee can accept or decline the invitation. If accepted, the
invitee's assets will be transferred to the organization owner.

> POST https://[kpi]/api/v2/organizations/org_12345/invites/

- Create organization invites for registered and unregistered users.
- Set the role for which the user is being invited - (Choices: `member`,
`admin`). Default is `member`.

Payload:
```
{
    "invitees": ["demo14", "demo13@demo13.com", "demo25@demo25.com"],
    "role": "admin"
}
```

Response:
```
[
    {
        "url": "http://kf.kobo.local/api/v2/organizations/org_12345/invites/7a4f9a3b-9112-43cc-a6ae-bb4a6583b4b2/",
        "invited_by": "http://kf.kobo.local/api/v2/users/gtl_raj/",
        "status": "pending",
        "invitee_role": "admin",
        "created": "2025-01-06T13:01:40Z",
        "modified": "2025-01-06T13:01:40Z",
        "invitee": "demo14"
    },
    {
        "url": "http://kf.kobo.local/api/v2/organizations/org_12345/invites/6746121a-7a87-4c2d-9994-85e38d8cff65/",
        "invited_by": "http://kf.kobo.local/api/v2/users/gtl_raj/",
        "status": "pending",
        "invitee_role": "admin",
        "created": "2025-01-06T13:01:40Z",
        "modified": "2025-01-06T13:01:40Z",
        "invitee": "demo13"
    },
    {
        "url": "http://kf.kobo.local/api/v2/organizations/org_12345/invites/2af706a9-4f67-4145-a0d3-8d66fbc77a19/",
        "invited_by": "http://kf.kobo.lo... (continued)

5916 of 9428 branches covered (62.75%)

248 of 261 new or added lines in 9 files covered. (95.02%)

22577 of 27979 relevant lines covered (80.69%)

0.81 hits per line