---
title: "Push source-attributed memory records"
method: POST
path: "/partner/v1/source/items"
---

# Push source-attributed memory records

`POST /partner/v1/source/items`

## Request

- Base URL: `https://passport.ego.ist`
- URL: `https://passport.ego.ist/partner/v1/source/items`
- Auth: HTTP bearer

## Request body

- SourceItemsRequest
  - `items` object[], required
    - `external_id` string, required
    - `content` string, required: Maximum 8,000 UTF-8 bytes
    - `category` string
    - `occurred_at` string, date-time

## Response `200`

Per-item outcomes

- SourceItemsResponse
  - `source` string, required
  - `results` object[], required
    - `external_id` string, required
    - `status` 'stored' | 'duplicate' | 'rejected' | 'locked' | 'retry', required
    - `id` string, nullable

## Other responses

- `400`: Partner API error. Retry behavior depends on the status and error code.
- `401`: Bearer-token error
- `403`: Partner API error. Retry behavior depends on the status and error code.
- `429`: Partner API error. Retry behavior depends on the status and error code.
- `503`: Partner API error. Retry behavior depends on the status and error code.

---

[API](https://skmtc.dev/ego/apis/ai-passport-partner-api.md) - [All operations](https://skmtc.dev/ego/apis/ai-passport-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ego/apis/ai-passport-partner-api/revisions/d4e46c2809bf?raw)