Preview a GitHub skill source

POST 
/api/skills/sources/preview

experimental

Expect changes and instability. Introduced on July 23, 2026. Learn how experimental APIs work.

Inspect a GitHub URL without persisting a source or any discovered skills. Set stream to true to receive repository scan progress as server-sent events; otherwise the response contains the completed preview.

Request

Responses

200

Successful response.

400

Invalid request (malformed JSON, invalid parameter values, unknown fields).

401

Missing or invalid authentication token.

403

Token valid but lacks permission for the requested operation.

408

Backend did not respond within the timeout window.

413

Request body exceeds the maximum allowed size.

422

Returned when GitHub authorization is missing for the source URL. authentication_suggestions names the GitHub action pack to authorize; POST its server_id to the Client API's /tool-servers/{serverId}/auth with returnUrl in the request body to obtain an authorizationUrl to redirect the end user to, then retry the preview once OAuth completes.

429

Rate limit exceeded. Includes Retry-After header.

500

Unexpected server-side failure.

503

Backend temporarily unavailable.