Skip to main content
POST
Create build
POST https://api-datahub.octoparse.com/v1/data-apps/{app_id}/builds Authentication: API key required (Authorization: Bearer <API Key>). App author only; others get 404. Freeze the current workspace into an immutable snapshot — the object referenced by debug runs and publishing. Preconditions: a workspace must exist and its current content must be valid (otherwise 422 with issues); the body may include expected_revision (409 if the draft changed between save and freeze). If a ready snapshot with the same content_hash already exists, it is reused and no duplicate row is created. api-type builds become ready immediately; code-type returns 202 and queues an image build — submitting again while one is already in progress for the same app returns 409. Deprecated apps can still build; only new Releases are rejected.

Request

Path parameters

string
required
App reference.

Request body

integer
Expected current draft revision. Mismatch returns 409.

Example request

Response

200 success

The payload is wrapped in data. Fields:
string
required
Build id.
string
required
ready, building (code-type), or failed.
string
required
Content hash.
integer
required
Draft revision at freeze time.
boolean
Whether an existing same-content snapshot was reused.
string
Created time.

Errors

Error responses use {"error": {code, category, message, retryable}}. See Errors.

Client libraries

The Python and JavaScript SDKs do not wrap this endpoint yet. Call REST directly.