Create a deployment

You may invoke a deployment on your instance with an optional archive file. This archive file allows you to upload a complete version of your application without having to use Git. A common use case for deploying with an archive file is when you're using a pipeline provider such as GitHub actions.

Deployments with an archive file work exactly like Git deployments, but they don't have any commit information associated with them.

When deploying with the Amezmo API, The after.pull deployment hook will not be run. Instead, use the after.extract hook to run code after extracting your archive.

POST /api/sites/{site_id}/deployments


Parameter Description
api_key Your API key.
environment The environment for this deployment. This can be production or staging.
site_id The ID of the instance that this deployment will be executed on.
archive The archive file that contains the source code of your application. This can be a zip or a tar archive. The maximum size of an archive file is 512MB.

Code samples

curl --request POST \
    --url{site_id}/deployments \
    --header 'Authorization: Bearer {api_key}' \
    --header 'Content-Type: multipart/form-data' \
    --form environment=production \
    --form archive=@{archive}


201 Created

    "id": 838,
    "status": "pending"