List workspace skills

GET

/workspaces/{workspaceId}/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.workspaces.skills.list({
  workspaceId: '<workspaceId>',
})) {
  console.log(skill);
}

Returns the workspace’s skills that are accessible to the authenticated public API key. Metadata only — skill bodies are returned by the retrieve route.

Error responses use the standard error body.

Authorizations

• bearerAuth

Parameters

Path Parameters

workspaceId

required

Workspace identifier

string

/^ws_\S+$/

Workspace identifier

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

200

Skills returned.

Media type application/json

object

skills

required

Array<object>

object

skill_id

required

Skill identifier

string

/^skill_\S+$/

workspace_id

required

Workspace identifier

string

/^ws_\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:

string

Opaque cursor for fetching the next page

string

null

null

total_estimate

Any of:

integer

Estimated total matching items

integer

null

null

Example

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