Skip to content
IxDocs

Fetch many live nodes in one read (Ix-memory 1.0.33+)

POST
/v1/nodes
curl --request POST \
  --url http://localhost:8090/v1/nodes \
  --header 'Content-Type: application/json' \
  --data '{ "ids": [ "example" ], "fields": "full" }'

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
ids
required

Node ids (UUIDs)

Array<string>
<= 1000 items
fields

Full returns whole nodes, attrs and provenance included

string
Allowed values: full

Responses

Section titled “Responses”

200

Section titled “200”

The live nodes, and the ids that are not live

Media typeapplication/json
object
rev
integer
nodes
Array<object>
object
id
required
string
kind
required
string
name
required
string
attrs
required
object
key
additional properties
any
provenance
required
object
sourceUri

Workspace-relative path

string
sourceHash
string
extractor
string
sourceType
string
observedAt
string format: date-time
createdRev
required
integer
deletedRev
integer
createdAt
required
string format: date-time
updatedAt
required
string format: date-time
missing
Array<string>

Example generated

{
  "rev": 1,
  "nodes": [
    {
      "id": "example",
      "kind": "example",
      "name": "example",
      "attrs": {},
      "provenance": {
        "sourceUri": "example",
        "sourceHash": "example",
        "extractor": "example",
        "sourceType": "example",
        "observedAt": "2026-04-15T12:00:00Z"
      },
      "createdRev": 1,
      "deletedRev": 1,
      "createdAt": "2026-04-15T12:00:00Z",
      "updatedAt": "2026-04-15T12:00:00Z"
    }
  ],
  "missing": [
    "example"
  ]
}

413

Section titled “413”

More than 1000 ids