Source: https://docs.any.org/tutorial/objects.html

# 1. Objects

An object is a row in the space's `objects` storage collection. In the simplest case it is a plain `page`: a name, a description and the stamps the server derives. That is enough for a notebook, and it is the level every later part builds on.

`API` and `SPACE` come from the [tutorial setup](https://docs.any.org/tutorial/index.md.txt#before-you-start).

## Create one

```bash
OBJ=$(curl -fsS "$API/spaces/$SPACE/objects" -H 'content-type: application/json' \
  -d '{"type": "page", "initialProperties": {"any": {"name": "Groceries", "description": "for Saturday"}}}' \
  | jq -er .objectId)
printf 'Object: %s\n' "$OBJ"
```

```json
{ "objectId": "bafyreib…" }
```

The create body has three keys: `type` — **required**, the one type the object is — `collections` (optional, what it is filed under) and `initialProperties` (starting values, grouped by owner). The group `any` is the **universal** property group every object has: `name`, `description`, `icon`, `tags`, plus `type` and `collections`. It is not something you set; it is the base every object starts from, and it is where the system keeps track of the type and the collections the object does have.

`page` is the built-in plain document — the right type when the thing is just a note. Every object has exactly one type and it is never cleared; [Part 2](https://docs.any.org/tutorial/properties.md.txt) defines a type of your own, then files objects under a collection.

`jq` kept the id in `OBJ`; every later call uses it.

## Read it back

Reads are POSTs with a Mongo-style body against the space's `objects` storage collection:

```bash
curl -s -X POST $API/spaces/$SPACE/objects/query -H 'content-type: application/json' \
  -d '{"filter": {"id": "'$OBJ'"}}'
```

```json
{ "records": [ {
  "id": "bafyreib…",
  "any": { "type": "page", "name": "Groceries", "description": "for Saturday" },
  "author": "A8tR…", "spaceId": "bafyreig…",
  "createdAt":  { "$date": "2026-09-08T10:00:00.000Z" },
  "modifiedAt": { "$date": "2026-09-08T10:00:00.000Z" },
  "modifiedBy": "A8tR…",
  "_ver": { "…": "…" }
} ] }
```

`author`, `createdAt`, `modifiedAt` and `modifiedBy` are derived by the server and read-only. `modifiedAt` bumps on every synced write and `modifiedBy` names who signed it, so "recently edited" is `{"sort": ["-modifiedAt"]}` with no work on your side ([System fields](https://docs.any.org/database/system-fields.md.txt)).

Make a few more objects, then list them newest first:

```bash
curl -s -X POST $API/spaces/$SPACE/objects/query -H 'content-type: application/json' \
  -d '{"sort": ["-modifiedAt"], "limit": 20, "includeTotal": true}'
```

Filters use the same grammar throughout the system — `{"any.name": "Groceries"}`, `{"createdAt": {"$gte": {"$date": "2026-09-01T00:00:00Z"}}}`, and from Part 2 on `{"any.type": "<typeId>"}` for the type and `{"any.collections": "<collectionId>"}` for membership in a collection (an array field matches on any element). The full grammar is in [Reading data](https://docs.any.org/database/reading-data.md.txt).

## Watch it change

Every query has a live twin. Same body, sibling path, and the response is a server-sent event stream. The stream blocks this terminal, so first print the variables you will need in the second one:

```bash
printf 'API=%s\nSPACE=%s\nOBJ=%s\n' "$API" "$SPACE" "$OBJ"
```

Then start the stream in your current terminal:

```bash
curl -s -N -X POST $API/spaces/$SPACE/objects/query/subscribe -H 'content-type: application/json' \
  -d '{"sort": ["-modifiedAt"], "limit": 20}'
```

```
event: ready
data: {}

event: snapshot
data: {"records":[{"id":"bafyreib…", "any": {"name": "Groceries", …}}]}
```

Leave it open. From another terminal (paste the three assignments first), rename the object — a property write on the `any` group:

```bash
curl -s -X POST $API/spaces/$SPACE/properties/$OBJ/set/any -H 'content-type: application/json' \
  -d '{"patch": {"name": "Groceries (Saturday)"}}'
```

The stream prints the delta:

```
event: changes
data: [{"versionId":"…",
        "updated":[{"id":"bafyreib…","doc":{…},
                    "ops":[{"type":"$set","path":["any","name"],"payload":"Groceries (Saturday)"}]}]}]
```

That is the whole reactive model: a snapshot, then `added` / `updated` / `removed` entries for as long as the connection is open — each batch carries only the lists that have something in them. Renames from your other devices, and from every member of the space, arrive on the same stream ([Subscribe](https://docs.any.org/realtime/subscribe.md.txt)).

> **Why it matters.** The write above returned before any network traffic happened. It landed in the object's change log on this device, the query saw it immediately, and sync to other devices runs in the background whenever a peer is reachable ([Local-first](https://docs.any.org/understanding/local-first.md.txt)). Nothing in this part changes when you are offline.

## What a write returns

No write echoes the record. Create answers with the new `objectId`, as above, delete with no content, and every property and dataset write returns the same small receipt:

```json
{ "versionId": "…", "changeId": "bafyreic…", "recordIds": ["bafyreib…"] }
```

`changeId` is the content address of the change — the handle [version history](https://docs.any.org/database/version-history.md.txt) works with. Read the row back through the query, or let your open subscription deliver it.

## Delete

Back in the terminal that holds `OBJ` (Ctrl-C the stream first):

```bash
curl -s -X DELETE $API/spaces/$SPACE/objects/$OBJ     # → 204
```

The row disappears from every query, and open subscriptions see the id under `removed` with `"reason": "deleted"`.

## Where this level ends

You now have named, described pages that sync and stream. What you do not have is a *shape*: nothing says a grocery list has a store and a budget, and nothing lets you ask "every list for the store on Main Street". A name and a description are all the columns there are. The next part adds columns — a type with properties — and that is already enough for a password manager.

Next: [2. Properties](https://docs.any.org/tutorial/properties.md.txt). Reference: [Objects](https://docs.any.org/database/objects.md.txt).