Skip to main content
PATCH
設定を更新
PATCH https://api-datahub.octoparse.com/v1/data-apps/{app_id}/settings Authentication: API key required (Authorization: Bearer <API Key>). App author only; others get 404. App-level, reversible ops state orthogonal to lifecycle — adjustable any time:
  • scope: public market-visible / private author only / shared grant list (maintain the list via the grant endpoints).
  • accepting_runs: maintenance switch. false means under maintenance; new runs from others are rejected (403 app-not-accepting-runs, message carries pause_message). Existing runs, purchased data, and market visibility are unaffected; author self-tests are unrestricted. Flip back to true after upstream recovery — no lifecycle change required.
  • source_locale: language of the manifest text (for example zh-CN / en-US). Unset uses the deployment default. Translations for other languages layer on top of this source. If the new source locale already has a translation, the response includes a translation-shadowed-by-source warning and does not auto-delete it.
Apps with zero Releases can also be updated.

Request

Path parameters

string
必須
App reference.

Request body

enum
Visibility scope: public / private / shared.Allowed values: public / private / shared.
boolean
Whether to accept new runs from others.
string
Message shown to callers while under maintenance.
string
Source locale code of the manifest.

Example request

Response

200 success

The payload is wrapped in data. Fields:
string
必須
Current visibility scope.
boolean
必須
Current maintenance switch.
string
Current maintenance message.
string
必須
Current source locale.
object[]
Structured warnings.

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.