Skip to content
NebulaCtrlInstall

Reference

View as Markdown

Builds API

2 operations. Every call needs a session cookie or an Authorization: Bearer nct_… token unless marked Public. Conventions, errors and scopes

GET/team/build-settings

Get the team's default build location and registry

Projects and services can override the default; resolution is service, then project, then team.

Response 200 · OK · application/json
TeamSettings
  • buildLocationenum: target | build_serverrequired
  • registryIdstringrequired
  • updatedAtstring (date-time) | nullrequired
Errors
  • 401Unauthorized
  • 403Forbidden
  • 500Internal Server Error

Errors are RFC 9457 application/problem+json with a stable code field.

PUT/team/build-settings

Set the team's default build location and registry

With buildLocation build_server, git services build on a build server and push the image to the registry; the deploying server pulls it by digest. Without a usable build server or registry a build falls back to the target server and says so in the deployment's events. Administrators only.

Request body · application/json · required
PutTeamSettingsInputBody
  • buildLocationenum: target | build_serverrequired
    Where services build by default: on their own server (target) or on a build server.
  • registryIdstring
    Default registry builds are pushed to; omitted clears it.
Response 200 · OK · application/json
TeamSettings
  • buildLocationenum: target | build_serverrequired
  • registryIdstringrequired
  • updatedAtstring (date-time) | nullrequired
Errors
  • 401Unauthorized
  • 403Forbidden
  • 422Unprocessable Entity
  • 500Internal Server Error

Errors are RFC 9457 application/problem+json with a stable code field.