Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Zitadel Organizations API

Manage organizations and organizational domains

Zitadel Organizations API is one of 11 APIs that Zitadel publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 13 JSON Schema definitions.

Tagged areas include Organizations. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a GitHub repository, and 13 JSON Schemas.

This API exposes 5 operations across 5 paths, and defines 7 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against 2 base URLs: https://{instance}.zitadel.cloud, https://{custom-domain}.

5 operations 5 paths 7 schemas 1 GET4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Servers
https://{instance}.zitadel.cloud
https://{custom-domain}
Authentication
HTTP Bearer
Contact
License
Terms of Service
Resource Areas
1

Authentication & Security 1

Zitadel Organizations API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (bearerAuth). By default, every request must be authenticated.

Paths & Operations 5

Across 5 paths, the API surfaces 5 operations — 1 GET, 4 POST. Each is listed below with its method, path, parameters, and response codes.

Organizations 5

Manage organizations and organizational domains

POST
/management/v1/orgs/_search
Zitadel List Organizations
listOrganizations body → 200
POST
/management/v1/orgs
Zitadel Create Organization
createOrganization body → 200
GET
/management/v1/orgs/me
Zitadel Get My Organization
getMyOrg → 200
POST
/management/v1/orgs/me/members/_search
Zitadel List Organization Members
listOrgMembers → 200
POST
/management/v1/orgs/me/members
Zitadel Add Organization Member
addOrgMember body → 200

Schemas 7

The contract defines 7 schemas that model the data the API accepts and returns. The most detailed are Organization (5 properties), ObjectDetails (4 properties), ListDetails (3 properties), ListQuery (3 properties). Each schema is shown below with its type and property counts.

ListQuery
object
3 properties
ListDetails
object
3 properties
Organization
object
5 properties
OrgResponse
object
1 property
ListOrgsRequest
object
2 properties
ListOrgsResponse
object
2 properties
ObjectDetails
object
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

zitadel-organizations-api-openapi.yml Raw ↑

Other APIs Zitadel publishes across the network.

Zitadel Auth API
Zitadel Admin API
Zitadel OIDC / OAuth 2.0
Zitadel SAML API
Zitadel Applications API
Zitadel Identity Providers API
Zitadel Policies API
Zitadel Projects API
Zitadel Roles API
Zitadel Users API