> ## Documentation Index > Fetch the complete documentation index at: https://mintlify.com/ably/docs/llms.txt > Use this file to discover all available pages before exploring further. # LiveObjects REST API The LiveObjects REST API provides HTTP access to LiveObjects state management functionality for server-side operations. Use this API to query object state, perform administrative tasks, and integrate LiveObjects with server-side workflows. ## Overview The LiveObjects REST API enables you to: * Query current state of LiveObjects * Retrieve object history * List objects in a namespace * Perform administrative operations ## Base URL All LiveObjects REST API requests use:


  ```text theme={null}
  https://rest.ably.io
  ```

## Authentication The LiveObjects REST API uses the same authentication as the standard [REST API](/docs/api/rest-api): ### Basic Authentication


  ```shell theme={null}
  curl https://rest.ably.io/liveobjects/my-namespace/objects/object-id \
    -u "{{API_KEY}}"
  ```

### Token Authentication


  ```shell theme={null}
  curl https://rest.ably.io/liveobjects/my-namespace/objects/object-id \
    -H "Authorization: Bearer {{TOKEN}}"
  ```

## Objects Query and manage LiveObject instances. ### Get Object Retrieve the current state of a LiveObject:


  ```shell theme={null}
  curl https://rest.ably.io/liveobjects/my-namespace/objects/object-id \
    -u "{{API_KEY}}"
  ```

Unique identifier for the object. Current state data of the object. Version identifier for the current state. Timestamp when the object was last modified. ### List Objects List all objects in a namespace:


  ```shell theme={null}
  curl https://rest.ably.io/liveobjects/my-namespace/objects \
    -u "{{API_KEY}}"
  ```

Maximum number of objects to return. Filter objects by ID prefix. ### Get Object History Retrieve the history of state changes for an object:


  ```shell theme={null}
  curl "https://rest.ably.io/liveobjects/my-namespace/objects/object-id/history?limit=50" \
    -u "{{API_KEY}}"
  ```

Start time in milliseconds since epoch. End time in milliseconds since epoch. Maximum number of history entries to return. Query direction: `forwards` or `backwards`. ## State Operations Query and modify object state. ### Update Object State Update the state of a LiveObject:


  ```shell theme={null}
  curl -X PATCH https://rest.ably.io/liveobjects/my-namespace/objects/object-id \
    -u "{{API_KEY}}" \
    -H "Content-Type: application/json" \
    -d '{
      "data": {
        "status": "active",
        "count": 42
      }
    }'
  ```

New state data to merge with existing state. Optional version for optimistic concurrency control. ### Delete Object Delete a LiveObject:


  ```shell theme={null}
  curl -X DELETE https://rest.ably.io/liveobjects/my-namespace/objects/object-id \
    -u "{{API_KEY}}"
  ```

## Namespaces Manage LiveObjects namespaces. ### Get Namespace Info Retrieve information about a namespace:


  ```shell theme={null}
  curl https://rest.ably.io/liveobjects/my-namespace \
    -u "{{API_KEY}}"
  ```

Namespace identifier. Number of objects in the namespace. Timestamp of last activity in milliseconds. ### List Namespaces List all LiveObjects namespaces:


  ```shell theme={null}
  curl https://rest.ably.io/liveobjects \
    -u "{{API_KEY}}"
  ```

## Subscriptions Manage subscriptions to LiveObjects state changes. ### Get Active Subscriptions Retrieve active subscriptions for an object:


  ```shell theme={null}
  curl https://rest.ably.io/liveobjects/my-namespace/objects/object-id/subscriptions \
    -u "{{API_KEY}}"
  ```

List of active subscriptions. Connection ID of the subscriber. Client ID of the subscriber. ## Error Handling The LiveObjects REST API uses standard HTTP status codes:


  ```json theme={null}
  {
    "error": {
      "code": 40160,
      "message": "Object not found",
      "statusCode": 404
    }
  }
  ```

Common errors: * `400` - Invalid request parameters * `401` - Authentication failed * `403` - Insufficient permissions * `404` - Object or namespace not found * `409` - Version conflict (optimistic concurrency) * `429` - Rate limit exceeded ## Rate Limits The LiveObjects REST API shares rate limits with the standard REST API: * State queries: Up to 50 requests per second * State updates: Up to 2,000 updates per second See [rate limits](/docs/platform/pricing/limits) for details. ## Examples ### Query Object State


  ```javascript theme={null}
  async function getObjectState(namespace, objectId) {
    const response = await fetch(
      `https://rest.ably.io/liveobjects/${namespace}/objects/${objectId}`,
      {
        headers: {
          'Authorization': `Basic ${btoa(API_KEY)}`
        }
      }
    );
    
    return await response.json();
  }
  ```

### Update Object State


  ```javascript theme={null}
  async function updateObjectState(namespace, objectId, newData) {
    const response = await fetch(
      `https://rest.ably.io/liveobjects/${namespace}/objects/${objectId}`,
      {
        method: 'PATCH',
        headers: {
          'Authorization': `Basic ${btoa(API_KEY)}`,
          'Content-Type': 'application/json'
        },
        body: JSON.stringify({
          data: newData
        })
      }
    );
    
    return await response.json();
  }
  ```

### List Objects in Namespace


  ```javascript theme={null}
  async function listObjects(namespace, prefix = '') {
    const url = new URL(
      `https://rest.ably.io/liveobjects/${namespace}/objects`
    );
    
    if (prefix) {
      url.searchParams.set('prefix', prefix);
    }
    
    const response = await fetch(url, {
      headers: {
        'Authorization': `Basic ${btoa(API_KEY)}`
      }
    });
    
    return await response.json();
  }
  ```

## Related Resources * [LiveObjects Documentation](/docs/liveobjects) * [REST API Reference](/docs/api/rest-api) * [LiveObjects SDK](/docs/api/realtime-sdk) * [State Synchronization Guide](/docs/liveobjects/state)