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

Nuon orgs API is one of 18 APIs that Nuon publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include orgs. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 21 operations across 14 paths, and defines 192 schemas. It is described by OpenAPI 2.0, at version 0.19.1074.

Requests are made against the base URL https://api.nuon.co.

21 operations 14 paths 192 schemas 2 DELETE9 GET3 PATCH7 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 2.0
API Version
0.19.1074
Base URL
https://api.nuon.co
Authentication
API Key, API Key
Resource Areas
1

Authentication & Security 2

Nuon orgs API declares 2 security schemes for authenticating requests. An API key is passed in the header as Authorization (APIKey). An API key is passed in the header as X-Nuon-Org-ID (OrgID).

  • APIKey — Type "Bearer" followed by a space and token.
  • OrgID — Nuon org ID

Paths & Operations 21

Across 14 paths, the API surfaces 21 operations — 2 DELETE, 9 GET, 3 PATCH, 7 POST. Each is listed below with its method, path, parameters, and response codes.

orgs 21

orgs

GET
/v1/orgs
Return current user's orgs
GetOrgs 4 params → 200400401403404500
POST
/v1/orgs
create a new org
CreateOrg 1 param → 201400401403404409500
DELETE
/v1/orgs/current
Delete an org
DeleteOrg → 200400401403404500
GET
/v1/orgs/current
Get an org
GetOrg → 200400401403404500
PATCH
/v1/orgs/current
Update current org
UpdateOrg 1 param → 200400401403404500
GET
/v1/orgs/current/accounts
Get user accounts for current org
GetOrgAcounts 3 params → 200400401403404500
GET
/v1/orgs/current/features
get current org's feature flags
GetCurrentOrgFeatures → 200
PATCH
/v1/orgs/current/features
update org features (requires user-managed-features flag)
UpdateOrgFeatures 1 param → 200403
GET
/v1/orgs/current/invites
Return org invites
GetOrgInvites 3 params → 200400401403404500
POST
/v1/orgs/current/invites
Invite a user to the current org
CreateOrgInvite 1 param → 201400401403404409500
POST
/v1/orgs/current/invites/{invite_id}/resend
Resend an org invite
ResendOrgInvite 1 param → 200400401403404500
POST
/v1/orgs/current/invites/{invite_id}/revoke
Revoke an org invite
RevokeOrgInvite 1 param → 200400401403404500
POST
/v1/orgs/current/remove-user
Remove a user from the current org
RemoveUser 1 param → 201400401403404500
GET
/v1/orgs/current/runner-group
Get an org's runner group
GetOrgRunnerGroup → 200400401403404500
GET
/v1/orgs/current/stats
Get an org
GetOrgStats → 200400401403404500
POST
/v1/orgs/current/user
Add a user to the current org
AddUser 1 param → 201400401403404409500
GET
/v1/orgs/current/webhooks
list webhooks for the current org
GetCurrentOrgWebhooks → 200400401403500
POST
/v1/orgs/current/webhooks
create a webhook for the current org
CreateCurrentOrgWebhook 1 param → 201400401403409500
DELETE
/v1/orgs/current/webhooks/{webhook_id}
delete a webhook for the current org
DeleteCurrentOrgWebhook 1 param → 204400401403404500
PATCH
/v1/orgs/current/webhooks/{webhook_id}
update a webhook for the current org
UpdateCurrentOrgWebhook 2 params → 200400401403404500
GET
/v1/orgs/features
get available org features
GetOrgFeatures → 200

Schemas 192

The contract defines 192 schemas that model the data the API accepts and returns. The most detailed are app.WorkflowStep (36 properties), app.RunnerGroupSettings (35 properties), app.RunnerJob (33 properties), app.ComponentConfigConnection (32 properties). Each schema is shown below with its type and property counts.

