Skip to content

Organization Skills

Organization Skills are published packages that Templates can reference. Keep the Organization API Key on your backend. End Users use the capabilities selected by their Template rather than managing the shared package through personal execution routes.

  1. Upload a ZIP package with POST /api/v1/org/skills/uploads. This stages validation and creates no published Version.
  2. Read GET /api/v1/org/skills/uploads/{uploadId} for validation results, staged status and expiry. Cancel an unpublished staged upload with DELETE on that path.
  3. Publish a validated upload with POST /api/v1/org/skills/uploads/{uploadId}/publish. Publication creates a Version available for Template reference.
Method and path Purpose
GET /api/v1/org/skills List available published shared Skills.
GET /api/v1/org/skills/{skillId} Read the Skill and published Version information.
GET /api/v1/org/skills/{skillId}/files List files in a selected published Version.
GET /api/v1/org/skills/{skillId}/file Read a file from that Version.
GET /api/v1/org/skills/{skillId}/package Download the complete published package.

Use the Template reference catalog to select available packages and save the Template that consumes them. Staged uploads and immutable publications are different resources; a successful upload does not establish publication.