Organizations

GET/api/v1/organizations

Returns

objectstringrequired

dataarrayrequired

Show child attributes

idstringrequired

The organization's own id

namestringnullable

Organization name; null for the Personal organization

typestringrequired

rolestringrequired

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.

createdAtstring · date-timerequired

Request

curl https://app.mobilenext.ai/api/v1/organizations \
  -X GET \
  -H 'Authorization: Bearer mob_...'

Response

Organizations the caller is a member of, with their role in each

{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "type": "hobby",
      "role": "admin",
      "createdAt": "2026-01-01T00:00:00Z"
    }
  ]
}

POST/api/v1/organizations

Creates an organization owned by the caller (who becomes its admin). The name is required, cannot be "Personal", and cannot duplicate the name of an organization the caller already belongs to.

Body parameters

namestringrequired

Organization name; required, not "Personal", unique among the caller's organizations

Returns

idstringrequired

The organization's own id

namestringnullable

Organization name; null for the Personal organization

typestringrequired

rolestringrequired

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.

createdAtstring · date-timerequired

Request

curl https://app.mobilenext.ai/api/v1/organizations \
  -X POST \
  -H 'Authorization: Bearer mob_...' \
  -H 'Content-Type: application/json' \
  -d '{"name":"string"}'

Response

Organization created

{
  "id": "string",
  "name": "string",
  "type": "hobby",
  "role": "admin",
  "createdAt": "2026-01-01T00:00:00Z"
}

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

Returns the active members of the organization. The caller must be a member of the organization.

Path parameters

idstringrequired

Organization id

Returns

objectstringrequired

dataarrayrequired

Show child attributes

userstring · uuidrequired

Reference to the user

emailstring · emailrequired

namestringnullable

rolestringrequired

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.

joinedAtstring · date-timerequired

Request

curl https://app.mobilenext.ai/api/v1/organizations/{id}/members \
  -X GET \
  -H 'Authorization: Bearer mob_...'

Response

Active members of the organization

{
  "object": "list",
  "data": [
    {
      "user": "string",
      "email": "string",
      "name": "string",
      "role": "admin",
      "joinedAt": "2026-01-01T00:00:00Z"
    }
  ]
}

PATCH/api/v1/organizations/{id}

Renames the organization. Admin only. Not available for the Personal organization, nor to API keys. The name cannot be blank, cannot be "Personal", and cannot be the name of another organization the caller belongs to.

Path parameters

idstringrequired

Organization id

Body parameters

namestringrequired

New name. Same rules as create: not blank, not "Personal", not the name of another organization the caller belongs to.

Returns

idstringrequired

The organization's own id

namestringnullable

Organization name; null for the Personal organization

typestringrequired

rolestringrequired

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.

createdAtstring · date-timerequired

Request

curl https://app.mobilenext.ai/api/v1/organizations/{id} \
  -X PATCH \
  -H 'Authorization: Bearer mob_...' \
  -H 'Content-Type: application/json' \
  -d '{"name":"string"}'

Response

Organization renamed

{
  "id": "string",
  "name": "string",
  "type": "hobby",
  "role": "admin",
  "createdAt": "2026-01-01T00:00:00Z"
}

DELETE/api/v1/organizations/{id}

Deletes the organization. Its members and API keys can no longer use it. Admin only, and only once the caller is its sole member; refused while a plan still renews (a plan already set to cancel at period end does not block) or a device is still allocated. Not available for the Personal organization, nor to API keys.

Path parameters

idstringrequired

Organization id

PATCH/api/v1/organizations/{id}/members/{userId}

Sets another member's role. Admin only. A caller can never change their own role: every change is made by an admin who stays an admin, so an organization cannot lose its last admin. Applies on the member's next request.

Path parameters

idstringrequired

Organization id

userIdstringrequired

The member's `user` id as returned by the members list (URL-encoded), or the literal `me` for the caller.

Body parameters

rolestringrequired

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

userstring · uuidrequired

Reference to the user

emailstring · emailrequired

namestringnullable

rolestringrequired

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.

joinedAtstring · date-timerequired

Request

curl https://app.mobilenext.ai/api/v1/organizations/{id}/members/{userId} \
  -X PATCH \
  -H 'Authorization: Bearer mob_...' \
  -H 'Content-Type: application/json' \
  -d '{"role":"admin"}'

Response

Role changed

{
  "user": "string",
  "email": "string",
  "name": "string",
  "role": "admin",
  "joinedAt": "2026-01-01T00:00:00Z"
}

DELETE/api/v1/organizations/{id}/members/{userId}

Removes a member from the organization. When userId is the caller (or me) this is a leave, allowed to any member; otherwise the caller must be an admin. The last admin cannot leave: make another member an admin first, or delete the organization. The removed member's API keys for this organization stop working.

Path parameters

idstringrequired

Organization id

userIdstringrequired

The member's `user` id as returned by the members list (URL-encoded), or the literal `me` for the caller.

List organizations the caller belongs to

Create a new organization

List organization members

Rename an organization

Delete an organization

Change a member's role

Remove a member, or leave

List organizations the caller belongs to​

Create a new organization​

List organization members​

Rename an organization​

Delete an organization​

Change a member's role​

Remove a member, or leave​

List organizations the caller belongs to

Create a new organization

List organization members

Rename an organization

Delete an organization

Change a member's role

Remove a member, or leave