# Invitations

## List invitations addressed to the caller[​](#list-incoming-invitations "Direct link to List invitations addressed to the caller")

GET/api/v1/invitations

Pending, unexpired invitations addressed to the caller's email across all organizations. Interactive (JWT) sessions only.

Returns

`object`stringrequired

`data`arrayrequired

Show child attributes

`id`string · uuidrequired

`organization`objectrequired

Reference to the inviting organization

Show child attributes

`id`stringrequired

Inviting organization id

`name`stringnullable

Inviting organization name

`role`stringrequired

Organization role. admin: manage members and billing, plus everything readwrite can do. readwrite: start sessions, create API keys, delete sessions. readonly: view sessions, API keys, and test results only.

`inviterEmail`stringnullable

Email of the inviter

`createdAt`string · date-timerequired

`expiresAt`string · date-timenullable

Request

```
curl https://api.mobilenexthq.com/api/v1/invitations \

  -X GET \

  -H 'Authorization: Bearer mob_...'
```

Response

200401403500

Pending invitations addressed to the caller

```
{

  "object": "list",

  "data": [

    {

      "id": "string",

      "organization": {

        "id": "string",

        "name": "string"

      },

      "role": "admin",

      "inviterEmail": "string",

      "createdAt": "2026-01-01T00:00:00Z",

      "expiresAt": "2026-01-01T00:00:00Z"

    }

  ]

}
```

## Accept an invitation[​](#accept-invitation "Direct link to Accept an invitation")

POST/api/v1/invitations/{invitationId}/accept

Accepts an invitation addressed to the caller, joining the organization with the invited role. Interactive (JWT) sessions only.

Path parameters

`invitationId`string · uuidrequired

Invitation UUID

Request

```
curl https://api.mobilenexthq.com/api/v1/invitations/{invitationId}/accept \

  -X POST \

  -H 'Authorization: Bearer mob_...'
```

Response

204401403404

Invitation accepted; the caller is now a member of the organization

```
// No response body
```

## Reject an invitation[​](#reject-invitation "Direct link to Reject an invitation")

POST/api/v1/invitations/{invitationId}/reject

Rejects (declines) an invitation addressed to the caller. Interactive (JWT) sessions only.

Path parameters

`invitationId`string · uuidrequired

Invitation UUID

Request

```
curl https://api.mobilenexthq.com/api/v1/invitations/{invitationId}/reject \

  -X POST \

  -H 'Authorization: Bearer mob_...'
```

Response

204401403404

Invitation rejected

```
// No response body
```

## List pending invitations for the organization[​](#list-organization-invitations "Direct link to List pending invitations for the organization")

GET/api/v1/organizations/{id}/invitations

Returns the pending invitations for the organization. Admin only.

Path parameters

`id`stringrequired

Organization id

Returns

`object`stringrequired

`data`arrayrequired

Pending invitations only

Show child attributes

`id`string · uuidrequired

`email`string · emailrequired

`role`stringrequired

Organization role. admin: manage members and billing, plus everything readwrite can do. readwrite: start sessions, create API keys, delete sessions. readonly: view sessions, API keys, and test results only.

`status`stringrequired

`inviter`string · uuidnullable

Reference to the inviting user

`createdAt`string · date-timerequired

`expiresAt`string · date-timenullable

Request

```
curl https://api.mobilenexthq.com/api/v1/organizations/{id}/invitations \

  -X GET \

  -H 'Authorization: Bearer mob_...'
```

Response

200401403404

Pending invitations for the organization

```
{

  "object": "list",

  "data": [

    {

      "id": "string",

      "email": "string",

      "role": "admin",

      "status": "pending",

      "inviter": "string",

      "createdAt": "2026-01-01T00:00:00Z",

      "expiresAt": "2026-01-01T00:00:00Z"

    }

  ]

}
```

## Invite a new member to the organization[​](#invite-organization-member "Direct link to Invite a new member to the organization")

POST/api/v1/organizations/{id}/invitations

Creates a pending invitation for an email with the given role. Admin only. Fails if the email already belongs to a member or already has a pending invitation.

Path parameters

`id`stringrequired

Organization id

Body parameters

`email`string · emailrequired

`role`stringrequired

Organization role. admin: manage members and billing, plus everything readwrite can do. readwrite: start sessions, create API keys, delete sessions. readonly: view sessions, API keys, and test results only.

Returns

`id`string · uuidrequired

`email`string · emailrequired

`role`stringrequired

Organization role. admin: manage members and billing, plus everything readwrite can do. readwrite: start sessions, create API keys, delete sessions. readonly: view sessions, API keys, and test results only.

`status`stringrequired

`inviter`string · uuidnullable

Reference to the inviting user

`createdAt`string · date-timerequired

`expiresAt`string · date-timenullable

Request

```
curl https://api.mobilenexthq.com/api/v1/organizations/{id}/invitations \

  -X POST \

  -H 'Authorization: Bearer mob_...' \

  -H 'Content-Type: application/json' \

  -d '{"email":"string","role":"admin"}'
```

Response

201400401403404409

Invitation created

```
{

  "id": "string",

  "email": "string",

  "role": "admin",

  "status": "pending",

  "inviter": "string",

  "createdAt": "2026-01-01T00:00:00Z",

  "expiresAt": "2026-01-01T00:00:00Z"

}
```

## Revoke a pending invitation[​](#revoke-organization-invitation "Direct link to Revoke a pending invitation")

DELETE/api/v1/organizations/{id}/invitations/{invitationId}

Revokes a pending invitation in the organization. Admin only.

Path parameters

`id`stringrequired

Organization id

`invitationId`string · uuidrequired

Invitation UUID

Request

```
curl https://api.mobilenexthq.com/api/v1/organizations/{id}/invitations/{invitationId} \

  -X DELETE \

  -H 'Authorization: Bearer mob_...'
```

Response

204401403404

Invitation revoked

```
// No response body
```