Skill Repositories

Operations of the Skill Registry API. Paths are relative to your deployment's API host.

GET /api/skill-registry-api/skill-repositories

List the git skill repositories registered by the caller org.

Authentication: bearer token (Authorization: Bearer <token>)

StatusDescriptionBody
200application/json SkillRepositoryResponseDtoDataArrayEnvelope
400application/problem+json ProblemDetailsDto
401application/problem+json ProblemDetailsDto
403application/problem+json ProblemDetailsDto
404application/problem+json ProblemDetailsDto
409application/problem+json ProblemDetailsDto
422application/problem+json ProblemDetailsDto
500application/problem+json ProblemDetailsDto

POST /api/skill-registry-api/skill-repositories

Register a git repository as a skill source.

Stores the repo; call POST /skill-repositories/:id/sync to ingest its SKILL.md bundles. A duplicate (org, url) returns 409.

Authentication: bearer token (Authorization: Bearer <token>)

Request body: application/json CreateSkillRepositoryDto

StatusDescriptionBody
201application/json SkillRepositoryResponseDtoDataEnvelope
400application/problem+json ProblemDetailsDto
401application/problem+json ProblemDetailsDto
403application/problem+json ProblemDetailsDto
404application/problem+json ProblemDetailsDto
409application/problem+json ProblemDetailsDto
422application/problem+json ProblemDetailsDto
500application/problem+json ProblemDetailsDto

GET /api/skill-registry-api/skill-repositories/{id}

Get a registered skill repository by id.

Authentication: bearer token (Authorization: Bearer <token>)

ParameterInTypeRequiredDescription
idpathstringyes
StatusDescriptionBody
200application/json SkillRepositoryResponseDtoDataEnvelope
400application/problem+json ProblemDetailsDto
401application/problem+json ProblemDetailsDto
403application/problem+json ProblemDetailsDto
404application/problem+json ProblemDetailsDto
409application/problem+json ProblemDetailsDto
422application/problem+json ProblemDetailsDto
500application/problem+json ProblemDetailsDto

DELETE /api/skill-registry-api/skill-repositories/{id}

Remove a skill repository.

Cascade-deletes every skill ingested from this repository.

Authentication: bearer token (Authorization: Bearer <token>)

ParameterInTypeRequiredDescription
idpathstringyes
StatusDescriptionBody
200application/json SkillRepositoryResponseDtoDataEnvelope
400application/problem+json ProblemDetailsDto
401application/problem+json ProblemDetailsDto
403application/problem+json ProblemDetailsDto
404application/problem+json ProblemDetailsDto
409application/problem+json ProblemDetailsDto
422application/problem+json ProblemDetailsDto
500application/problem+json ProblemDetailsDto

POST /api/skill-registry-api/skill-repositories/{id}/sync

Sync a skill repository.

Shallow-clones the repo, ingests every SKILL.md bundle as an org-scoped git-sourced skill, and prunes skills removed from the repo.

Authentication: bearer token (Authorization: Bearer <token>)

ParameterInTypeRequiredDescription
idpathstringyes
StatusDescriptionBody
200application/json SkillRepositorySyncResultDtoDataEnvelope
400application/problem+json ProblemDetailsDto
401application/problem+json ProblemDetailsDto
403application/problem+json ProblemDetailsDto
404application/problem+json ProblemDetailsDto
409application/problem+json ProblemDetailsDto
422application/problem+json ProblemDetailsDto
500application/problem+json ProblemDetailsDto