GoDaddy
Support
API ReferencePlatform & IntegrationNode.js Hosting

Apps

View as Markdown

Create, read, update, and delete apps.

List apps

GET
/apps

Authorization

oauth2 hosting.paas.apps:read
AuthorizationBearer <token>

GoDaddy OAuth access token (Bearer)

In: header

Scope: hosting.paas.apps:read

Response Body

application/json

application/json

curl -X GET "https://api.godaddy.com/v1/hosting/nodejs/apps"
{
  "apps": [
    {
      "id": "string",
      "name": "string",
      "status": "string",
      "createdAt": "string",
      "updatedAt": "string",
      "urls": {
        "preview": "string",
        "publish": "string"
      },
      "variants": [
        {
          "name": "string",
          "status": "string"
        }
      ]
    }
  ]
}
Empty
{
  "error": "string",
  "code": "RATE_LIMITED",
  "detail": "string"
}

Create app

POST
/apps

Authorization

oauth2 hosting.paas.apps:create
AuthorizationBearer <token>

GoDaddy OAuth access token (Bearer)

In: header

Scope: hosting.paas.apps:create

Request Body

application/json

Response Body

application/json

application/json

curl -X POST "https://api.godaddy.com/v1/hosting/nodejs/apps" \  -H "Content-Type: application/json" \  -d '{    "name": "string"  }'
{
  "job": {
    "id": "string",
    "status": "pending"
  }
}
Empty
{
  "error": "string",
  "code": "RATE_LIMITED",
  "detail": "string"
}

Get app creation status

GET
/apps/jobs/{jobId}

Authorization

oauth2 hosting.paas.apps:create
AuthorizationBearer <token>

GoDaddy OAuth access token (Bearer)

In: header

Scope: hosting.paas.apps:create

Path Parameters

jobId*string

Response Body

application/json

application/json

curl -X GET "https://api.godaddy.com/v1/hosting/nodejs/apps/jobs/string"
{
  "job": {
    "id": "string",
    "status": "pending"
  },
  "app": {
    "id": "string",
    "name": "string",
    "status": "string",
    "createdAt": "string",
    "updatedAt": "string",
    "urls": {
      "preview": "string",
      "publish": "string"
    },
    "variants": [
      {
        "name": "string",
        "status": "string"
      }
    ],
    "variantsWithLifecycle": [
      {
        "variant": "string",
        "status": "string",
        "lifecycleState": "string"
      }
    ]
  }
}
Empty
Empty
{
  "error": "string",
  "code": "RATE_LIMITED",
  "detail": "string"
}

Get app

GET
/apps/{appId}

Authorization

oauth2 hosting.paas.apps:read
AuthorizationBearer <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://api.godaddy.com/v1/hosting/nodejs/apps/string"
{
  "app": {
    "id": "string",
    "name": "string",
    "status": "string",
    "createdAt": "string",
    "updatedAt": "string",
    "urls": {
      "preview": "string",
      "publish": "string"
    },
    "variants": [
      {
        "name": "string",
        "status": "string"
      }
    ],
    "variantsWithLifecycle": [
      {
        "variant": "string",
        "status": "string",
        "lifecycleState": "string"
      }
    ]
  }
}
Empty
Empty
{
  "error": "string",
  "code": "RATE_LIMITED",
  "detail": "string"
}

Update app metadata

PATCH
/apps/{appId}

Authorization

oauth2 hosting.paas.apps:update
AuthorizationBearer <token>

GoDaddy OAuth access token (Bearer)

In: header

Scope: hosting.paas.apps:update

Path Parameters

appId*string

Request Body

application/json

Response Body

application/json

application/json

curl -X PATCH "https://api.godaddy.com/v1/hosting/nodejs/apps/string" \  -H "Content-Type: application/json" \  -d '{}'
{
  "app": {
    "id": "string",
    "name": "string",
    "status": "string",
    "createdAt": "string",
    "updatedAt": "string",
    "urls": {
      "preview": "string",
      "publish": "string"
    },
    "variants": [
      {
        "name": "string",
        "status": "string"
      }
    ],
    "variantsWithLifecycle": [
      {
        "variant": "string",
        "status": "string",
        "lifecycleState": "string"
      }
    ]
  }
}
Empty
Empty
{
  "error": "string",
  "code": "RATE_LIMITED",
  "detail": "string"
}

Delete app

DELETE
/apps/{appId}

Authorization

oauth2 hosting.paas.apps:delete
AuthorizationBearer <token>

GoDaddy OAuth access token (Bearer)

In: header

Scope: hosting.paas.apps:delete

Path Parameters

appId*string

Response Body

application/json

curl -X DELETE "https://api.godaddy.com/v1/hosting/nodejs/apps/string"
Empty
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.

Related

Concepts

Last updated on

How is this guide?

Overview

Reference for the Node.js Hosting Public API, a REST API for deploying and operating GoDaddy Node.js Hosting applications. Async-first: long-running writes return immediately with a job or deployment record you poll to completion.

Source

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