Credentials

Credentials are used to unlock protected resources such as applications, containers, and other assets. For more information, see Credentialsarrow-up-right.

List credentials.

get

Use to retrieve a list of all existing credentials.

Authorizations
AuthorizationstringRequired

Bearer authentication

Query parameters
namestringOptional

Filter results by name.

scopestringOptional

Filters results by scope. Returns only assets that belong to the specified scope. Mutually exclusive with includeDescendants. Valid values: tenant, cluster, department, project.

projectIdinteger · int32Optional

Filter results by project id. If scope filter is project, only assets from the specific project will be included in the response. Otherwise, the response will include project, department, cluster, tenant and system assets.

departmentIdstringOptional

Filter results by department id. If scope filter is department, only assets from the specific department will be included in the response. Otherwise, the response will include department, cluster, tenant and system assets.

Example: 1
clusterIdstring · uuidOptional

Filter results by Universally Unique Identifier (UUID) of the cluster. If scope filter is cluster, only assets from the specific cluster will be included in the response. Otherwise, the response will include cluster, tenant and system assets.

Example: d73a738f-fab3-430a-8fa3-5241493d7128
usageInfobooleanOptional

Whether the query should include asset usage information as part of the response.

statusInfobooleanOptional

Whether the query should include asset status information as part of the response.

includeDescendantsbooleanOptional

Indicates whether to include assets from all descendant scopes under the specified scope. When set to true, and a specific scope identifier (for example, clusterId) is provided, the query also returns assets from all nested scopes within it (for example, departments and projects). Mutually exclusive with scope.

Responses
get
/api/v1/asset/credentials

List access keys.

get

Use to retrieve a list of S3-compatible access key credentials.

Authorizations
AuthorizationstringRequired

Bearer authentication

Query parameters
namestringOptional

Filter results by name.

scopestringOptional

Filters results by scope. Returns only assets that belong to the specified scope. Mutually exclusive with includeDescendants. Valid values: tenant, cluster, department, project.

projectIdinteger · int32Optional

Filter results by project id. If scope filter is project, only assets from the specific project will be included in the response. Otherwise, the response will include project, department, cluster, tenant and system assets.

departmentIdstringOptional

Filter results by department id. If scope filter is department, only assets from the specific department will be included in the response. Otherwise, the response will include department, cluster, tenant and system assets.

Example: 1
clusterIdstring · uuidOptional

Filter results by Universally Unique Identifier (UUID) of the cluster. If scope filter is cluster, only assets from the specific cluster will be included in the response. Otherwise, the response will include cluster, tenant and system assets.

Example: d73a738f-fab3-430a-8fa3-5241493d7128
usageInfobooleanOptional

Whether the query should include asset usage information as part of the response.

statusInfobooleanOptional

Whether the query should include asset status information as part of the response.

Responses
get
/api/v1/asset/credentials/access-key

Create an access key.

post

Use to create an S3-compatible access key credential.

Authorizations
AuthorizationstringRequired

Bearer authentication

Body
Responses
chevron-right
202

Request accepted successfully.

application/json
post
/api/v1/asset/credentials/access-key

Get an access key.

get

Use to retrieve the details of an S3-compatible access key credential by id.

Authorizations
AuthorizationstringRequired

Bearer authentication

Path parameters
AssetIdstring · uuid · min: 1Required

Unique identifier of the asset.

Query parameters
usageInfobooleanOptional

Whether the query should include asset usage information as part of the response.

statusInfobooleanOptional

Whether the query should include asset status information as part of the response.

Responses
get
/api/v1/asset/credentials/access-key/{AssetId}

Update an access key.

put

Use to update the details of an S3-compatible access key credential by id.

Authorizations
AuthorizationstringRequired

Bearer authentication

Path parameters
AssetIdstring · uuid · min: 1Required

Unique identifier of the asset.

Body
Responses
chevron-right
202

Request accepted successfully.

application/json
put
/api/v1/asset/credentials/access-key/{AssetId}

Delete an access key.

delete

Use to delete an S3-compatible access key credential by id.

Authorizations
AuthorizationstringRequired

Bearer authentication

Path parameters
AssetIdstring · uuid · min: 1Required

Unique identifier of the asset.

Responses
chevron-right
202

Accepted.

application/json
delete
/api/v1/asset/credentials/access-key/{AssetId}

List password credentials.

get

Use to retrieve a list of password credentials.

Authorizations
AuthorizationstringRequired

Bearer authentication

Query parameters
namestringOptional

Filter results by name.

scopestringOptional

Filters results by scope. Returns only assets that belong to the specified scope. Mutually exclusive with includeDescendants. Valid values: tenant, cluster, department, project.

projectIdinteger · int32Optional

Filter results by project id. If scope filter is project, only assets from the specific project will be included in the response. Otherwise, the response will include project, department, cluster, tenant and system assets.

departmentIdstringOptional

Filter results by department id. If scope filter is department, only assets from the specific department will be included in the response. Otherwise, the response will include department, cluster, tenant and system assets.

Example: 1
clusterIdstring · uuidOptional

