Skip to main content
POST
Batch grants
POST https://api-datahub.octoparse.com/v1/data-apps/batch/grants Authentication: API key required (Authorization: Bearer <API Key>). Open multiple apps you own to multiple users in one call (matrix semantics, idempotent). Storage and effective rules match single-user grant. Each username is resolved once. granted counts only new pairs; pairs already on the list are skipped idempotently so you can tell “3 added, 2 already present”.

Request

Request body

string[]
required
string[]
required
Username list.

Example request

Response

200 success

The payload is wrapped in data. Fields:
integer
required
Number of newly created grant pairs.
integer
required
object[]
required
Per-app processing result.
object[]
required
Per-user resolution result.

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.