Skip to main content
POST
TypeScript (SDK)

Authorizations

tql_api_key
string
header
required

Headers

Connect-Protocol-Version
enum<number>
default:1
required

Define the version of the Connect protocol

Available options:
1
Connect-Timeout-Ms
number

Define the timeout, in ms

Body

application/json

Returns the effective owners for a directory after walking ancestor OWNERS files: for every role in the org, the resolved permission the role would have on this directory (per permissionForDirWithRoles). Use this when you need to compare permissions across paths — the literal GetOntologyOwners only reflects the OWNERS file at the exact path, missing inheritance.

path
string

Response

Success

path
string
entries
OntologyOwnerEntry · object[]
unlistedPrincipalPermission
enum<string>

Effective permission for principals omitted from entries. Unrestricted paths grant full access; restricted paths leave this unspecified.

Available options:
ONTOLOGY_PERMISSION_UNSPECIFIED,
ONTOLOGY_PERMISSION_EXECUTE,
ONTOLOGY_PERMISSION_READ,
ONTOLOGY_PERMISSION_READ_EXECUTE,
ONTOLOGY_PERMISSION_READ_WRITE,
ONTOLOGY_PERMISSION_READ_WRITE_EXECUTE