StackScripts v4.166.0

StackScripts List

GET https://api.linode.com/v4/linode/stackscripts

If the request is not authenticated, only public StackScripts are returned.

For more information on StackScripts, please read our StackScripts documentation.

Authorizations

personalAccessToken
oauthstackscripts:read_only

Query Parameters

page
Type:
integer >= 1
Default: 1
Default:
1

The page of a collection to return.

page_size
Type:
integer 25..500
Default: 100
Default:
100

The number of items to return per page.

Request Samples

Response Samples

Responses

StackScript Create

POST https://api.linode.com/v4/linode/stackscripts

Creates a StackScript in your Account.

Authorizations

personalAccessToken
oauthstackscripts:read_write

Request Samples

Request Body Schema

description
string

A description for the StackScript.

images
Required
array of strings

An array of Image IDs. These are the Images that can be deployed with this StackScript.

any/all indicates that all available Images, including private Images, are accepted.

is_public
boolean

This determines whether other users can use your StackScript. Once a StackScript is made public, it cannot be made private.

label
Required
string 3..128 characters

The StackScript’s label is for display purposes only.

rev_note
string

This field allows you to add notes for the set of revisions made to this StackScript.

script
Required
string

The script to execute when provisioning a new Linode with this StackScript.

Response Samples

Responses

StackScript Delete

DELETE https://api.linode.com/v4/linode/stackscripts/{stackscriptId}

Deletes a private StackScript you have permission to read_write. You cannot delete a public StackScript.

Authorizations

personalAccessToken
oauthstackscripts:read_write

Path Parameters

stackscriptIdstring
Required

The ID of the StackScript to look up.

Request Samples

Response Samples

Responses

StackScript View

GET https://api.linode.com/v4/linode/stackscripts/{stackscriptId}

Returns all of the information about a specified StackScript, including the contents of the script.

Authorizations

personalAccessToken
oauthstackscripts:read_only

Path Parameters

stackscriptIdstring
Required

The ID of the StackScript to look up.

Request Samples

Response Samples

Responses

StackScript Update

PUT https://api.linode.com/v4/linode/stackscripts/{stackscriptId}

Updates a StackScript.

Once a StackScript is made public, it cannot be made private.

Authorizations

personalAccessToken
oauthstackscripts:read_write

Path Parameters

stackscriptIdstring
Required

The ID of the StackScript to look up.

Request Samples

Request Body Schema

description
string

A description for the StackScript.

images
array of strings

An array of Image IDs. These are the Images that can be deployed with this StackScript.

any/all indicates that all available Images, including private Images, are accepted.

is_public
boolean

This determines whether other users can use your StackScript. Once a StackScript is made public, it cannot be made private.

label
string 3..128 characters

The StackScript’s label is for display purposes only.

rev_note
string

This field allows you to add notes for the set of revisions made to this StackScript.

script
string

The script to execute when provisioning a new Linode with this StackScript.

Response Samples

Responses