Filter results by Universally Unique Identifier (UUID) of the cluster. If scope filter is cluster, only assets from the specific cluster will be included in the response. Otherwise, the response will include cluster, tenant and system assets.

Example: d73a738f-fab3-430a-8fa3-5241493d7128
usageInfobooleanOptional

Whether the query should include asset usage information as part of the response.

statusInfobooleanOptional

Whether the query should include asset status information as part of the response.

Responses
get
/api/v1/asset/credentials/password

Create a userid / password credential.

post

Use to create a userid / password credential.

Authorizations
AuthorizationstringRequired

Bearer authentication

Body
Responses
chevron-right
202

Request accepted successfully.

application/json
post
/api/v1/asset/credentials/password

Get a userid / password credential.

get

Use to retrieve the details of a userid / password credential asset by id.

Authorizations
AuthorizationstringRequired

Bearer authentication

Path parameters
AssetIdstring · uuid · min: 1Required

Unique identifier of the asset.

Query parameters
usageInfobooleanOptional

Whether the query should include asset usage information as part of the response.

statusInfobooleanOptional

Whether the query should include asset status information as part of the response.

Responses
get
/api/v1/asset/credentials/password/{AssetId}

Update a password credential.

put

Use to Update the details of a password credential by id.

Authorizations
AuthorizationstringRequired

Bearer authentication

Path parameters
AssetIdstring · uuid · min: 1Required

Unique identifier of the asset.

Body
Responses
chevron-right
202

Request accepted successfully.

application/json
put
/api/v1/asset/credentials/password/{AssetId}

Delete a password asset.

delete

Udse to delete a password credential by id.

Authorizations
AuthorizationstringRequired

Bearer authentication

Path parameters
AssetIdstring · uuid · min: 1Required

Unique identifier of the asset.

Responses
chevron-right
202

Accepted.

application/json
delete
/api/v1/asset/credentials/password/{AssetId}

List docker registry credentials.

get

Use to retrieve a list of docker registry credentials.

Authorizations
AuthorizationstringRequired

Bearer authentication

Query parameters
namestringOptional

Filter results by name.

scopestringOptional

Filters results by scope. Returns only assets that belong to the specified scope. Mutually exclusive with includeDescendants. Valid values: tenant, cluster, department, project.

projectIdinteger · int32Optional

Filter results by project id. If scope filter is project, only assets from the specific project will be included in the response. Otherwise, the response will include project, department, cluster, tenant and system assets.

departmentIdstringOptional

Filter results by department id. If scope filter is department, only assets from the specific department will be included in the response. Otherwise, the response will include department, cluster, tenant and system assets.

Example: 1
clusterIdstring · uuidOptional

Filter results by Universally Unique Identifier (UUID) of the cluster. If scope filter is cluster, only assets from the specific cluster will be included in the response. Otherwise, the response will include cluster, tenant and system assets.

Example: d73a738f-fab3-430a-8fa3-5241493d7128
usageInfobooleanOptional

Whether the query should include asset usage information as part of the response.

statusInfobooleanOptional

Whether the query should include asset status information as part of the response.

Responses
get
/api/v1/asset/credentials/docker-registry

Create a docker registry credential.

post

Use to create a docker registry credential containing userid, password and url.

Authorizations
AuthorizationstringRequired

Bearer authentication

Body
Responses
chevron-right
202

Request accepted successfully.

application/json
post
/api/v1/asset/credentials/docker-registry

Get a docker registry credential.

get

Use to retrieve the details of a docker registry credential by id.

Authorizations
AuthorizationstringRequired

Bearer authentication

Path parameters
AssetIdstring · uuid · min: 1Required

Unique identifier of the asset.

Query parameters
usageInfobooleanOptional

Whether the query should include asset usage information as part of the response.

statusInfobooleanOptional

Whether the query should include asset status information as part of the response.

Responses
get
/api/v1/asset/credentials/docker-registry/{AssetId}

Update a docker registry credential.

put

Use to updates the details of a docker registry credentials by id.

Authorizations
AuthorizationstringRequired

Bearer authentication

Path parameters
AssetIdstring · uuid · min: 1Required

Unique identifier of the asset.

Body
Responses
chevron-right
202

Request accepted successfully.

application/json
put
/api/v1/asset/credentials/docker-registry/{AssetId}

Delete a docker registry credential.

delete

Use to deletes a docker registry credential by id.

Authorizations
AuthorizationstringRequired

Bearer authentication

Path parameters
AssetIdstring · uuid · min: 1Required

Unique identifier of the asset.

Responses
chevron-right
202

Accepted.

application/json
delete
/api/v1/asset/credentials/docker-registry/{AssetId}

List generic-secrets.

get

Retrieve a list of generic-secret assets.

Authorizations
AuthorizationstringRequired

Bearer authentication

Query parameters
namestringOptional

Filter results by name.

scopestringOptional

Filters results by scope. Returns only assets that belong to the specified scope. Mutually exclusive with includeDescendants. Valid values: tenant, cluster, department, project.

projectIdinteger · int32Optional

