Sync a GitHub-imported skill
POST/api/skills/:skill_id/sync
Expect changes and instability. Introduced on August 3, 2026. Learn how experimental APIs work.
Refresh one GitHub-imported skill from its stored source URL. If the skill content has changed, this operation creates a new skill version. If the skill is no longer present upstream, the stored skill is left unchanged and must be deleted explicitly.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 408
- 409
- 422
- 429
- 500
- 503
Skill sync completed successfully.
Invalid request (malformed JSON, invalid parameter values, unknown fields).
Missing or invalid authentication token.
Token valid but lacks permission for the requested operation.
Resource not found.
Backend did not respond within the timeout window.
Request conflicts with current state of the resource.
Returned when GitHub authorization is missing for the stored 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 sync once OAuth completes.
Rate limit exceeded. Includes Retry-After header.
Unexpected server-side failure.
Backend temporarily unavailable.