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

FieldTypeRequiredDescription
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

FieldTypeDescription
success boolean
message string
data BulkUpdateScopeResponse Bulk scope update operation result

Status codes

  • 200 — Bulk scope update completed with results
  • 400 — Invalid scope type
  • 401 — Organization context not set or user not authenticated
  • 403 — Insufficient permissions for Knowledge pillar
  • 429 — —

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.