Generated from the live OpenAPI document — 2026-10-19.The chat-import-guide guide explains this surface in context.All routes require Authorization: Bearer atamaia_… and return ApiEnvelope<T>({ ok, requestId, data, error, errorCode, count, hint }); the schemas below show thedata payload. * marks required properties.

See also: Export & Portability

Operations

MethodPathSummary / bodyResponses
GET /api/import List imports, newest first (paged). 200 PagedResultOfImportDto
DELETE /api/import/{id} Discard a staged import. Nothing was written, so nothing is undone. 200
GET /api/import/{id} One import's status. 200 ImportDto
POST /api/import/{id}/commit Commit approved conversations as permanent memories (provenance Reported) and approved facts into the project store. The request may retarget the destination identity — the last moment to choose whose memory this becomes. 200 ImportDto
GET /api/import/{id}/conversations/{conversationId} One parsed conversation in full. 200 ImportConversationDetailDto
GET /api/import/{id}/review The review set: parsed conversations awaiting include/exclude decisions. Nothing has been written yet. 200 ImportReviewDto
PATCH /api/import/{id}/review Apply include/exclude decisions to a staged import. 200 ImportReviewDto
POST /api/import/upload Upload a provider export archive (ZIP, up to 600 MB) and start the parse-and-scrub pipeline. Parsing runs detached — poll GET /api/import/{id} until ReadyForReview, Committed or Failed. 200 ImportDto

Schemas

Request and response shapes referenced by the operations above. Nested types named here are also defined under their own group or inthe group index.

ImportConversationDetailDto

PropertyTypeDescription
id int64
sourceId string
title null,string
approved boolean
summary null,string
messages ImportMessageDto[]

ImportDto

PropertyTypeDescription
id int64
guid uuid
statusId ImportStatus
sourceProviderId ImportSourceProvider
fileName string
fileSizeBytes int64
conversationCount int32
messageCount int64
itemCount int32
scrubFlagCount int32
detectedFormat null,string
errorMessage null,string
identityId int64
projectId int64
createdAtUtc date-time
processedAtUtc date-time
committedAtUtc date-time

ImportReviewDto

PropertyTypeDescription
importId int64
statusId ImportStatus
sourceProviderId ImportSourceProvider
conversations ImportConversationDto[]
items ImportItemDto[]

PagedResultOfImportDto

PropertyTypeDescription
items* ImportDto[]
totalCount int32
page int32
pageSize int32
hasTotal boolean
moreAvailable null,boolean
totalPages int32
hasNextPage boolean
hasPreviousPage boolean