Hanzo
OpenapiPlatform

Returns your org's projects, each with how many apps live under it.

Returns your org's projects, each with how many apps live under it. It lists the caller org's projects with the number of platform applications in each.

GET /v1/platform/projects

Addresshttps://api.hanzo.ai/v1/platform/projects
MethodGET
Operationget_platform_projects
AuthAuthorization: Bearer $HANZO_API_KEY

Returns your org's projects, each with how many apps live under it.

It lists the caller org's projects with the number of platform applications in each. A project is IAM's resource — it is created and deleted at /v1/iam/projects, never here — so this is the ONE projection IAM cannot serve: the project plus what the platform has put under it.

Requires a validated principal; 403 without one, and the org comes from that validated identity rather than a request header. This is the console's first authenticated read, so a project store that is not yet initialised degrades to an EMPTY list rather than a 500 — a new org genuinely has zero projects — and the real cause is surfaced to operators instead of to the caller.

Request

GET /v1/platform/projects takes no parameters and no body — the credential is the whole request.

Response

StatusBodyMeaning
200projectView[]ok

200 body — 6 fields.

FieldInTypeAlwaysDescription
[].applicationsbodyintegerApplications is how many platform apps this org has under the project, counted per request.
[].createdAtbodyintegerCreatedAt is IAM's creation time as unix seconds.
[].descriptionbodystringDescription is IAM's free text about the project.
[].namebodystringName is IAM's display name, falling back to the slug when the project has none, so this is never empty.
[].orgbodystringOrg is the project's IAM owner, and the tenant every app under it deploys into.
[].slugbodystringSlug is the project's IAM name — half of the (org,name) identity, the :project path segment, and the scope key an app is filed under.

Failure carries the platform error shape — see Errors.

Examples

hanzo platform projects list

Platform API · All Hanzo APIs · Interactive reference

How is this guide?

On this page