REST API reference

DOC Introduction What the Jaws Deploy REST API is for, and how the docs are organized. DOC Authentication How service accounts authenticate against the REST API. DOC Errors and validation How error responses are shaped and how to read them. DOC Workspace, projects, environments How the core resource graph fits together when calling the API. DOC Package types and naming Supported package formats and the filename convention.

POST /api/release Snapshot package versions and the current deployment plan into a new release. POST /api/release/deploy Run an existing release against one or more environments. POST /api/release/promote Promote the latest (or a specific) version of a project to one or more environments.

GET /api/deployment Fetch live status and logs for a running or completed deployment. POST /api/deployment/cancel Cancel a queued or running deployment.

POST /api/packagestore/package Push a build artifact into the workspace feed.

GET /api/project List the projects visible to the service account in a workspace. POST /api/project Create a new project in a workspace. POST /api/project/clone Clone an existing project into the same workspace. PUT /api/project Update project name and description. DELETE /api/project Soft-delete a project. GET /api/project/script-modules See which script modules are imported into a project. PUT /api/project/script-modules Set the full list of script modules imported by a project. POST /api/project/script-module Import a single workspace script module into a project. DELETE /api/project/script-module Remove a single script module assignment from a project. GET /api/project/steps List the ordered deployment steps for a project.

GET /api/project/channels List the channels (release tracks) defined on a project. POST /api/project/channel Create a new channel for a project. PUT /api/project/channel Update a channel's name, description, lifecycle binding, or default flag. DELETE /api/project/channel Delete a project channel.

GET /api/project/workspace-variables List workspace-level variables currently imported into a project. PUT /api/project/workspace-variables Set the full list of workspace variables imported into a project. POST /api/project/workspace-variable Import a single workspace variable into a project. DELETE /api/project/workspace-variable Remove a workspace variable import from a project. POST /api/project/variable Create a project-scoped variable. PUT /api/project/variable Update a project variable's name, description, or type. POST /api/project/variable/value Add a scoped value for a project variable. PUT /api/project/variable/value Update a scoped value on a project variable.

POST /api/project/step Append a new step to a project's deployment plan. POST /api/project/step/clone Copy an existing step into the same or another project. PUT /api/project/step Update step name, scope, run mode, parallelism, error handling, and properties. DELETE /api/project/step Remove a step from a project. PUT /api/project/steps/order Replace the order of a project's steps in one call.

GET /api/environment List the deployment environments in a workspace. POST /api/environment Create a new deployment environment in a workspace. PUT /api/environment Update name, sort order, or color of an environment. DELETE /api/environment Soft-delete an environment.

GET /api/lifecycle List the release lifecycles defined in a workspace. POST /api/lifecycle Create a new release lifecycle. PUT /api/lifecycle Update a lifecycle's name, description, or phase list. DELETE /api/lifecycle Delete a lifecycle. POST /api/lifecycle/phase Append a phase to a lifecycle. PUT /api/lifecycle/phase Update name, requirements, or environments of a phase. DELETE /api/lifecycle/phase Remove a phase from a lifecycle. PUT /api/lifecycle/phase/environment Attach an environment to a phase or change its trigger mode. DELETE /api/lifecycle/phase/environment Remove an environment from a phase.

GET /api/feed List package feeds in a workspace. POST /api/feed Register a new external feed in a workspace. PUT /api/feed Update an external feed's connection details. DELETE /api/feed Delete an external feed.

GET /api/cloud-account List cloud accounts configured in a workspace. POST /api/cloud-account Register an Azure cloud account in a workspace. PUT /api/cloud-account Update a cloud account's settings or credentials. DELETE /api/cloud-account Soft-delete a cloud account.

GET /api/step-template List the step templates in a workspace. POST /api/step-template Define a new reusable step template. PUT /api/step-template Update a step template's name, script, properties, or run modes. DELETE /api/step-template Soft-delete a step template.

GET /api/script-module List the script modules in a workspace. POST /api/script-module Add a new script module to a workspace. PUT /api/script-module Update a script module's body, language, or metadata. DELETE /api/script-module Soft-delete a script module.

GET /api/tag List the tags defined in a workspace. POST /api/tag Create a new tag in a workspace. PUT /api/tag Rename a tag. DELETE /api/tag Delete a tag.

GET /api/workspace-variable List the variables defined at the workspace level. POST /api/workspace-variable Create a new variable at the workspace level. PUT /api/workspace-variable Update workspace variable metadata. DELETE /api/workspace-variable Soft-delete a workspace variable. POST /api/workspace-variable/value Add a scoped value to a workspace variable. PUT /api/workspace-variable/value Update a scoped value on a workspace variable. DELETE /api/workspace-variable/value Soft-delete a workspace variable value.