Registry V3 Principals
Lists Principals
Unique identifier for the Harness account.
Unique identifier for the organization within the account.
Example: default or engineering_org
Unique identifier for the project within the organization.
Example: my_project or frontend_services
The page number for pagination (0-indexed).
Used to navigate through large result sets. Combined with size parameter
to control which subset of results to return.
Example: page=0 returns the first page, page=1 returns the second page
0The number of items to return per page.
Controls the page size for paginated results.
Example: size=50 returns up to 50 items per page
20Search term for filtering results.
Example: search_term=prod might match keys like "production", "prod-env", etc.
filter by principal type
response for list principal
Pagination metadata.
pageselects which page of results to return (0 = first page).sizecontrols how many items are returned per page.hasMoreis true if more results exist after this page.
True if more results exist after this page.
trueThe current page (0-indexed)
0Number of items per page
20Error response.
GET /api/v3/principals?account_identifier=text HTTP/1.1
Accept: */*
{
"hasMore": true,
"page": 0,
"size": 20,
"items": []
}Last updated
Was this helpful?