Deployments
View as MarkdownPublish the latest code, list past deployments, and probe runtime status.
Authorization
oauth2 hosting.paas.apps:readAuthorizationBearer <token>
GoDaddy OAuth access token (Bearer)
In: header
Scope: hosting.paas.apps:read
Path Parameters
appId*string
Query Parameters
limit?integer
Range
1 <= value <= 50Default
20Response Body
application/json
application/json
curl -X GET "https://example.com/apps/string/deployments"{ "deployments": [ { "id": "string", "status": "pending", "gitHash": "string", "createdAt": "string", "updatedAt": "string", "errorMessage": "string" } ], "totalCount": 0, "hasMore": true}Authorization
oauth2 hosting.paas.deploy:executeAuthorizationBearer <token>
GoDaddy OAuth access token (Bearer)
In: header
Scope: hosting.paas.deploy:execute
Path Parameters
appId*string
Response Body
application/json
application/json
curl -X POST "https://example.com/apps/string/deployments"{ "deploymentId": "string", "status": "string", "commitHash": "string"}Authorization
oauth2 hosting.paas.apps:readAuthorizationBearer <token>
GoDaddy OAuth access token (Bearer)
In: header
Scope: hosting.paas.apps:read
Path Parameters
appId*string
Response Body
application/json
application/json
curl -X GET "https://example.com/apps/string/status"{ "appStatus": "string", "variants": [ { "variant": "string", "status": "string", "lifecycleState": "string" } ]}Agent & Automation Notes
Scopes
hosting.paas.apps:read, hosting.paas.apps:create, hosting.paas.apps:update, hosting.paas.apps:delete, hosting.paas.code:write, hosting.paas.deploy:execute, hosting.paas.secrets:write, hosting.paas.logs:readRate limit10–120 req/min per client IP depending on operation
On failureCreate app returns 202 with a job. Poll GET /apps/jobs/{jobId} until active or failed. Upload and publish return 200 with a job or deployment record. Poll the matching status endpoint until complete. GET operations are safe to retry. Do not resubmit writes without checking current state.
Related
Last updated on
How is this guide?