---
title: "Import Memory Interchange Format"
method: POST
path: "/memory/import-mif"
tags: ["Memory"]
---

# Import Memory Interchange Format

`POST /memory/import-mif`

## Request

- Base URL: `https://synchronex.ai/api/v1`
- URL: `https://synchronex.ai/api/v1/memory/import-mif`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://synchronex.ai/oauth/authorize`, token URL `https://synchronex.ai/api/oauth/token`, scopes: `read`)

Stages or applies a MIF 0.1 import. Raw text can be normalized into an identity-only MIF import.

## Request body

- object
  - `mif` MemoryInterchangeFormat
    - `mif_version` '0.1', required
    - `provenance` object, required
    - `identity_kernel` object, required
    - `user_corpus` object[]
    - `decisions` Decision[]
      - `id` string, uuid
      - `decision` string
      - `reasoning` string, nullable
      - `tags` string[]
      - `product_name` string, nullable
      - `affects_products` string[]
      - `decided_at` string, date-time
    - `metadata` object
  - `raw_content` string
  - `merge_strategy` 'merge' | 'replace' | 'append'
  - `apply_immediately` boolean
  - `workspace_id` string, uuid

## Response `200`

MIF import accepted.

- object
  - `status` string
  - `corpus_imported` integer
  - `decisions_imported` integer
  - `conflicts` string[]

## Other responses

- `400`: Validation error. The request body or query string is invalid.
- `401`: Unauthorized. Missing, malformed, expired, or revoked bearer token.
- `403`: Forbidden. The token scope or account tier is insufficient.
- `429`: Rate limit exceeded. Retry after the indicated reset time.
- `500`: Internal server error.

---

[API](https://skmtc.dev/synchronex/apis/synchronex-api.md) · [All operations](https://skmtc.dev/synchronex/apis/synchronex-api/llms.txt) · [OpenAPI document](https://skmtc.dev/synchronex/apis/synchronex-api/revisions/aa1e0df0a8d5?raw)