With the deployments
endpoint, you can get deployment details like the deployment progress and more.
You can also send a POST
request to the endpoint to manually or programmatically deploy an application. This request can be done from your terminal or using an automated script or CI/CD pipeline (e.g. CircleCI, Jenkins, etc.).
You can obtain the deployment_id
from the applications
endpoint.
The deployment_id
is also shown in the URL within the deployment in MyKinsta, for example in the URL https://my.kinsta.com/app/hello-world-astro-7u8mu/deployment/6783883e-4af8-47ab-a03a-3db6177d4291?idCompany=bdd25d71-5706-4890-870f-1adda17c505d
the deployment_id
is 6783883e-4af8-47ab-a03a-3db6177d4291
.
Response object of application deployment by ID requests
No or invalid API key provided to the request
Could not find the application deployment or the user does not have permissions to retrieve data
Error occurred while retrieving application deployment
{- "deployment": {
- "id": "54fb80af-576c-4fdc-ba4f-b596c83f15a1",
- "app_id": "54fb80af-576c-4fdc-ba4f-b596c83f15a1",
- "branch": "main",
- "commit_sha": "54fb80af-576c-4fdc-ba4f-b596c83f15a1",
- "author_login": "john-doe",
- "commit_message": "docs: example",
- "status": "success",
- "created_at": 1665382600770
}
}
Deployment created successfully
No or invalid API key provided to the request
Error occurred while creating the deployment
{- "app_id": "54fb80af-576c-4fdc-ba4f-b596c83f15a1",
- "branch": "main"
}
{- "deployment": {
- "id": "54fb80af-576c-4fdc-ba4f-b596c83f15a1"
}
}
App promoted successfully
No or invalid API key provided to the request
Error occurred while promoting the app
{- "source_app_id": "54fb80af-576c-4fdc-ba4f-b596c83f15a1",
- "target_app_ids": [
- "14fb80af-576c-4fdc-ba4f-b596c83f15a1"
]
}
{- "promote": [
- {
- "target_app_id": "14fb80af-576c-4fdc-ba4f-b596c83f15a1",
- "deployment_id": "34fb80af-576c-4fdc-ba4f-b596c83f15a1"
}
]
}