# People & Companies developer access

The universal facts about people and companies, shared by every Vision app: names, contact details, addresses, affiliations, consent, and a change feed.

- **Lifecycle:** preview
- **Runtime:** restricted
- **Owner:** Vision People & Companies
- **Audience:** Vision-issued credential with the directory entitlement
- **App entitlement:** directory
- **Workspace:** Directory workspace required

## Authority boundary

Directory owns these facts, its workspace authorization, and its change feed. Apps store a record's id and keep their own data; app-specific fields go in namespaced extensions.

## Approved interfaces

- **People & Companies API** (OPENAPI 1.5.0) — [approved artifact](/openapi-directory-v1.json); SHA-256 `e9a21bef4722cf744b269884fe18e2c42858995fb6c78f16ae0aef076c00f5f7`

Documentation completeness does not change lifecycle or runtime availability.