Add a published catalog skill to the caller's library by reference
Adds an existing public skill (resolved by owner/name) to the authenticated account's library. The route is the canonical home for catalog-reference adds; the older POST /api/v1/library shape will be rebound to multipart file-push in #1452.
Supports the optional Idempotency-Key request header. Retries with the same key + same request body return the cached response with Idempotent-Replayed: true. Retries with the same key + a different body return 422 idempotency_key_reused. Concurrent retries while the first is in-flight return 409 idempotency_key_in_progress. Cached responses live for 24h.
Error codes are carried in the code field of the error envelope so clients can distinguish between not_found, self_ownership, already_in_library, plan_limit, insufficient_scope, validation_error, idempotency_key_in_progress, and idempotency_key_reused.
Request
- Base URL: https://skillrepo.dev
- URL: https://skillrepo.dev/api/v1/library/refs
- Auth: HTTP bearer
Headers
Client-supplied idempotency key (max 255 chars). Retries with the same key + same request body return the cached response (with Idempotent-Replayed: true) instead of re-executing the handler. Retries with the same key + a different body return 422 idempotency_key_reused. Concurrent retries while the original is in-flight return 409 idempotency_key_in_progress. Cached responses live for 24 hours.
Request body
Response
Skill added to the library. On Idempotency-Key replays the same 201 is returned verbatim with the Idempotent-Replayed: true header set — the middleware preserves the original response status, so first-call and replay share a single status code, distinguished only by the response header.
Changes
No recorded changes to this operation across all 1 revision of this API.