Import skills from GitHub
POST/api/skills/import
Expect changes and instability. Introduced on July 28, 2026. Learn how experimental APIs work.
Import one or more skills selected from a GitHub source preview. Each source URL is fetched and persisted as an independent skill with source provenance. This operation does not create a durable source resource. The import is atomic: if any source cannot be fetched, validated, or persisted, no skills are created.
Request
Responses
- 201
- 400
- 401
- 403
- 408
- 409
- 413
- 422
- 429
- 500
- 503
Skills imported successfully.
Invalid request (malformed JSON, invalid parameter values, unknown fields).
Missing or invalid authentication token.
Token valid but lacks permission for the requested operation.
Backend did not respond within the timeout window.
Request conflicts with current state of the resource.
Request body exceeds the maximum allowed size.
Returned when GitHub authorization is missing for a 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 import once OAuth completes.
Rate limit exceeded. Includes Retry-After header.
Unexpected server-side failure.
Backend temporarily unavailable.