ingestion

Accept one data point

Accept one timestamped source. Returns 202 when processing is queued or 200 when the source is unchanged.

post/api/v1/ingest

Request

  • Base URL: https://api.past.dev
  • URL: https://api.past.dev/api/v1/ingest
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Request body

contentstring required

Raw text. Empty or whitespace-only content is refused.

labelstring

Optional short title for the data point, stored as its own field and returned as label on recall sources. Omitted on a re-send, the stored label stays.

idstring

Stable source id. When omitted, the lowercase SHA-256 of content is used.

timestampstring date-time

When the content occurred. Stored at microsecond precision.

audiencestring

Audience slug. Omit it or send project for project-visible memory.

identitystring

Customer id for the author. Its first ingest appearance creates the directory record.

idempotencyKeystring

Replay key for this request.

Response

Nothing to process: content, label, metadata and timestamp all match what is stored for the id, or only the audience moved. Nothing is charged, and the receipt carries status completed and unchanged true.

projectIdinteger required
ingestionIdstring uuid required
sourceIdstring required
status'queued' | 'completed' required
unchangedboolean nullable

Changes

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