API Reference / Knowledge - Artifacts
Bulk update artifact scope
patch
https://api.intelig.ai/api/v1/intelig/knowledge/artifacts/scope
Auth: Authorization: ApiKey <key> (an API key sent as
Bearer is rejected) or Authorization: Bearer <jwt>
for a dashboard session. operationId: bulkUpdateArtifactScope
Changes the visibility scope of multiple artifacts in a single operation. Only artifacts owned by the requesting user will be updated; others are silently skipped.
Example request
curl -X PATCH "https://api.intelig.ai/api/v1/intelig/knowledge/artifacts/scope" \
-H "Authorization: ApiKey $INTELIG_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"artifactIds": [
12,
13,
14
],
"scopeType": "ORGANIZATION"
}' Request body
application/json
| Field | Type | Required | Description |
|---|---|---|---|
artifactIds | integer[] | yes | Artifacts to update. Artifacts you do not own are skipped. Example: [12,13,14] |
scopeType | string | yes | New scope type for all artifacts: ORGANIZATION (visible to all) or PERSONAL (private to owner) One of: ORGANIZATION, PERSONAL Example: ORGANIZATION |
Response 200
application/json · ApiResponseBulkUpdateScopeResponse
| Field | Type | Description |
|---|---|---|
success | boolean | — |
message | string | — |
data | BulkUpdateScopeResponse | Bulk scope update operation result |
Status codes
200— Bulk scope update completed with results400— Invalid scope type401— Organization context not set or user not authenticated403— Insufficient permissions for Knowledge pillar429— —
Every response is wrapped in { success, message, data }. A 4xx means the request
is wrong — do not retry it unchanged. A 429 carries Retry-After in seconds.