Scripts

List Scripts

get

Retrieves a paginated list of scripts. Can be filtered by name and versions.id.

Authorizations
AuthorizationstringRequired

API key passed in the Authorization header. Format: <api-key>

Query parameters
filter[name]stringOptional

Filter results by name.

filter[versions.id]stringOptional

Filter results by versions.id.

includestringOptional

Comma-separated list of relationships to include. Available: versions, versions.content, latestVersion, latestVersion.content

sortstringOptional

Sort field. Prefix with - for descending. Available: name

fields[versions]stringOptional

Comma-separated list of versions fields to return. Available: id, script_id, version, name, deployed_at, deployment_failed_at, deploying, deployment_failure_reason

pageinteger · min: 1Optional

Page number for pagination.

Default: 1
per_pageinteger · min: 1 · max: 100Optional

Number of results per page.

Responses
chevron-right
200

Successful response

application/json
get
/api/v1/scripts

Create Script

post

Creates a new script.

Authorizations
AuthorizationstringRequired

API key passed in the Authorization header. Format: <api-key>

Body
descriptionstring · max: 255 · nullableOptional
languagestringRequired
ai_createdstring · nullableOptional
namestring · max: 255Required
Responses
chevron-right
200

Successful response

application/json
post
/api/v1/scripts

Get Script

get

Retrieves the details of a specific script.

Authorizations
AuthorizationstringRequired

API key passed in the Authorization header. Format: <api-key>

Path parameters
scriptstringRequired

The script identifier.

Query parameters
filter[name]stringOptional

Filter results by name.

filter[versions.id]stringOptional

Filter results by versions.id.

includestringOptional

Comma-separated list of relationships to include. Available: versions, versions.content, latestVersion, latestVersion.content

sortstringOptional

Sort field. Prefix with - for descending. Available: name

fields[versions]stringOptional

Comma-separated list of versions fields to return. Available: id, script_id, version, name, deployed_at, deployment_failed_at, deploying, deployment_failure_reason

pageinteger · min: 1Optional

Page number for pagination.

Default: 1
per_pageinteger · min: 1 · max: 100Optional

Number of results per page.

Responses
chevron-right
200

Successful response

application/json
get
/api/v1/scripts/{script}

Update Script

put

Updates an existing script.

Authorizations
AuthorizationstringRequired

API key passed in the Authorization header. Format: <api-key>

Path parameters
scriptstringRequired

The script identifier.

Body
descriptionstring · max: 255 · nullableOptional
languagestringOptional
valuestring · min: 1Optional
namestring · max: 255Optional
Responses
chevron-right
200

Successful response

application/json
put
/api/v1/scripts/{script}

Delete Script

delete

Permanently deletes a specific script.

Authorizations
AuthorizationstringRequired

API key passed in the Authorization header. Format: <api-key>

Path parameters
scriptstringRequired

The script identifier.

Responses
chevron-right
200

Successful response

application/json
messagestringOptional
delete
/api/v1/scripts/{script}

Last updated

Was this helpful?