In this article
Get Access Control List
URL
https://{{HOST}}/subscriptiontopic/{{topic_id}}/permissions/
Method
GET
Required IMS Scopes
- subscription_write
- apollo_write
URL Path Parameters
| Name | Description | Example | Type |
|---|---|---|---|
| id required |
Topic ID to retreive | GUID | string |
Request Header Parameters
| Type | Value | Description |
|---|---|---|
| Authorization required |
Bearer {access_token} | IMS access token |
| Content-Type required |
application/json | Content Type |
Example
curl -X GET
'https://{{HOST}}/subscriptiontopic/SOMETOPICID/permissions'
-H 'Authorization: Bearer {access_token}'
Response
{
"objectId": "TestTopicId",
"accesscontrolitems": {
"sub:user:bob": "owner",
"org:jci.com": "readwrite"
}
}
``
## Errors
|Error|Description|
|---|---|
|401| Unauthorized |
|403| Forbiden. Possible causes: <br> * You do not have access to this endpoint (scope) <br> * You do not have access to this topic |
|404| Topic not found for id given |
## Response Body Parameters
|Name|Description|Schema|
|---|---|---|
| id| Id of the topic object |string|
| accesscontrolitems | Current list of access permissions for topic |object definition|