Skip to content
FLORA FLORA API

List your skills

GET
/skills
 
import { FloraClient } from '@flora-ai/flora';


const client = new FloraClient({ apiKey: process.env['FLORA_API_KEY'] });


// Paginated lists are async iterables; further pages are fetched as needed.
for await (const skill of await client.skills.list()) {
  console.log(skill);
}

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

Error responses use the standard error body.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
limit

Maximum number of results to return

integer
>= 1 <= 100

Maximum number of results to return

cursor

Opaque cursor for fetching the next page

string

Opaque cursor for fetching the next page

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Skills returned.

Media type application/json
object
skills
required
Array<object>
object
skill_id
required

Skill identifier

string
/^skill_\S+$/
slug
required

Skill URL slug

string
name
required

Skill name

string
description
required

Skill description

string
thumbnail_video_url

Skill thumbnail video URL

string
thumbnail_image_url

Skill thumbnail image URL

string
meta
required
object
next_cursor
required
Any of:

Opaque cursor for fetching the next page

string
total_estimate
Any of:

Estimated total matching items

integer
Example 
{
  "skills": [
    {
      "skill_id": "skill_abc123",
      "slug": "brand-voice",
      "name": "Brand Voice",
      "description": "Writes in our brand voice."
    }
  ],
  "meta": {
    "next_cursor": "eyJvZmZzZXQiOjIwfQ"
  }
}