POST /v1/import

Bulk-import memories from an export payload or a programmatic source. Items are processed independently; failures are reported per-item.

For the complementary export endpoint, see POST /v1/export. For the equivalent operation on raw recall content, see POST /v1/bulk-remember.

Request

{
  "tenant_id": "engineering",
  "memories": [
    { "content": "Decision: gRPC for internal APIs.",
      "metadata": { "channel": "#decisions" },
      "scope": "decisions" },
    { "content": "Incident: payments-db replication lag spike at 02:14 UTC.",
      "scope": "incidents" }
  ]
}

| Field | Type | Required | Description | |---|---|---|---| | tenant_id | string | No | Sub-tenant scope | | memories[] | array | Yes | Items to import | | memories[].content | string | Yes | Memory content | | memories[].metadata | object | No | string→string metadata | | memories[].scope | string | No | Scope qualifier |

Response

{
  "imported": 2,
  "failed": 0,
  "event_ids": [
    "01912a3b-…-1",
    "01912a3b-…-2"
  ]
}

| Field | Type | Description | |---|---|---| | imported | integer | Successful items | | failed | integer | Failed items | | event_ids[] | array | Stored event UUIDs in input order |