Validate an agent-curated financial import manifest.

Validate an agent-curated financial import manifest.

post/v1/imports/validate

Request

  • Base URL: https://api.candor.money
  • URL: https://api.candor.money/v1/imports/validate
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

Stable opaque identity for one logical POST. Reuse only with the same method, path, actor, and body for transport retries. A completed receipt replays its original result, including a refusal; changed input with the same key is rejected. After a refused action and access recovery, use a new key for the new attempt. Follow retryable and recovery guidance if the operation is still running or its outcome is unknown.

Request body

source_kindstring
source_provider'agent_curated'

Curated imports always use the agent-curated ingestion channel; native providers use separate source adapters.

source_idstring
file_namestring
file_sha256string
authority'live_provider' | 'statement_reconciled' | 'agent_curated_unreconciled' | 'manual_correction' | 'external_claim_unverified'

Evidence authority, not transport. statement_reconciled means the broker or source evidence was faithfully transcribed and reconciled; partial or unreconciled evidence uses agent_curated_unreconciled. manual_correction is a reviewed human correction.

holdings_scope'incremental' | 'complete'

Incremental leaves omitted positions unchanged. Complete is allowed only for an existing agent-curated source_account_id with a dated closing balance and same-time holding rows that each include exact quantity or value; preview then turns every omitted active position into an explicit reversible removal.

Response

Envelope with validation issues, normalized rows, and suggested commands.

schema_versionstring required
generated_atstring date-time required
request_idstring required
status'success' | 'partial_success' | 'action_required' | 'error' required
user_messagestring

Optional concise user-safe message the calling agent may adapt.

warningsobject[] required
dataobject nullable required

Operation-specific result data, or null when the request ends in an error.

Changes

No recorded changes to this operation across all 1 revision of this API.