# Organizations

## List organizations the caller belongs to[​](#list-organizations "Direct link to List organizations the caller belongs to")

GET/api/v1/organizations

Returns

`object`stringrequired

`data`arrayrequired

Show child attributes

`id`stringrequired

The organization's own id

`name`stringnullable

Organization name; null for an unnamed (Personal) org

`type`stringrequired

`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.

`createdAt`string · date-timerequired

Request

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

  -X GET \

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

Response

200401403500

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

```
{

  "object": "list",

  "data": [

    {

      "id": "string",

      "name": "string",

      "type": "starter",

      "role": "admin",

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

    }

  ]

}
```

## Create a new organization[​](#create-organization "Direct link to Create a new organization")

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

`name`stringrequired

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

Returns

`id`stringrequired

The organization's own id

`name`stringnullable

Organization name; null for an unnamed (Personal) org

`type`stringrequired

`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.

`createdAt`string · date-timerequired

Request

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

  -X POST \

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

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

  -d '{"name":"string"}'
```

Response

201400401409

Organization created

```
{

  "id": "string",

  "name": "string",

  "type": "starter",

  "role": "admin",

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

}
```