API Reference / Knowledge - Artifacts
Update artifact scope
patch
https://api.intelig.ai/api/v1/intelig/knowledge/artifacts/{id}/scope
Auth: Authorization: ApiKey <key> (an API key sent as
Bearer is rejected) or Authorization: Bearer <jwt>
for a dashboard session. operationId: updateArtifactScope
Changes the visibility scope of an artifact (ORGANIZATION or PERSONAL). Only the artifact owner can update scope.
Example request
curl -X PATCH "https://api.intelig.ai/api/v1/intelig/knowledge/artifacts/1/scope" \
-H "Authorization: ApiKey $INTELIG_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"scopeType": "ORGANIZATION"
}' Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | integer (int64) | yes | — |
Request body
application/json
| Field | Type | Required | Description |
|---|---|---|---|
scopeType | string | yes | New scope type: ORGANIZATION (visible to all) or PERSONAL (private to owner) One of: ORGANIZATION, PERSONAL Example: ORGANIZATION |
Response 200
application/json · ApiResponseKnowledgeArtifactDto
| Field | Type | Description |
|---|---|---|
success | boolean | — |
message | string | — |
data | KnowledgeArtifactDto | Knowledge artifact details |
Status codes
200— Scope updated successfully400— Invalid scope type401— Organization context not set or user not authenticated403— Not the artifact owner or insufficient permissions404— Artifact not found429— —
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.