person-facts

Submit your OWN birthday or work anniversary (employee self-submission)

The employee self-submission collection mode: the target of a solicit_fact notify. A member submits their OWN fact (source=self, the highest-trust source): month+day for a birthday (recurring_date, NO year) or an ISO date for a work anniversary. The subject is ALWAYS the caller's own actor (resolved from the verified JWT email), so a member can never write another person's fact. Tenant-scoped; PII-safe (no raw value logged; audit stores a hash); honors the fact's allowed_sources allowlist when set.

post/v1/person-facts/self

Request

  • Base URL: https://api.patricia.app (the document declares no server; this is the origin it was published from)
  • URL: https://api.patricia.app/v1/person-facts/self
  • Auth: HTTP bearer

Headers

X-Tenant-Idstring nullable

Request body

domain_keystring required

The canonical fact key, e.g. person.birthday / person.work_anniversary.

monthinteger nullable

Birthday month (1–12); no year is collected.

dayinteger nullable

Birthday day (1–31).

onstring date nullable

Work-anniversary date (ISO). Only month/day recur.

effective_tzstring nullable

IANA tz for this subject (optional).

Response

Successful Response

entity_idstring uuid required
definition_idstring uuid required
status_codestring required
recurring_monthinteger nullable required
recurring_dayinteger nullable required
date_valuestring date nullable required
effective_tzstring nullable required
fact_revisioninteger required

Changes

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