# List skills

Launch stage: Beta

`GET /api/2.1/unity-catalog/skills`

Lists skills in a Unity Catalog schema. Provide `parent` as
 `schemas/{catalog}.{schema}`. Results are paginated; pass the returned
 `next_page_token` to fetch subsequent pages.

 Requires `USE_CATALOG` on the parent catalog and `USE_SCHEMA` on the parent
 schema. Only skills the caller can access as owner or through `READ_VOLUME`,
 `READ_METADATA`, or `MANAGE` are returned.

API scopes: unity-catalog

## Query parameters

- `parent` (string, required)
  Name of the parent schema. Format: `schemas/{catalog}.{schema}`.
   Each `{...}` component is capped at 255 characters individually.
   
   Required: skill listing is schema-scoped, so `parent` must be set; an unset
   or empty `parent` is rejected with INVALID_PARAMETER_VALUE.
- `page_size` (int32, optional)
  Maximum number of skills to return. Defaults to 100 when unset or 0; the
   maximum is 100. Use `page_token` to retrieve additional pages.
  Constraints: `<= 100`
- `page_token` (string, optional)
  Opaque pagination token from a previous request.

## Returns

Returns a list of Skill objects.

## Response

```json
{
  "skills": [
    {
      "name": "string",
      "bundle_name": "string",
      "description": "string",
      "etag": "string",
      "create_time": "string",
      "update_time": "string",
      "finalize_time": "string",
      "created_by": "string",
      "updated_by": "string",
      "effective_owner": "string",
      "metastore_id": "string",
      "comment": "string"
    }
  ],
  "next_page_token": "string"
}
```