Share via

Permissions - List

Service:
Azure AI Services
API Version:
2.0

Gets the list of user emails that have permissions to access your application.

GET {Endpoint}/luis/api/v2.0/apps/{appId}/permissions

URI Parameters

Name In Required Type Description
appId
 path True

string (uuid)

The application ID.
Endpoint
 path True

string

Supported Cognitive Services endpoints (protocol and hostname, for example: https://westus.api.cognitive.microsoft.com).

Request Header

Name Required Type Description
Ocp-Apim-Subscription-Key True

string

Responses

Name Type Description
200 OK

UserAccessList

The list includes a single owner. All collaborators are listed in the emails array.
Other Status Codes

ErrorResponse

Error Response.

Security

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Examples

Successful Get Application User Access List

Sample request

GET {Endpoint}/luis/api/v2.0/apps/363187f1-c573-46b3-bc4c-ae01d686e68e/permissions

Sample response

Status code:
200 
{
  "owner": "owner@email.com",
  "emails": [
    "yourname@outlook.com"
  ]
}

Definitions

Name Description
ErrorResponse

Error response when invoking an operation on the API.
UserAccessList

List of user permissions.

ErrorResponse

Object

Error response when invoking an operation on the API.

Name Type Description
errorType

string

UserAccessList

Object

List of user permissions.

Name Type Description
emails

string[]

owner

string

The email address of owner of the application.