openworkid.org / use
Use the experimental draft
OpenWork ID documents the portable record currently used by person.work. It is MIT-licensed and open to inspection, implementation and critique. It is not an established industry standard.
Professional data should travel with the professional.
The draft gives CV data, experience, evidence and profession-specific fields a shared shape. Its value is portability and explicit ownership—not institutional authority.
Portable
Retain structured data instead of flattening it into a document.
Extensible
Keep a small universal core and add profession-specific fields.
Owner-controlled
Separate public data, private data and changes awaiting approval.
01
Use the model
Read the schemas, preserve unknown extension fields and keep source and confidence information during every round trip.
L1
Read an explicitly shared profile
Use REST or MCP without assuming that a public web page grants unrestricted discovery.
L2
Preserve the portable record
Keep canonical identifiers, provenance and unknown fields available for re-export.
L3
Propose, do not silently overwrite
Agent-authored changes should remain reviewable until the owner accepts them.
Read the fictional sample
const response = await fetch(
"https://person.work/api/v1/profiles/mara-stein"
)
if (!response.ok) throw new Error("Profile unavailable")
const profile = await response.json()02
Interfaces
→ Available
✓JSON-LD and portable exports
✓Public profile read
✓OAuth-protected owner read, initial sync and change proposals
→ Outside the draft
–Profile search or talent discovery
–Automatic publication or outreach
–Certification or conformance claims by association
03
Implementation principles
| Principle | Requirement |
|---|---|
| Owner control | The owner controls visibility, export and accepted changes. |
| Provenance | Do not present imported or self-asserted statements as externally confirmed. |
| Portability | Provide a complete export without requiring the original service. |
| Data boundary | Do not infer contact data or expose private owner fields. |