Sessions

List sessions

GET/api/v1/sessions

Sessions in the selected organization, visible to every member of it, newest first, with cursor pagination. The organization is chosen by the X-Organization-Id header, or the organization the API key is bound to, otherwise the caller's default organization.

Query parameters

limitinteger

Maximum sessions to return (default 100, max 500)

beforestring · date-time

Cursor: return sessions created strictly before this RFC3339 timestamp

Header parameters

X-Organization-Idstring

Selects which of the caller's organizations the request acts on. When omitted, the caller's default organization is used.

Returns

objectstringrequired

dataarrayrequired

Show child attributes

idstring · uuidrequired

The session's own id

titlestringnullable

Human-readable title; may be null

userstringrequired

User who created this session

devicesarrayrequired

Device allocations linked to this session, ordered by createdAt ascending

Show child attributes

idstring · uuidrequired

Globally unique device id. Always present, even when no physical device is attached.

statusstringrequired

Device lifecycle status. More values will be added.

infoobjectrequired

Descriptive attributes of the device.

Show child attributes

platformstringrequired

typestringrequired

namestringrequired

osVersionstringrequired

createdAtstring · date-timerequired

When the device was added to the session

releasedAtstring · date-timenullable

When the device was released (billing end)

instancesarray

Instances linked to this session, ordered by createdAt ascending

Show child attributes

idstring · uuidrequired

The instance's own id

statusstringrequired

Lifecycle: provisioning -> ready, then released, or failed if provisioning could not complete

osstringrequired

Instance operating system. Only macos is supported today.

imagestringrequired

Server-assigned base image the instance booted from

machineobjectrequired

The compute backing an instance.

Show child attributes

archstringrequired

CPU architecture. Only arm64 is supported today.

cpuCoresintegerrequired

memoryMbintegerrequired

diskMbintegerrequired

createdAtstring · date-timerequired

When the instance was allocated (billing start)

readyAtstring · date-timenullable

When the instance finished provisioning; null while provisioning

releasedAtstring · date-timenullable

When the instance was released (billing end); null while active

createdAtstring · date-timerequired

nextCursorstringnullable

Cursor for the next page; absent when there are no more results

Request

curl https://api.mobilenexthq.com/api/v1/sessions \
  -X GET \
  -H 'Authorization: Bearer mob_...'

Response

Paginated list of sessions

{
  "object": "list",
  "data": [
    {
      "id": "string",
      "title": "string",
      "user": "string",
      "devices": [
        {
          "id": "string",
          "status": "provisioning",
          "info": {
            "platform": "ios",
            "type": "real",
            "name": "string",
            "osVersion": "string"
          },
          "createdAt": "2026-01-01T00:00:00Z",
          "releasedAt": "2026-01-01T00:00:00Z"
        }
      ],
      "instances": [
        {
          "id": "string",
          "status": "provisioning",
          "os": "macos",
          "image": "macos-15-xcode-16",
          "machine": {
            "arch": "arm64",
            "cpuCores": 8,
            "memoryMb": 16384,
            "diskMb": 262144
          },
          "createdAt": "2026-01-01T00:00:00Z",
          "readyAt": "2026-01-01T00:00:00Z",
          "releasedAt": "2026-01-01T00:00:00Z"
        }
      ],
      "createdAt": "2026-01-01T00:00:00Z"
    }
  ],
  "nextCursor": "string"
}

Create a session

POST/api/v1/sessions

Creates an empty session container. Attach resources to it separately: use fleet.allocate with sessionId to link a device, or allocate an instance with sessionId.

Header parameters

X-Organization-Idstring

Selects which of the caller's organizations the request acts on. When omitted, the caller's default organization is used.

Returns

idstring · uuidrequired

The session's own id

titlestringnullable

Human-readable title; may be null

userstringrequired

User who created this session

devicesarrayrequired

Device allocations linked to this session, ordered by createdAt ascending

Show child attributes

idstring · uuidrequired

Globally unique device id. Always present, even when no physical device is attached.

statusstringrequired

Device lifecycle status. More values will be added.

infoobjectrequired

Descriptive attributes of the device.

Show child attributes

platformstringrequired

typestringrequired

namestringrequired

osVersionstringrequired

createdAtstring · date-timerequired

When the device was added to the session

releasedAtstring · date-timenullable

When the device was released (billing end)

instancesarray

Instances linked to this session, ordered by createdAt ascending

Show child attributes

idstring · uuidrequired

The instance's own id

statusstringrequired

Lifecycle: provisioning -> ready, then released, or failed if provisioning could not complete

osstringrequired

Instance operating system. Only macos is supported today.

imagestringrequired

