For the complete documentation index, see llms.txt. This page is also available as Markdown.

Workload templates

This set of endpoints manages workload templates used to define reusable workload configurations across various workload types in the NVIDIA Run:ai platform. Templates help standardize workload definitions for consistent submission and resource usage across projects and users.

List templates. [Experimental]

get

Retrieve all available templates.

Authorizations
AuthorizationstringRequired

Bearer authentication

Query parameters
offsetinteger · int32Optional

The offset of the first item returned in the collection.

Example: 100
limitinteger · int32 · min: 1 · max: 500Optional

The maximum number of entries to return.

Default: 50
sortOrderstring · enumOptional

Sort results in descending or ascending order.

Default: ascPossible values:
sortBystring · enumOptional

Sort results by parameter.

Possible values:
filterBystring[]Optional

Filter results by a parameter. Use the format field-name operator value. Operators are == Equals, != Not equals, <= Less than or equal, >= Greater than or equal, =@ contains, !@ Does not contain, =^ Starts with and =$ Ends with. Dates are in ISO 8601 timestamp format and available for operators ==, !=, <= and >=.

Example: ["name!=some-template-name","createdAt>=2021-01-01T00:00:00Z"]
searchstringOptional

Filter results by a free text search.

Example: test project
Responses
200

Executed successfully.

application/json
get/api/v1/workload-templates

Get a template, any type. [Experimental]

get

Retrieve the details of a template using its id.

Authorizations
AuthorizationstringRequired

Bearer authentication

Path parameters
templateIdstring · uuidRequired

The Universally Unique Identifier (UUID) of the template.

Example: 550e8400-e29b-41d4-a716-446655440000
Responses
200

Executed successfully.

application/json
and
get/api/v1/workload-templates/{templateId}

Count templates. [Experimental]

get

Get the total number of templates.

Authorizations
AuthorizationstringRequired

Bearer authentication

Query parameters
filterBystring[]Optional

Filter results by a parameter. Use the format field-name operator value. Operators are == Equals, != Not equals, <= Less than or equal, >= Greater than or equal, =@ contains, !@ Does not contain, =^ Starts with and =$ Ends with. Dates are in ISO 8601 timestamp format and available for operators ==, !=, <= and >=.

Example: ["name!=some-template-name","createdAt>=2021-01-01T00:00:00Z"]
searchstringOptional

Filter results by a free text search.

Example: test project
Responses
200

Executed successfully.

application/json
countinteger · int64RequiredExample: 1
get/api/v1/workload-templates/count

List all workspace templates. [Experimental]

get

List all workspace templates.

Authorizations
AuthorizationstringRequired

Bearer authentication

Query parameters
offsetinteger · int32Optional

The offset of the first item returned in the collection.

Example: 100
limitinteger · int32 · min: 1 · max: 500Optional

The maximum number of entries to return.

Default: 50
sortOrderstring · enumOptional

Sort results in descending or ascending order.

Default: ascPossible values:
sortBystring · enumOptional

Sort results by parameter.

Possible values:
filterBystring[]Optional

Filter results by a parameter. Use the format field-name operator value. Operators are == Equals, != Not equals, <= Less than or equal, >= Greater than or equal, =@ contains, !@ Does not contain, =^ Starts with and =$ Ends with. Dates are in ISO 8601 timestamp format and available for operators ==, !=, <= and >=.

Example: ["name!=some-template-name","createdAt>=2021-01-01T00:00:00Z"]
searchstringOptional

Filter results by a free text search.

Example: test project
Responses
200

Executed successfully.

application/json
get/api/v1/workload-templates/workspaces

Create a new workspace template. [Experimental]

post

Create a new workspace template.

Authorizations
AuthorizationstringRequired

Bearer authentication

Body
and
and
anyOptional
Responses
202

Request completed successfully.

application/json
and
and
anyOptional
and
post/api/v1/workload-templates/workspaces

Retrieve a specific workspace template by ID. [Experimental]

get

Retrieve a specific workspace template by ID.

Authorizations
AuthorizationstringRequired

Bearer authentication

Path parameters
templateIdstring · uuidRequired

The Universally Unique Identifier (UUID) of the template.