configs.OCIRegistryType
string
plantypes.OCIArtifactReference
object
3 properties
plantypes.BuildPlan
object
12 properties 2 required
compositeerrors.Section
object
3 properties
github_com_nuonco_nuon_pkg_labels.Labels
object
app.DockerBuildComponentConfig
object
11 properties
app.CompositeStatus
object
6 properties
app.ConnectedGithubVCSConfig
object
14 properties
state.RunnerState
object
4 properties
plantypes.SyncOCIPlan
object
5 properties 4 required
app.Queue
object
16 properties
app.OCIArtifact
object
20 properties
plantypes.DeployPlan
object
16 properties 2 required
service.CreateCurrentOrgWebhookRequest
object
4 properties 1 required
app.ComponentRelease
object
9 properties
app.Account
object
10 properties
app.PolicyResult
object
7 properties
plantypes.TerraformLocalArchive
object
1 property
app.AppBranchInstallGroup
object
12 properties
app.ComponentType
string
plantypes.HelmValue
object
3 properties
app.AdHocStepConfig
object
16 properties
app.RunnerJobType
string
plantypes.DockerBuildPlan
object
4 properties
state.AWSCloudAccount
object
1 property
plantypes.PulumiBackend
object
6 properties 3 required
compositeerrors.SectionKind
string
app.WorkflowStepPolicyValidation
object
8 properties
state.SandboxState
object
6 properties
app.SandboxRunType
string
app.InstallActionWorkflowRun
object
29 properties
app.InstallActionWorkflowRunStepStatus
string
app.ActionWorkflowConfig
object
17 properties
service.CreateOrgRequest
object
3 properties 1 required
app.AppRunnerType
string
plantypes.HelmDeployPlan
object
14 properties
plantypes.TerraformBuildPlan
object
3 properties
app.Runner
object
18 properties
app.OrgInviteStatus
string
config.HelmRepoConfig
object
3 properties
app.AWSECRImageConfig
object
8 properties
refs.Ref
object
4 properties
plantypes.NoopDeployPlan
object
service.UpdateOrgRequest
object
1 property 1 required
app.ComponentConfigConnection
object
32 properties
app.KubernetesManifestComponentConfig
object
10 properties
app.TerraformModuleComponentConfig
object
11 properties
state.SecretsState
object
service.UpdateCurrentOrgWebhookRequest
object
3 properties
app.RunnerJobExecutionResult
object
14 properties
app.RunnerJobExecutionOutputs
object
8 properties
app.PolicyName
string
app.HelmRepoConfig
object
3 properties
credentials.AssumeRoleConfig
object
6 properties 2 required
plantypes.HelmSandboxMode
object
2 properties
plantypes.FetchImageMetadataPlan
object
6 properties 2 required
app.AppBranchRunType
string
app.RunnerJob
object
33 properties
state.ActionWorkflowState
object
4 properties
state.AzureCloudAccount
object
1 property
service.RemoveOrgUserRequest
object
1 property
app.RunnerJobExecutionStatus
string
app.PolicyReport
object
24 properties
plantypes.KubernetesSecretSyncTarget
object
3 properties
plantypes.PulumiBuildPlan
object
1 property
app.RoleType
string
plantypes.KubernetesManifestBuildPlan
object
5 properties
state.InstallState
object
7 properties
app.VCSConnection
object
10 properties
app.PolicyViolation
object
6 properties
app.QueueEmitterMode
string
app.WorkflowStepApprovalType
string
app.InstallDeployType
string
app.WorkflowStepApproval
object
14 properties
app.Workflow
object
30 properties
app.PulumiComponentConfig
object
11 properties
plantypes.KubernetesSandboxMode
object
2 properties
app.WorkflowRun
object
11 properties
cctx.SignalContext
object
4 properties
github_com_nuonco_nuon_pkg_aws_credentials.Config
object
6 properties
compositeerrors.Severity
string
plantypes.CompositePlan
object
7 properties
app.JobComponentConfig
object
10 properties
sql.NullBool
object
2 properties
compositeerrors.CompositeErrorData
object
9 properties
configs.OCIRegistryAuth
object
2 properties
plantypes.TerraformBackend
object
1 property 1 required
app.WorkflowType
string
credentials.StaticCredentials
object
3 properties 3 required
plantypes.OCISource
object
2 properties
app.AppSandboxConfig
object
26 properties
signaldb.WorkflowRef
object
3 properties
app.ExternalImageComponentConfig
object
11 properties
stderr.ErrResponse
object
3 properties
plantypes.SyncSecretsPlan
object
6 properties
app.InstallDeploy
object
32 properties
app.WorkflowStepExecutionType
string
app.RunnerGroup
object
11 properties
app.RunnerJobPlan
object
8 properties
plantypes.KubernetesManifestDeployPlan
object
8 properties
state.ActionsState
object
2 properties
iam.StaticCredentials
object
3 properties
app.RunnerJobExecution
object
11 properties
app.RunnerGroupType
string
signaldb.SignalData
object
1 property
github_com_nuonco_nuon_pkg_gcp_credentials.Config
object
3 properties
app.PolicyInputRef
object
3 properties
permissions.Permission
string
app.QueueSignal
object
20 properties
permissions.Set
object
app.Component
object
17 properties
app.WorkflowStepGroup
object
14 properties
app.OrgFeatureInfo
object
2 properties
plantypes.ContainerImagePullPlan
object
5 properties
credentials.ServicePrincipalCredentials
object
2 properties
state.OrgState
object
4 properties
plantypes.HelmBuildPlan
object
4 properties
plantypes.GitSource
object
4 properties 3 required
app.Status
string
iam.TwoStepConfig
object
3 properties
app.AccountType
string
service.CreateOrgUserRequest
object
1 property
plantypes.TerraformDeployHooks
object
3 properties
app.ActionWorkflowTriggerType
string
app.RunnerOperation
object
10 properties
app.WorkflowRunType
string
app.WorkflowStep
object
36 properties
app.AzureACRImageConfig
object
9 properties
callback.Ref
object
3 properties
app.ActionWorkflow
object
12 properties
app.InstallActionWorkflowRunStep
object
10 properties
app.AppBranchRun
object
31 properties
kube.ClusterInfo
object
10 properties
plantypes.TerraformDeployPlan
object
12 properties
app.PolicyReportOwnerType
string
app.UserJourney
object
3 properties
app.InstallRoleUsage
object
13 properties
app.LogStream
object
11 properties
app.ComponentBuild
object
31 properties
app.InstallRoleSelectionRecord
object
5 properties
app.UserJourneyStep
object
7 properties
app.VCSConnectionCommit
object
11 properties
github_com_nuonco_nuon_pkg_azure_credentials.Config
object
3 properties
service.UpdateOrgFeaturesRequest
object
1 property 1 required
app.QueueEmitter
object
21 properties
app.ActionWorkflowStepConfig
object
16 properties
app.ComponentReleaseStep
object
10 properties
plantypes.PulumiSandboxMode
object
3 properties
app.KustomizeConfig
object
4 properties
plantypes.KubernetesSecretSync
object
9 properties
service.CurrentOrgWebhookResponse
object
9 properties
app.HelmConfig
object
8 properties
state.AppState
object
5 properties
app.Role
object
7 properties
app.InstallApprovalOption
string
app.InstallSandboxRun
object
24 properties
outputs.SecretSyncOutput
object
10 properties
types.StringBoolMap
object
plantypes.SandboxRunPlan
object
21 properties
service.CreateOrgInviteRequest
object
2 properties 1 required
github_com_nuonco_nuon_pkg_types_state.State
object
16 properties
app.AppBranchConfig
object
13 properties
app.Policy
object
7 properties
plantypes.KustomizeBuildConfig
object
3 properties
state.GCPCloudAccount
object
2 properties
compositeerrors.Hints
object
app.RunnerJobOperationType
string
state.CloudAccount
object
3 properties
app.NotificationsConfig
object
8 properties
app.PublicGitVCSConfig
object
10 properties
state.InputsState
object
2 properties
plantypes.ActionWorkflowRunPlan
object
12 properties
plantypes.ActionWorkflowRunStepPlan
object
6 properties
github_com_nuonco_nuon_pkg_labels.Selector
object
2 properties
plantypes.PulumiDeployPlan
object
14 properties
app.ActionWorkflowTriggerConfig
object
12 properties
configs.OCIRegistryRepository
object
10 properties
app.RunnerOperationType
string
plantypes.SandboxMode
object
6 properties
app.RunnerJobStatus
string
app.Org
object
19 properties
plantypes.TerraformSandboxMode
object
4 properties
state.InstallStackState
object
7 properties
app.AppBranch
object
12 properties
app.HelmComponentConfig
object
15 properties
app.RunnerGroupSettings
object
35 properties
app.RunnerJobGroup
string
app.InstallActionWorkflow
object
9 properties
state.DomainState
object
3 properties
app.GCPGARImageConfig
object
10 properties
refs.RefType
string
app.OrgInvite
object
9 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

nuon-orgs-api-openapi.yml Raw ↑

Other APIs Nuon publishes across the network.

Nuon accounts API
Nuon actions API
Nuon actions/runner API
Nuon apps API
Nuon auth API
Nuon components API
Nuon general API
Nuon installs API
Nuon notebooks API
Nuon onboarding API
Nuon policy-reports API
Nuon queues API