> For the complete documentation index, see [llms.txt](https://docs.360dialog.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.360dialog.com/docs/mba/api-ref/ui-skills/list-ui-skills.md).

# List UI skills

Retrieve all UI skills for the specified entity.

```json
{"openapi":"3.1.0","info":{"title":"Business Agent API","version":"1.50.0"},"tags":[{"name":"UI Skills","description":"Endpoints for managing the agent's UI skills - the rich message components it may send"}],"servers":[{"description":"Production server","url":"https://waba-v2.360dialog.io"}],"security":[{"D360-API-KEY":[]}],"components":{"securitySchemes":{"D360-API-KEY":{"description":"API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.","in":"header","name":"D360-API-KEY","type":"apiKey"}},"schemas":{"ui_skills.BizAIOmniChannelUISkillListResponse":{"description":"A paginated list of UI skills","properties":{"data":{"description":"The page of data returned","items":{"$ref":"#/components/schemas/ui_skills.BizAIOmniChannelUISkillResponse"},"type":"array","uniqueItems":false},"paging":{"$ref":"#/components/schemas/ui_skills.Paging","description":"Pagination metadata"}},"required":["data"],"type":"object"},"ui_skills.BizAIOmniChannelUISkillResponse":{"description":"A single UI skill","properties":{"component_type":{"description":"The type of rich message this UI skill sends","enum":["carousel_quick_reply","carousel_url","cta_url","flow","image","interactive_list","interactive_reply_buttons","location","location_request"],"type":"string"},"created_at":{"description":"The timestamp when the UI skill was created","type":"integer"},"flow_id":{"description":"The identifier of the associated flow. Only present for flow skills","type":"integer"},"id":{"description":"A unique identifier for the UI skill","type":"string"},"instruction":{"description":"A description telling the AI agent when to send this UI skill","type":"string"},"status":{"description":"Whether this UI skill is enabled and available to the AI agent","enum":["disabled","enabled"],"type":"string"},"title":{"description":"A human-readable name for the UI skill","type":"string"},"updated_at":{"description":"The timestamp when the UI skill was last updated","type":"integer"}},"required":["component_type","created_at","id","instruction","status","title","updated_at"],"type":"object"},"ui_skills.Paging":{"description":"Pagination metadata","properties":{"cursors":{"$ref":"#/components/schemas/ui_skills.Cursors","description":"Cursors to the next and previous pages"},"next":{"description":"The API that will return the next page of data. If not included, this is the last page of data. Due to how pagination works with visibility and privacy, a page may be empty but still carry a next link, so stop paging when the next link no longer appears","type":"string"},"previous":{"description":"The API that will return the previous page of data. If not included, this is the first page of data","type":"string"}},"required":["cursors"],"type":"object"},"ui_skills.Cursors":{"description":"Cursors to the next and previous pages","properties":{"after":{"description":"The cursor that points to the end of the page of data that has been returned","type":"string"},"before":{"description":"The cursor that points to the start of the page of data that has been returned","type":"string"}},"type":"object"},"ui_skills.StandardError":{"description":"Standard error response for Meta Business Agent endpoints","properties":{"detail":{"description":"Human-readable explanation of the error","type":"string"},"status":{"description":"HTTP status code","type":"integer"},"title":{"description":"Short, human-readable summary of the problem","type":"string"},"type":{"description":"A URI reference identifying the problem type","type":"string"}},"type":"object"}}},"paths":{"/agent-ui-skills":{"get":{"description":"Retrieve all UI skills for the specified entity.","operationId":"get-agent-ui-skills","parameters":[{"description":"Meta Business Agent API version","in":"header","name":"X-API-Version","schema":{"enum":["2.0.0"],"type":"string"}},{"description":"If specified, a page of data immediately before this cursor will be returned","in":"query","name":"before","schema":{"type":"string"}},{"description":"If specified, a page of data immediately after this cursor will be returned","in":"query","name":"after","schema":{"type":"string"}},{"description":"The maximum number of objects that may be returned. A query may return fewer than this due to filtering, so use the absence of a next link rather than a short page to detect the end of the list","in":"query","name":"limit","schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ui_skills.BizAIOmniChannelUISkillListResponse"}}},"description":"A paginated list of UI skills"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ui_skills.StandardError"}}},"description":"Bad request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ui_skills.StandardError"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ui_skills.StandardError"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ui_skills.StandardError"}}},"description":"Not found"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ui_skills.StandardError"}}},"description":"Too many requests"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ui_skills.StandardError"}}},"description":"Server error"}},"summary":"List UI skills","tags":["UI Skills"]}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.360dialog.com/docs/mba/api-ref/ui-skills/list-ui-skills.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.