Перейти до вмісту
NimbusNexus

Workspaces

A workspace is the top-level isolation tier in the NimbusNexus account model. Every project belongs to exactly one workspace; every user has access scoped to workspaces (and to specific projects within them). The hierarchy is workspace → project → resource.

For most accounts, a single workspace is enough. Larger organizations use multiple workspaces to separate billing, access, and resource limits at the org-unit level — e.g. one workspace per business unit, or one per legal entity. Cross-workspace traffic, IAM, and billing are all isolated by design.

Don't confuse a workspace with a DNS zone — same word in some contexts (OpenStack calls workspaces "domains"), but the product surface uses "workspace" everywhere user-facing.

What's next

  • Projects — the next layer down; what workspaces contain.
  • Users and Roles — IAM grants are scoped within a workspace.
  • Cross-project trusts — time-bounded permission across project boundaries inside a workspace.

Reference

GET/api/v1/domains/

Find Domain

List domains visible to the caller, optionally filtered by a name search term.

Parameters

NameInRequiredDescription
admin_domainqueryno—
admin_projectqueryno—
searchqueryno—

Responses

  • 200Successful Response
  • 401Unauthorized
  • 403Forbidden
  • 422Validation error
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/domains/

POST/api/v1/domains/

Create Domain

Create a new domain and grant the calling user the admin role on it.

Request body

JSON body required.

Responses

  • 201Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 422Validation error
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/domains/

PATCH/api/v1/domains/

Update Domain

Update the name, description or enabled state of an existing domain.

Request body

JSON body required.

Responses

  • 200Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 409Conflict
  • 422Validation error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/domains/

DELETE/api/v1/domains/

Delete Domain

Disable (if needed) and delete a domain along with its descendants.

Request body

JSON body required.

Responses

  • 204Successful Response
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 422Validation Error
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/domains/

POST/api/v1/domains/invite

Invite To Domain

Invite a user by email to a domain with the specified role and notify them in-app and via email.

Request body

JSON body required.

Responses

  • 201Successful Response
  • 422Validation Error

https://api.nimbusnexus.net/api/v1/domains/invite

POST/api/v1/domains/invite_action

Invite Action

Accept or decline a pending domain invitation, applying or revoking the offered role accordingly.

Request body

JSON body required.

Responses

  • 200Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 409Conflict
  • 422Validation error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/domains/invite_action

GET/api/v1/domains/{domain_id}

Show Domain

Retrieve a single domain by ID.

Parameters

NameInRequiredDescription
domain_idpathyes—

Responses

  • 200Successful Response
  • 401Unauthorized
  • 403Forbidden
  • 422Validation error
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/domains/{domain_id}

Need to make a real call? Try these endpoints in the live Swagger UI →