Ir para o conteúdo
NimbusNexus

Cross-project trusts

A trust grants a user in one project temporary permission to act in another project — without that user needing membership or a shared API key. The trust carries a specific role, an expiration, and an optional impersonation scope.

The canonical use case: a CI/CD pipeline that's identified to project shared-infra but needs to deploy resources into acme-prod. Without trusts, you'd either give the CI key admin on both projects (bad blast radius) or copy keys between projects (worse). With a trust, shared-infra issues a time-bounded vms:write grant in acme-prod; the CI calls present the trust along with their normal credentials.

Trusts respect the security model — the granting user can only grant roles they themselves hold, and the trust expires no later than the grant they're delegating from. There's no privilege escalation path.

What's next

Reference

GET/api/v1/trusts/

List Trusts

List trust delegations where the caller is the trustor or trustee.

Responses

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

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

GET/api/v1/trusts/{trust_id}

Get Trust

Retrieve a single trust delegation by ID.

Parameters

NameInRequiredDescription
trust_idpathyes—

Responses

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

https://api.nimbusnexus.net/api/v1/trusts/{trust_id}

DELETE/api/v1/trusts/{trust_id}

Delete Trust

Revoke and delete a trust delegation by ID.

Parameters

NameInRequiredDescription
trust_idpathyes—

Responses

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

https://api.nimbusnexus.net/api/v1/trusts/{trust_id}

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