roasOS
API referenceSkills

List skills

Every saved skill this workspace owns: a named, reusable ask the agent runs as written.

GET
/v1/skills

Every saved skill this workspace owns: a named, reusable ask the agent runs as written.

Authorization

bearerAuth
AuthorizationBearer <token>

API key authentication. Use your API key as the bearer token: Authorization: Bearer roasos_sk_...

In: header

Query Parameters

cursor?string

Opaque composite pagination cursor from the previous response. Do not parse or construct it.

limit?integer

Number of items to return

Range1 <= value <= 100
Default20

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/skills"
{  "data": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "slug": "string",      "name": "string",      "description": "string",      "prompt": "string",      "use_count": 0,      "pack_version": 1,      "created_at": "2019-08-24T14:15:22Z",      "updated_at": "2019-08-24T14:15:22Z",      "kind": "guide",      "requires": {        "tools": [          "string"        ],        "host_features": [          "string"        ]      }    }  ],  "meta": {    "cursor": "string",    "has_more": true  }}