Server-assigned base image the instance booted from

machineobjectrequired

The compute backing an instance.

Show child attributes

archstringrequired

CPU architecture. Only arm64 is supported today.

cpuCoresintegerrequired

memoryMbintegerrequired

diskMbintegerrequired

createdAtstring · date-timerequired

When the instance was allocated (billing start)

readyAtstring · date-timenullable

When the instance finished provisioning; null while provisioning

releasedAtstring · date-timenullable

When the instance was released (billing end); null while active

createdAtstring · date-timerequired

Request

curl https://api.mobilenexthq.com/api/v1/sessions \
  -X POST \
  -H 'Authorization: Bearer mob_...'

Response

Session created

{
  "id": "string",
  "title": "string",
  "user": "string",
  "devices": [
    {
      "id": "string",
      "status": "provisioning",
      "info": {
        "platform": "ios",
        "type": "real",
        "name": "string",
        "osVersion": "string"
      },
      "createdAt": "2026-01-01T00:00:00Z",
      "releasedAt": "2026-01-01T00:00:00Z"
    }
  ],
  "instances": [
    {
      "id": "string",
      "status": "provisioning",
      "os": "macos",
      "image": "macos-15-xcode-16",
      "machine": {
        "arch": "arm64",
        "cpuCores": 8,
        "memoryMb": 16384,
        "diskMb": 262144
      },
      "createdAt": "2026-01-01T00:00:00Z",
      "readyAt": "2026-01-01T00:00:00Z",
      "releasedAt": "2026-01-01T00:00:00Z"
    }
  ],
  "createdAt": "2026-01-01T00:00:00Z"
}

Get a session

GET/api/v1/sessions/{sessionId}

Returns a session in the selected organization, visible to every member of it. The organization is chosen by the X-Organization-Id header, or the organization the API key is bound to, otherwise the caller's default organization.

Path parameters

sessionIdstring · uuidrequired

Session UUID

Header parameters

X-Organization-Idstring

Selects which of the caller's organizations the request acts on. When omitted, the caller's default organization is used.

Returns

idstring · uuidrequired

The session's own id

titlestringnullable

Human-readable title; may be null

userstringrequired

User who created this session

devicesarrayrequired

Device allocations linked to this session, ordered by createdAt ascending

Show child attributes

idstring · uuidrequired

Globally unique device id. Always present, even when no physical device is attached.

statusstringrequired

Device lifecycle status. More values will be added.

infoobjectrequired

Descriptive attributes of the device.

Show child attributes

platformstringrequired

typestringrequired

namestringrequired

osVersionstringrequired

createdAtstring · date-timerequired

When the device was added to the session

releasedAtstring · date-timenullable

When the device was released (billing end)

instancesarray

Instances linked to this session, ordered by createdAt ascending

Show child attributes

idstring · uuidrequired

The instance's own id

statusstringrequired

Lifecycle: provisioning -> ready, then released, or failed if provisioning could not complete

osstringrequired

Instance operating system. Only macos is supported today.

imagestringrequired

Server-assigned base image the instance booted from

machineobjectrequired

The compute backing an instance.

Show child attributes

archstringrequired

CPU architecture. Only arm64 is supported today.

cpuCoresintegerrequired

memoryMbintegerrequired

diskMbintegerrequired

createdAtstring · date-timerequired

When the instance was allocated (billing start)

readyAtstring · date-timenullable

When the instance finished provisioning; null while provisioning

releasedAtstring · date-timenullable

When the instance was released (billing end); null while active

createdAtstring · date-timerequired

Request

curl https://api.mobilenexthq.com/api/v1/sessions/{sessionId} \
  -X GET \
  -H 'Authorization: Bearer mob_...'

Response

Session detail

{
  "id": "string",
  "title": "string",
  "user": "string",
  "devices": [
    {
      "id": "string",
      "status": "provisioning",
      "info": {
        "platform": "ios",
        "type": "real",
        "name": "string",
        "osVersion": "string"
      },
      "createdAt": "2026-01-01T00:00:00Z",
      "releasedAt": "2026-01-01T00:00:00Z"
    }
  ],
  "instances": [
    {
      "id": "string",
      "status": "provisioning",
      "os": "macos",
      "image": "macos-15-xcode-16",
      "machine": {
        "arch": "arm64",
        "cpuCores": 8,
        "memoryMb": 16384,
        "diskMb": 262144
      },
      "createdAt": "2026-01-01T00:00:00Z",
      "readyAt": "2026-01-01T00:00:00Z",
      "releasedAt": "2026-01-01T00:00:00Z"
    }
  ],
  "createdAt": "2026-01-01T00:00:00Z"
}