Get Corpus Permission By User

GET

/v2/api/corpus/{corpus_id}/permissions/user

Retrieves the specific access permissions assigned to a user for a given corpus. This endpoint is particularly useful for administrators who need to verify or manage individual user access rights within collaborative environments.

Purpose:

Enables visibility into what actions a specific user can perform on the specified corpus.

Functionality:

Requires the corpus_id as a path parameter and user_id as a query parameter.

Returns a list of permission strings such as view_corpus, change_corpus, or delete_corpus that are assigned to the user.

How to View Your Corpus ID?

To find your Corpus ID, visit the View Corpus ID Guide.

How to View Your User ID?

To find your User ID, visit the View User ID Guide.

Request

Path Params

Query Params

Header Params

Responses

🟢200OK

application/json

User permissions retrieved successfully.

Body

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request GET 'https:///v2/api/corpus/0/permissions/user?user_id' \
--header 'Ocp-Apim-Subscription-Key: ' \
--header 'Authorization: Bearer '

Response Example

[
    "view_corpus",
    "change_corpus",
    "delete_corpus"
]

Get Corpus Permissions

Annotate Corpus

Get Corpus Permission By User

How to View Your Corpus ID?#

How to View Your User ID?#

Request

Responses

How to View Your Corpus ID?

How to View Your User ID?