Import source code | GoDaddy Developers
API Reference Hosting Hosting Import source code POST Import source code View as Markdown Imports source code for an application. Full description Imports source code for an application. The Content-Type header determines the import type: - multipart/form-data : upload a ZIP archive directly. - application/json : upload from a connected GitHub repository. Returns 202 Accepted with a SourceImport resource. The importType field identifies what was submitted.
Poll GET /apps/{appId}/imports/{importId} until status is COMPLETED or FAILED . Authorization bearerAuth Authorization Bearer <token> Personal Access Token (PAT). Generate one from the developer dashboard. Pass as: Authorization: Bearer <token> . In : header Path Parameters appId * string Application identifier in {PRODUCT}-{id} form. The prefix is the application type in upper case — an upper-case letter followed by any number of upper-case letters, digits, or underscores — then a hyphen, then the identifier.
For NODEJS , the suffix is a 10-character nanoid. Example: NODEJS-aBcDeFgHiJ . Match ^[A-Z][A-Z0-9_]*-[A-Za-z0-9_-]+$ Header Parameters Idempotency-Key ? string Client-generated UUID that makes a request safe to retry. Supplying the same key on a retry with an identical request body returns the original response without triggering a second operation. Retrying with the same key while the first request is still in flight returns 409 Conflict .
Reusing a key with a different request body returns 422 Unprocessable Entity with details[].issue IDEMPOTENCY_KEY_MISMATCH . Keys are retained for 24 hours after the operation completes, after which the key may be reused. Format uuid traceparent ? string W3C Trace Context identifier for this request. Clients should send a traceparent on every request so the trace can be correlated across services. See https://www.w3.org/TR/trace-context/ for the format.
Match ^[0-9a-f]{2}-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$ Request Body Response Body application/json application/json application/json application/json application/json application/json application/json application/json application/json application/json curl -X POST "https://example.com/apps/string/imports" \ -H "Content-Type: application/json" \ -d '{ "repositoryFullName": "acme-corp/my-node-app", "branch": "main" }' { "importId": "string", "importType": "ZIP", "status": "PENDING", "gitHash": "string", "createdAt": "stringstringstringst", "error": { "name": "string", "correlationId": "string", "message": "string", "informationLink": "string", "details": [ { "field": "string", "value": "string", "location": "body", "issue": "string", "description": "string" } ], "links": [ { "href": "http://example.com", "rel": "string", "title": "string", "targetMediaType": "string", "targetSchema": null, "method": "string", "submissionMediaType": "application/json", "submissionSchema": null } ] }, "links": [ { "href": "http://example.com", "rel": "string", "title": "string", "targetMediaType": "string", "targetSchema": null, "method": "string", "submissionMediaType": "application/json", "submissionSchema": null } ] } Agent & Automation Notes Scopes hosting.application:read, hosting.application:create, hosting.application:update, hosting.application:delete, hosting.source:write, hosting.deployment:execute, hosting.secret:write, hosting.log:read Rate limit 10–120 req/min per client IP depending on operation On failure Create app returns 202 with a job.
Poll GET /app-operations/{operationId} until app is ready. Upload source and deployments return 202 with an operation ID. Poll the matching status endpoint until complete. GET operations are safe to retry. Do not resubmit writes without checking current state. Related Guides Get started Authentication Concepts Hosting concepts Tutorials Deploy your first app Last updated on How is this guide? file * file ZIP archive of the application source code.
Format binary