People pillar · v0.8.1
org-structure OrgStructure
Organizational structure aligned with W3C ORG ontology.
$id · https://corpospec.com/schemas/v0.8.1/org-structure.schema.json
Fields
| Field | Type | Required | Description |
|---|---|---|---|
| entity | PathRef | yes | PathRef to the legal entity that owns this structure. |
| id | PathRef | yes | PathRef of this record (conventionally `people/org`). |
| name | string | yes | Legal / display name of the organization (e.g. `"Unstarter GmbH"`). |
| type | OrgType | yes | W3C ORG type discriminator. For the root record this is always `FormalOrganization`. |
| custom | OrgCustom? | — | Typed custom extension fields (employment defaults, hiring timeline). |
| units | OrgUnit[] | — | Sub-units of the organization. |
Definitions
Shared types referenced within this schema.
FutureSubsidiary
Future subsidiary planned by the organization.
type: object
HiringTimelineEntry
Entry in the org-level hiring timeline.
type: object
IsoCountry
ISO 3166-1 alpha-2 country code.
pattern: ^[A-Z]{2}$
IsoDate
ISO 8601 date (YYYY-MM-DD).
type: string
OrgCustom
Typed extension fields for OrgStructure.
type: object
OrgType
Organization type.
OrgUnit
Organizational unit within the structure.
type: object
OrgUnitSite
Work-location model for an `OrgUnit`.
PathRef
Path-based cross-reference relative to .corpospec/ root.
Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$`
pattern: ^[a-z0-9_-]+(/[a-z0-9_.-]+)+$
Reference in your YAML
# yaml-language-server: $schema=https://corpospec.com/schemas/v0.8.1/org-structure.schema.json