Oppulence Voice

Ingest consented capture artifact

Validates content hash and idempotency before persisting one explicit Rowboat handoff.

post/v1/capture-artifacts

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /v1/capture-artifacts
  • Auth: HTTP bearer

Request body

artifactIdstring required

Stable logical artifact id.

consentobject required

Explicit consent descriptor.

contentobject required

Consented content, or null for a tombstone.

contentHashstring required

SHA-256 of the exact content JSON.

eventIdstring required

SHA-256 event id and idempotency key.

kind'note' | 'transcription' | 'speaker_mapping' required

Artifact kind.

occurredAtstring required

Source event time.

operation'upsert' | 'delete' required

Mutation operation that produced this history row.

provenanceobject

Capture provenance.

schemaVersion'1.0' required

Artifact schema version.

sourceobject required

Capture source descriptor.

Example request

{
  "artifactId": "oppulence-voice:note:42",
  "contentHash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "eventId": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
  "kind": "note",
  "occurredAt": "2026-08-21T23:00:00Z",
  "operation": "UPDATE",
  "schemaVersion": "1.0"
}

Response

Idempotent replay.

object required

Artifact acknowledgement.

Changes

No recorded changes to this operation across all 50 revisions of this API.