---
title: "Export a collection snapshot"
method: POST
path: "/v1/device-memory/snapshot/export"
tags: ["Device Memory"]
---

# Export a collection snapshot

`POST /v1/device-memory/snapshot/export`

Export a collection's full graph state as a
portable SnapshotEnvelope.

## Request body

- SnapshotExportRequest
  - `collection_id` string, uuid, required

## Response `200`

Successful Response

- NebulaResultsSnapshotEnvelope
  - `results` SnapshotEnvelopeOutput, required — Portable full snapshot owned by the client.
    - `collection_id` string, uuid, required
    - `created_at` string, date-time
    - `format_version` integer
    - `generation` integer
    - `graph` GraphPayload — A complete graph payload or a context subgraph payload.
      - `entities` EntityRecord[]
        - `category` string, nullable
        - `chunk_ids` string[]
        - `collection_id` string
        - `created_at` string, date-time, required
        - `description` string, nullable
        - `engram_id` string, required
        - `fts_terms` object, nullable
        - `id` string, required
        - `metadata` object
        - `name` string, required
        - `relationship_count` integer
        - `updated_at` string, date-time, required
      - `entity_description_embeddings` EmbeddingBlock — A positionally-aligned masked embedding matrix.
        - `dim` integer
        - `encoding` 'npy-base64'
        - `mask_b64` string
        - `values_b64` string
      - `relationship_description_embeddings` EmbeddingBlock — A positionally-aligned masked embedding matrix.
        - `dim` integer
        - `encoding` 'npy-base64'
        - `mask_b64` string
        - `values_b64` string
      - `relationship_relation_embeddings` EmbeddingBlock — A positionally-aligned masked embedding matrix.
        - `dim` integer
        - `encoding` 'npy-base64'
        - `mask_b64` string
        - `values_b64` string
      - `relationships` RelationshipRecord[]
        - `category` string, nullable
        - `chunk_ids` string[]
        - `collection_id` string
        - `created_at` string, date-time, required
        - `description` string, nullable
        - `engram_id` string, nullable
        - `id` string, required
        - `inference_metadata` object, nullable
        - `metadata` object
        - `object` string, nullable
        - `object_id` string, required
        - `predicate` string
        - `relationship_type` string, nullable
        - `subject` string, nullable
        - `subject_id` string, required
        - `temporal_precision` string, nullable
        - `updated_at` string, date-time, required
        - `valid_span` object, nullable
        - `weight` number, nullable
    - `root_hash` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/zeroset-inc/apis/nebula-api.md) · [All operations](https://skmtc.net/zeroset-inc/apis/nebula-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zeroset-inc/nebula-api/revisions/b1da2c0bb1ae/schema)