Example: 550e8400-e29b-41d4-a716-446655440000
Responses
200

Executed successfully.

application/json
and
and
anyOptional
and
get/api/v1/workload-templates/workspaces/{templateId}

Update a workspace template by ID. [Experimental]

put

Update a workspace template by ID.

Authorizations
AuthorizationstringRequired

Bearer authentication

Path parameters
templateIdstring · uuidRequired

The Universally Unique Identifier (UUID) of the template.

Example: 550e8400-e29b-41d4-a716-446655440000
Body
and
and
anyOptional
Responses
200

Executed successfully.

application/json
and
and
anyOptional
and
put/api/v1/workload-templates/workspaces/{templateId}

Delete a workspace template by ID. [Experimental]

delete

Delete a workspace template by ID.

Authorizations
AuthorizationstringRequired

Bearer authentication

Path parameters
templateIdstring · uuidRequired

The Universally Unique Identifier (UUID) of the template.

Example: 550e8400-e29b-41d4-a716-446655440000
Responses
204

No Content.

No content

delete/api/v1/workload-templates/workspaces/{templateId}

No content

Patch a workspace template by ID. [Experimental]

patch

Patch a workspace template by ID.

Authorizations
AuthorizationstringRequired

Bearer authentication

Path parameters
templateIdstring · uuidRequired

The Universally Unique Identifier (UUID) of the template.

Example: 550e8400-e29b-41d4-a716-446655440000
Body

array of xpath expression with fields that their values should be cleared

fieldsToClearanyOptionalExample: spec.image
Responses
200

Executed successfully.

application/json
and
and
anyOptional
and
patch/api/v1/workload-templates/workspaces/{templateId}

List all training templates. [Experimental]

get

List all training templates.

Authorizations
AuthorizationstringRequired

Bearer authentication

Query parameters
offsetinteger · int32Optional

The offset of the first item returned in the collection.

Example: 100
limitinteger · int32 · min: 1 · max: 500Optional

The maximum number of entries to return.

Default: 50
sortOrderstring · enumOptional

Sort results in descending or ascending order.

Default: ascPossible values:
sortBystring · enumOptional

Sort results by parameter.

Possible values:
filterBystring[]Optional

Filter results by a parameter. Use the format field-name operator value. Operators are == Equals, != Not equals, <= Less than or equal, >= Greater than or equal, =@ contains, !@ Does not contain, =^ Starts with and =$ Ends with. Dates are in ISO 8601 timestamp format and available for operators ==, !=, <= and >=.

Example: ["name!=some-template-name","createdAt>=2021-01-01T00:00:00Z"]
searchstringOptional

Filter results by a free text search.

Example: test project
Responses
200

Executed successfully.

application/json
get/api/v1/workload-templates/trainings

Create a new training template. [Experimental]

post

Create a new training template.

Authorizations
AuthorizationstringRequired

Bearer authentication

Body
and
and
anyOptional
Responses
202

Request completed successfully.

application/json
and
and
anyOptional
and
post/api/v1/workload-templates/trainings

Retrieve a specific training template by ID. [Experimental]

get

Retrieve a specific training template by ID.

Authorizations
AuthorizationstringRequired

Bearer authentication

Path parameters
templateIdstring · uuidRequired

The Universally Unique Identifier (UUID) of the template.

Example: 550e8400-e29b-41d4-a716-446655440000
Responses
200

Executed successfully.

application/json
and
and
anyOptional
and
get/api/v1/workload-templates/trainings/{templateId}

Update a training template by ID. [Experimental]

put

Update a training template by ID.

Authorizations
AuthorizationstringRequired

Bearer authentication

Path parameters
templateIdstring · uuidRequired

The Universally Unique Identifier (UUID) of the template.

Example: 550e8400-e29b-41d4-a716-446655440000
Body
and
and
anyOptional
Responses
200

Executed successfully.

application/json
and
and
anyOptional
and
put/api/v1/workload-templates/trainings/{templateId}

Delete a training template by ID. [Experimental]

delete

Delete a training template by ID.

Authorizations
AuthorizationstringRequired

Bearer authentication

Path parameters
templateIdstring · uuidRequired

