Support
API ReferencePlatform & IntegrationNode.js Hosting

Upload app source as a zip and poll the upload job.

Upload app source (zip)

POST
/apps/{appId}/source

Authorization

oauth2 hosting.paas.code:write
AuthorizationBearer <token>

GoDaddy OAuth access token (Bearer)

In: header

Scope: hosting.paas.code:write

Path Parameters

appId*string

Request Body

multipart/form-data

zipFile*string

Response Body

application/json

application/json

curl -X POST "https://api.godaddy.com/v1/hosting/nodejs/apps/string/source" \  -F zipFile="string"
{
  "jobId": "string"
}
Empty
Empty
{
  "error": "string",
  "code": "RATE_LIMITED",
  "detail": "string"
}

Poll zip upload status

GET
/apps/{appId}/source/status

Authorization

oauth2 hosting.paas.code:write
AuthorizationBearer <token>

GoDaddy OAuth access token (Bearer)

In: header

Scope: hosting.paas.code:write

Path Parameters

appId*string

Query Parameters

jobId*string

Response Body

application/json

application/json

curl -X GET "https://api.godaddy.com/v1/hosting/nodejs/apps/string/source/status?jobId=string"
{
  "status": "string",
  "progressMessage": "string",
  "errorMessage": "string",
  "errorStage": "string"
}
Empty
Empty
{
  "error": "string",
  "code": "RATE_LIMITED",
  "detail": "string"
}

Agent & Automation Notes

Scopeshosting.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:read
Rate 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, publish, and rollback 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.

Last updated on

How is this guide?