List skills
Every saved skill this workspace owns: a named, reusable ask the agent runs as written.
Every saved skill this workspace owns: a named, reusable ask the agent runs as written.
Authorization
bearerAuth API key authentication. Use your API key as the bearer token: Authorization: Bearer roasos_sk_...
In: header
Query Parameters
Opaque composite pagination cursor from the previous response. Do not parse or construct it.
Number of items to return
1 <= value <= 10020Response 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 }}Approve an approval
Approve one approval card the run opened, and start the follow-up run that renders it. A run started from a skill or a workflow writes no thread, so there is no card in roasOS for you to press. This is the door that releases that work. It spends on this API key: an `Idempotency-Key` is required, the amount is bounded by the key's per-request ceiling and by its daily and monthly budgets, and `max_credits` / `generation_spend_cap_credits` bound the follow-up run the same way they bound the first one. The follow-up run's text is composed by roasOS from the approved card, never by the caller, and the run id comes back as `follow_up_run_id`. On a batch card, send `drop` with the `index` of each item in `pending_approvals[].items` that must not run. The dropped items do not run and cost nothing, and the per-request ceiling is checked against the kept items only. The list must leave at least one item; to refuse the whole card, decline it. This operation is deliberately absent from the MCP tool list. A connected model may decline; it must never approve its own spend.
Get a skill
Read one saved skill, including the prompt it runs.