# Update App Entitlements

## POST /v1/admin/app/entitlement/list

> Update the application entitlements for the company

```json
{"openapi":"3.1.1","info":{"title":"Pod API","version":"20.17.1"},"servers":[{"url":"http://yourpodURL.symphony.com/pod"}],"paths":{"/v1/admin/app/entitlement/list":{"post":{"summary":"Update the application entitlements for the company","parameters":[{"schema":{"type":"string"},"name":"sessionToken","description":"Session authentication token.","in":"header","required":true}],"tags":["AppEntitlement"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PodAppEntitlementList"}}}},"400":{"description":"Client error, see response body for further details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized: Invalid session token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden: Caller lacks necessary entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error, see response body for further details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PodAppEntitlementList"}}},"required":true}}}},"components":{"schemas":{"PodAppEntitlementList":{"type":"array","items":{"$ref":"#/components/schemas/PodAppEntitlement"}},"PodAppEntitlement":{"description":"Application Entitlements for the company","type":"object","required":["appId","appName","enable","listed","install"],"properties":{"appId":{"type":"string","description":"Unique ID for the Application","maxLength":256,"minLength":1},"appName":{"type":"string","description":"Name for this Application","maxLength":50,"minLength":1},"enable":{"type":"boolean"},"listed":{"type":"boolean","description":"if true, this application will be listed in the appstore for everyone.  Otherwise, this application will be hidden in the appstore."},"install":{"type":"boolean","description":"if true, the entitlement is set to automatic for the company.  Otherwise, it is set to manual."}}},"Error":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}}}}
```

> #### 🚧 Restricted Endpoint
>
> Only Administrators are entitled to call this endpoint.\
> See [Bot Permissions](https://docs.developers.symphony.com/building-bots-on-symphony/configuration/bot-permissions)) for a list of roles and associated privileges.
