Sync a GitHub-imported skill

Endpoint

POST 
/api/skills/:skill_id/sync

Release stage

Generally available

Authorization

Authorization: Bearer <token>OAuth access token or Glean-issued token · Authentication

Scopes

SKILLS

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

Skill sync completed successfully.

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.

404

Resource not found.

408

Backend did not respond within the timeout window.

409

Request conflicts with current state of the resource.

422

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.

429

Rate limit exceeded. Includes Retry-After header.

500

Unexpected server-side failure.

503

Backend temporarily unavailable.