# Permissions

## List available permissions and their descriptions

> Returns permission areas and scope descriptions.\
>             \
> \## Authorization\
> Requires \`tenant.access:read\` scope.

```json
{"openapi":"3.1.1","info":{"title":"Neostore internal API","version":"v1"},"tags":[{"name":"Permissions"}],"servers":[{"url":"https://app.neostore.cloud","description":"Production Server"},{"url":"https://app-qa.neostore.cloud","description":"Staging Server"}],"security":[{"admin-bearer":["ScopedAuthorizeRequirement"]},{"apiKey":["ScopedAuthorizeRequirement"]}],"components":{"securitySchemes":{"admin-bearer":{"type":"oauth2","flows":{"implicit":{"authorizationUrl":"https://auth.neostore.cloud/authorize?audience=https://app.neostore.cloud/api/","scopes":{}}}},"apiKey":{"type":"apiKey","name":"X-API-KEY","in":"header"}},"schemas":{"PermissionAreaWeb":{"required":["category","code","scopes"],"type":"object","properties":{"code":{"type":"string","description":"Area code grouping related scopes."},"category":{"type":"string","description":"Top-level category code used to group permission areas in the UI."},"description":{"type":["null","string"],"description":"Human-friendly description of the area."},"scopes":{"type":"array","items":{"description":"Web response for an available permission scope","$ref":"#/components/schemas/PermissionScopeWeb"},"description":"Scopes exposed by this permission area."}},"additionalProperties":false,"description":"Web response for a permission area (category of scopes)"},"PermissionScopeWeb":{"required":["code"],"type":"object","properties":{"code":{"type":"string","description":"Scope code used for access checks."},"description":{"type":["null","string"],"description":"Human-friendly description of the scope."}},"additionalProperties":false,"description":"Web response for an available permission scope"}}},"paths":{"/api/{tenantId}/admin/permissions":{"get":{"tags":["Permissions"],"summary":"List available permissions and their descriptions","description":"Returns permission areas and scope descriptions.\n            \n## Authorization\nRequires `tenant.access:read` scope.","parameters":[{"name":"tenantId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Permissions returned.","content":{"text/plain":{"schema":{"type":"array","items":{"description":"Web response for a permission area (category of scopes)","$ref":"#/components/schemas/PermissionAreaWeb"}}},"application/json":{"schema":{"type":"array","items":{"description":"Web response for a permission area (category of scopes)","$ref":"#/components/schemas/PermissionAreaWeb"}}},"text/json":{"schema":{"type":"array","items":{"description":"Web response for a permission area (category of scopes)","$ref":"#/components/schemas/PermissionAreaWeb"}}}}}}}}}}
```