x-cortex-owners
This is the field you define in your entity YAML or OpenAPI spec. It’s the source of truth for ownership metadata, where you specify owners as groups, emails, or (historically) Slack channels. When you upload or sync an entity, Cortex reads this block to determine the initial set of owners. This is the main way to define ownership in a GitOps or config-driven workflow.
x-cortex-owners:
- name: disbursements-engineering
type: GROUP
provider: CORTEX
description: ""
owners
This is a legacy field in the API response. It typically contains owners as groups, emails, and Slack channels, directly reflecting what’s in x-cortex-owners. It’s still present for backward compatibility but is being phased out in favor of more structured fields.
ownersV2
This is the recommended and more modern field for ownership data. It provides a structured view, splitting owners into teams and individuals, and is designed to support richer ownership hierarchies and integrations. For programmatic access and future-proofing, use ownersV2 as it will be the consolidated source going forward.