The Universally Unique Identifier (UUID) of the template.

Example: 550e8400-e29b-41d4-a716-446655440000
Responses
204

No Content.

No content

delete/api/v1/workload-templates/trainings/{templateId}

No content

Patch a training template by ID. [Experimental]

patch

Patch a training template by ID.

Authorizations
AuthorizationstringRequired

Bearer authentication

Path parameters
templateIdstring · uuidRequired

The Universally Unique Identifier (UUID) of the template.

Example: 550e8400-e29b-41d4-a716-446655440000
Body

array of xpath expression with fields that their values should be cleared

fieldsToClearanyOptionalExample: spec.image
Responses
200

Executed successfully.

application/json
and
and
anyOptional
and
patch/api/v1/workload-templates/trainings/{templateId}

List all distributed training templates. [Experimental]

get

List all distributed training templates.

Authorizations
AuthorizationstringRequired

Bearer authentication

Query parameters
offsetinteger · int32Optional

The offset of the first item returned in the collection.

Example: 100
limitinteger · int32 · min: 1 · max: 500Optional

The maximum number of entries to return.

Default: 50
sortOrderstring · enumOptional

Sort results in descending or ascending order.

Default: ascPossible values:
sortBystring · enumOptional

Sort results by parameter.

Possible values:
filterBystring[]Optional

Filter results by a parameter. Use the format field-name operator value. Operators are == Equals, != Not equals, <= Less than or equal, >= Greater than or equal, =@ contains, !@ Does not contain, =^ Starts with and =$ Ends with. Dates are in ISO 8601 timestamp format and available for operators ==, !=, <= and >=.

Example: ["name!=some-template-name","createdAt>=2021-01-01T00:00:00Z"]
searchstringOptional

Filter results by a free text search.

Example: test project
Responses
200

Executed successfully.

application/json
get/api/v1/workload-templates/distributed

Create a new distributed training template. [Experimental]

post

Create a new distributed training template.

Authorizations
AuthorizationstringRequired

Bearer authentication

Body
and
Responses
202

Request completed successfully.

application/json
and
post/api/v1/workload-templates/distributed

Get a specific distributed training template by ID. [Experimental]

get

Get a specific distributed training template by ID.

Authorizations
AuthorizationstringRequired

Bearer authentication

Path parameters
templateIdstring · uuidRequired

The Universally Unique Identifier (UUID) of the template.

Example: 550e8400-e29b-41d4-a716-446655440000
Responses
200

Executed successfully.

application/json
and
get/api/v1/workload-templates/distributed/{templateId}

Update a distributed training template by ID. [Experimental]

put

Update a distributed training template by ID.

Authorizations
AuthorizationstringRequired

Bearer authentication

Path parameters
templateIdstring · uuidRequired

The Universally Unique Identifier (UUID) of the template.

Example: 550e8400-e29b-41d4-a716-446655440000
Body
and
Responses
200

Executed successfully.

application/json
and
put/api/v1/workload-templates/distributed/{templateId}

Delete a distributed training template by ID. [Experimental]

delete

Delete a distributed training template by ID.

Authorizations
AuthorizationstringRequired

Bearer authentication

Path parameters
templateIdstring · uuidRequired

The Universally Unique Identifier (UUID) of the template.

Example: 550e8400-e29b-41d4-a716-446655440000
Responses
204

No Content.

No content

delete/api/v1/workload-templates/distributed/{templateId}

No content

Patch a distributed training template by ID. [Experimental]

patch

Patch a distributed training template by ID.

Authorizations
AuthorizationstringRequired

Bearer authentication

Path parameters
templateIdstring · uuidRequired

The Universally Unique Identifier (UUID) of the template.

Example: 550e8400-e29b-41d4-a716-446655440000
Body

array of xpath expression with fields that their values should be cleared

masterSpecSameAsWorkerboolean · nullableOptional

used for distributed workloads to indicate that the master spec should be the same as the worker spec. in this case, masterSpec should not be specified.

fieldsToClearanyOptionalExample: spec.image
Responses
200

Executed successfully.

application/json
and
patch/api/v1/workload-templates/distributed/{templateId}

Last updated