Error codes

authz.forbidden

HTTP status

403

Message

permission '{permission}' required

Returned by

• PUT/v1/groups/{group_id}/members/{user_id}Add a member to a group
• GET/v1/analytics/cards/{card_id}Get card metrics
• GET/v1/analytics/contributionGet the contribution dashboard
• GET/v1/analytics/healthGet the knowledge health dashboard
• GET/v1/analytics/usageGet the usage dashboard
• GET/v1/announcements/{announcement_id}/statsGet the announcement report
• GET/v1/audit/verifyVerify the integrity of the organization's audit log
• POST/v1/cards/bulkRun a bulk action on cards
• GET/v1/cards/{card_id}/permissionsGet permissions on a card (direct and inherited)
• GET/v1/collections/{name}/permissionsGet permissions on a collection (direct and inherited)
• GET/v1/collections/{name}/trustGet the Trust Score of a collection
• POST/v1/rolesCreate a custom role
• POST/v1/announcementsSend a must-read announcement
• POST/v1/cards/{card_id}/threadsAdd a comment or a reply in a thread
• POST/v1/draftsCreate a draft
• POST/v1/collections/{name}/foldersCreate a folder
• POST/v1/quality/gaps/followupsTake a knowledge gap into work
• POST/v1/groupsCreate a group
• POST/v1/sources/{source_id}/push-keysCreate an API key for a custom source
• POST/v1/cards/textCreate a text card (Markdown)
• POST/v1/webhooksCreate a webhook
• DELETE/v1/roles/{role_id}Delete a custom role
• DELETE/v1/folders/{folder_id}Delete a folder and promote its content
• DELETE/v1/groups/{group_id}Delete a group
• DELETE/v1/webhooks/{webhook_id}Delete a webhook
• GET/v1/folders/{folder_id}/cardsList the cards of a folder
• GET/v1/folders/{folder_id}/permissionsGet permissions on a folder (direct and inherited)
• GET/v1/collections/{name}/foldersGet the folder tree of a collection
• GET/v1/folders/{folder_id}Get a folder
• GET/v1/webhooks/{webhook_id}Get a webhook
• GET/v1/webhooks/{webhook_id}/deliveries/{delivery_id}Get a delivery with bodies and attempts
• GET/v1/webhook-events/{event_id}Get an event
• POST/v1/access-requests/{request_id}/grantGrant access on a request
• PUT/v1/cards/{card_id}/permissionsGrant roles on a card
• PUT/v1/collections/{name}/permissionsGrant roles on a collection
• PUT/v1/folders/{folder_id}/permissionsGrant roles on a folder
• PUT/v1/org/permissionsGrant roles on the organization
• PUT/v1/sources/{source_id}/permissionsGrant roles on a source
• GET/v1/announcementsList announcements
• GET/v1/draftsList drafts
• GET/v1/quality/gaps/followupsList knowledge gaps in progress
• GET/v1/sources/{source_id}/push-keysList API keys of a custom source
• GET/v1/sources/{source_id}/push-syncsList syncs of a custom source
• GET/v1/webhooks/{webhook_id}/attemptsList delivery attempts
• GET/v1/webhooks/{webhook_id}/deliveriesList webhook deliveries
• GET/v1/webhook-eventsList events
• GET/v1/webhooksList webhooks of the organization
• GET/v1/org/permissionsGet permissions on the organization (who is an admin)
• POST/v1/webhooks/{webhook_id}/deliveries/{delivery_id}/redeliverRedeliver an event
• POST/v1/webhooks/{webhook_id}/redeliverRedeliver deliveries for a period
• DELETE/v1/groups/{group_id}/members/{user_id}Remove a member from a group
• POST/v1/webhooks/{webhook_id}/resumeResume a webhook
• DELETE/v1/cards/{card_id}/permissionsRevoke roles on a card
• DELETE/v1/collections/{name}/permissionsRevoke roles on a collection
• DELETE/v1/folders/{folder_id}/permissionsRevoke roles on a folder
• DELETE/v1/org/permissionsRevoke roles on the organization
• POST/v1/webhooks/{webhook_id}/revoke-previous-secretRevoke the previous secret
• DELETE/v1/sources/{source_id}/permissionsRevoke roles on a source
• DELETE/v1/sources/{source_id}/push-keys/{key_id}Revoke an API key of a custom source
• POST/v1/webhooks/{webhook_id}/rotate-secretRotate the signing secret
• PUT/v1/cards/{card_id}/verification/intervalChange the verification type and due date
• PUT/v1/cards/{card_id}/verification/verifiersSet the verifiers of a card
• GET/v1/sources/{source_id}/permissionsGet permissions on a source (direct and inherited)
• POST/v1/webhooks/{webhook_id}/testSend a test event
• POST/v1/cards/{card_id}/verification/unverifyRemove trust or remind the verifier
• PATCH/v1/roles/{role_id}Update a custom role
• PATCH/v1/drafts/{draft_id}Update a draft
• PATCH/v1/folders/{folder_id}Rename, move or reorder a folder
• PATCH/v1/quality/gaps/followups/{followup_id}Update a knowledge gap in progress
• PATCH/v1/groups/{group_id}Rename a group
• PATCH/v1/sources/{source_id}/settingsUpdate source settings
• PATCH/v1/webhooks/{webhook_id}Update a webhook
• POST/v1/cardsUpload a file as a card
• POST/v1/cards/archiveUpload an archive of documents
• PUT/v1/cards-by-external-id/{external_id}Create or replace a card by external ID
• POST/v1/cards/{card_id}/verification/verifyVerify a card

error.code is the code on this page; error.request_id matches the X-Request-Id header; error.doc_url links to this page.