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. GET /api/me Return the service account the request authenticated as, and the organization it belongs to. 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.

GET /api/release Page through a project's releases, newest first, with the notes and metadata of each one. GET /api/release/details Read one release with the snapshot it will deploy - packages, steps, variables and lifecycle phases. 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/list Page through the deployments of a workspace, a project or a single release - and poll for what has changed. GET /api/deployment Fetch live status and logs for a running or completed deployment. GET /api/deployment/targets Find out which machines and cloud targets each step of a deployment matched, and which of them actually ran it. POST /api/deployment/cancel Cancel a queued or running deployment.

POST /api/packagestore/package Push a build artifact into the workspace feed. POST /api/packagestore/package/negotiate Request a pre-authorized direct-to-storage upload URL for a package. POST /api/packagestore/package/confirm Promote a directly uploaded package into the workspace feed.

GET /api/workspace List the workspaces visible to the service account. POST /api/workspace Create a workspace, optionally pinned to a package store location. GET /api/workspace/regions List the active regions a workspace's package store can be pinned to.

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, including their version rules. POST /api/project/channel Create a new channel for a project, optionally gating which release and package versions it accepts. PUT /api/project/channel Update a channel's name, description, lifecycle binding, default flag, or version rules. 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/project/rolling-groups List a project's rolling groups with their settings and member step ids. POST /api/project/rolling-group Group a consecutive run of steps so one machine completes all of them before the next begins. PUT /api/project/rolling-group Change a group's own settings. Membership is not changed here. DELETE /api/project/rolling-group Dissolve a group. Its steps are kept and released from it. PUT /api/project/step/rolling-group Move one step into a group, or out of the group it is in.

GET /api/environment List the deployment environments in a workspace, and whether each one is accepting deployments. POST /api/environment Create a new deployment environment in a workspace. PUT /api/environment Rename an environment, restyle it, reorder it, or take it out of service. DELETE /api/environment Soft-delete an environment.

GET /api/machine List the machines in a workspace with the environments each one is assigned to. GET /api/machine/environments Return the environments one machine is currently assigned to. PUT /api/machine/environments Set the complete list of environments a machine is assigned to. POST /api/machine/environment Add one environment to a machine, leaving its other assignments alone. DELETE /api/machine/environment Remove one environment from a machine, leaving its other assignments alone.

GET /api/lifecycle List the release lifecycles defined in a workspace. GET /api/lifecycle/details Retrieve one lifecycle by ID. 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. GET /api/step-template/details Retrieve one complete step template by ID or name. 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.