Publishing
Create build
Freeze the current draft into an immutable snapshot used for debug runs and publishing.
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
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.