Filter results by project id. If scope filter is project, only assets from the specific project will be included in the response. Otherwise, the response will include project, department, cluster, tenant and system assets.

departmentIdstringOptional

Filter results by department id. If scope filter is department, only assets from the specific department will be included in the response. Otherwise, the response will include department, cluster, tenant and system assets.

Example: 1
clusterIdstring · uuidOptional

Filter results by Universally Unique Identifier (UUID) of the cluster. If scope filter is cluster, only assets from the specific cluster will be included in the response. Otherwise, the response will include cluster, tenant and system assets.

Example: d73a738f-fab3-430a-8fa3-5241493d7128
usageInfobooleanOptional

Whether the query should include asset usage information as part of the response.

statusInfobooleanOptional

Whether the query should include asset status information as part of the response.

Responses
get
/api/v1/asset/credentials/generic-secret

Create a generic-secret.

post

Use to create a generic-secret asset.

Authorizations
AuthorizationstringRequired

Bearer authentication

Body
Responses
chevron-right
202

Request accepted successfully.

application/json
post
/api/v1/asset/credentials/generic-secret

Get a generic-secret.

get

Returns the details of a generic-secret asset, by id.

Authorizations
AuthorizationstringRequired

Bearer authentication

Path parameters
AssetIdstring · uuid · min: 1Required

Unique identifier of the asset.

Query parameters
usageInfobooleanOptional

Whether the query should include asset usage information as part of the response.

statusInfobooleanOptional

Whether the query should include asset status information as part of the response.

Responses
get
/api/v1/asset/credentials/generic-secret/{AssetId}

Update a generic-secret.

put

Updates the details of a generic-secret asset, by id.

Authorizations
AuthorizationstringRequired

Bearer authentication

Path parameters
AssetIdstring · uuid · min: 1Required

Unique identifier of the asset.

Body
Responses
chevron-right
202

Request accepted successfully.

application/json
put
/api/v1/asset/credentials/generic-secret/{AssetId}

Delete a generic-secret.

delete

Use to delete a generic-secret asset, by id.

Authorizations
AuthorizationstringRequired

Bearer authentication

Path parameters
AssetIdstring · uuid · min: 1Required

Unique identifier of the asset.

Responses
delete
/api/v1/asset/credentials/generic-secret/{AssetId}

No content

List ngc-api-keys.

get

Retrieve a list of ngcApiKey assets.

Authorizations
AuthorizationstringRequired

Bearer authentication

Query parameters
namestringOptional

Filter results by name.

scopestringOptional

Filters results by scope. Returns only assets that belong to the specified scope. Mutually exclusive with includeDescendants. Valid values: tenant, cluster, department, project.

projectIdinteger · int32Optional

Filter results by project id. If scope filter is project, only assets from the specific project will be included in the response. Otherwise, the response will include project, department, cluster, tenant and system assets.

departmentIdstringOptional

Filter results by department id. If scope filter is department, only assets from the specific department will be included in the response. Otherwise, the response will include department, cluster, tenant and system assets.

Example: 1
clusterIdstring · uuidOptional

Filter results by Universally Unique Identifier (UUID) of the cluster. If scope filter is cluster, only assets from the specific cluster will be included in the response. Otherwise, the response will include cluster, tenant and system assets.

Example: d73a738f-fab3-430a-8fa3-5241493d7128
usageInfobooleanOptional

Whether the query should include asset usage information as part of the response.

statusInfobooleanOptional

Whether the query should include asset status information as part of the response.

Responses
get
/api/v1/asset/credentials/ngc-api-key

Create a ngc-api-key.

post

Use to create a ngc-api-key asset.

Authorizations
AuthorizationstringRequired

Bearer authentication

Body
Responses
chevron-right
202

Request accepted successfully.

application/json
post
/api/v1/asset/credentials/ngc-api-key

Get a ngc-api-key.

get

Returns the details of a ngc-api-key asset, by id.

Authorizations
AuthorizationstringRequired

Bearer authentication

Path parameters
AssetIdstring · uuid · min: 1Required

Unique identifier of the asset.

Query parameters
usageInfobooleanOptional

Whether the query should include asset usage information as part of the response.

statusInfobooleanOptional

Whether the query should include asset status information as part of the response.

Responses
get
/api/v1/asset/credentials/ngc-api-key/{AssetId}

Update a ngc-api-key.

put

Updates the details of a ngc-api-key asset, by id.

Authorizations
AuthorizationstringRequired

Bearer authentication

Path parameters
AssetIdstring · uuid · min: 1Required

Unique identifier of the asset.

Body
Responses
chevron-right
202

Request accepted successfully.

application/json
put
/api/v1/asset/credentials/ngc-api-key/{AssetId}

Delete a ngc-api-key.

delete

Use to delete a ngc-api-key asset, by id.

Authorizations
AuthorizationstringRequired

Bearer authentication

Path parameters
AssetIdstring · uuid · min: 1Required

Unique identifier of the asset.

Responses
delete
/api/v1/asset/credentials/ngc-api-key/{AssetId}

No content

Last updated