---
title: "List your skills"
method: GET
path: "/skills"
tags: ["Skills"]
---

# List your skills

`GET /skills`

## Request

- Base URL: `https://app.flora.ai/api/v1`
- URL: `https://app.flora.ai/api/v1/skills`
- Auth: HTTP bearer

Returns the authenticated user's own skills. Metadata only — skill bodies are returned by the retrieve route.

## Query parameters

- `limit` integer: Maximum number of results to return
- `cursor` string: Opaque cursor for fetching the next page

## Response `200`

Skills returned.

- object
  - `skills` object[], required
    - `skill_id` string, required: Skill identifier
    - `slug` string, required: Skill URL slug
    - `name` string, required: Skill name
    - `description` string, required: Skill description
    - `thumbnail_video_url` string: Skill thumbnail video URL
    - `thumbnail_image_url` string: Skill thumbnail image URL
  - `meta` object, required
    - `next_cursor` string, nullable, required: Opaque cursor for fetching the next page
    - `total_estimate` integer, nullable: Estimated total matching items

## Other responses

- `400`: 400
- `401`: 401
- `402`: 402
- `403`: 403
- `404`: 404
- `409`: 409
- `429`: 429
- `500`: 500
- `503`: 503

## Changes

- **2026-10-28** `a8351619f225`: 9 warning
  - added the new `not_configured` enum value to the `error/code` response property for the response status `400`
  - added the new `not_configured` enum value to the `error/code` response property for the response status `401`
  - added the new `not_configured` enum value to the `error/code` response property for the response status `402`
  - added the new `not_configured` enum value to the `error/code` response property for the response status `403`
  - …5 more
- **2026-10-16** `e54130373b10`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/florafauna-ai/apis/flora-ai-api/changes/skills/get.md)

---

[API](https://skmtc.dev/florafauna-ai/apis/flora-ai-api.md) - [All operations](https://skmtc.dev/florafauna-ai/apis/flora-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/florafauna-ai/apis/flora-ai-api/revisions/87cfe2c4ac29?raw)