Skip to main content
GET
List skill sets
Returns the active skill sets, builtin sets first and then by name. Each set crosses by its id (its setId) with its member skills: skillId, name and status. A member whose skill was deleted reads name: null and status: "missing". At most 500 sets and 1,000 distinct member skills are read. When either budget runs out, meta.partial is true, and a member past the skill budget reads status: "unresolved". Page with limit and cursor.

Authority

Requires skills:read at the platform scope, as listing tool sets requires tools:read. A credential granted skills:read only at an org unit is refused with 403. MCP clients reach this operation through forge_call_operation.

Authorizations

Authorization
string
header
required

An External App: the JWT it obtains from POST /oauth/token with OAuth2 client_credentials. Pass as Authorization: Bearer <jwt>. An app's static companion key also authenticates as the app, but is deprecated and is not protected by Idempotency-Key.

Query Parameters

limit
integer
default:50

Items per page, 1 to 100 (default 50); a larger value is a 400 too_big. A page may hold fewer items than limit while meta.hasMore is true; continue with meta.nextCursor.

Required range: 1 <= x <= 100
cursor
string

The previous page's meta.nextCursor; any other value is 400.

Minimum string length: 1

Response

Skill sets

data
object[]
required
meta
object
required

A list page's continuation. While hasMore is true, nextCursor is a string: pass it as cursor for the next page. hasMore: false ends the list; with truncated: true, more exist past what this list reads, and no cursor reaches them.