> ## Documentation Index > Fetch the complete documentation index at: https://docs.flowra.dev/llms.txt > Use this file to discover all available pages before exploring further. # Sync a registry skill from GitHub > Re-fetches the shared catalog copy from GitHub. No-op when the folder hash already matches. Attached agents pick up the new playbook on the next run. ## OpenAPI ````yaml /api-reference/openapi.json post /api/v1/skills/registry/sync/{id} openapi: 3.0.0 info: title: Flowra API (API Key Endpoints) description: >- **Flowra** is an AI-powered platform for building agents, workflows, and integrations. ### Capabilities - **Tools & Toolkits** – Define and group tools for agents and workflows. - **Workflows** – Orchestrate steps and automate processes. - **Triggers** – Schedule or event-based execution. - **Auth & Connections** – OAuth, API keys, and connected accounts. - **MCP** – Model Context Protocol server integration. - **Knowledge / RAG** – Add files and URLs for retrieval-augmented generation. ### Authentication Use the **x-api-key** header with a project API key to access endpoints that support API Key auth. Create and manage API keys in the dashboard under your project settings. Only endpoints that support API Key authentication via the @ApiKeyEnabled() decorator. Send x-api-key (required). On multi-tenant endpoints, optionally send x-username to act as an external user. version: '1.0' contact: name: Flowra url: https://flowra.dev servers: - url: https://flowra.dev description: Flowra API security: [] tags: - name: Users description: User profile - name: External Users description: End-user identities inside a project (x-username) - name: Auth Configs description: OAuth and API key configs for toolkits - name: Connected Accounts description: OAuth connected accounts and link creation - name: Toolkits description: List and search toolkits - name: Tools description: List, execute, and manage tools - name: Skills description: Browse, create, import, and install skills - name: Workflow & Agent description: Create, run, and inspect workflows and agents - name: Triggers description: Schedule and event-based trigger instances - name: Chat description: Threads and streaming agent runs - name: File description: Upload, list, and download files - name: Knowledge description: RAG knowledge collections - name: Table description: Collections and documents - name: Sandbox description: Ephemeral and durable code sandboxes - name: Browser description: Live browser sessions and view - name: LLM description: List AI models and generate completions - name: MCP description: MCP server management - name: usage description: Credit balance and usage ledger for the project API key paths: /api/v1/skills/registry/sync/{id}: post: tags: - Skills summary: Sync a registry skill from GitHub description: >- Re-fetches the shared catalog copy from GitHub. No-op when the folder hash already matches. Attached agents pick up the new playbook on the next run. operationId: SkillsController_registrySync parameters: - name: id required: true in: path description: Skill ID schema: example: 3fa85f64-5717-4562-b3fc-2c963f66afa6 type: string responses: '200': description: Operation completed successfully content: application/json: schema: $ref: '#/components/schemas/SkillResponseDtoSuccessResponse' example: success: true message: Operation completed successfully data: id: '' slug: '' name: '' description: '' instructions: '' category: '' tags: - '' source: custom registryMeta: {} presets: {} isPublic: true version: '' activeStatus: true files: - path: '' sizeBytes: 0 contentType: '' packageFileCount: 0 sourceUrl: '' skillsShUrl: '' isCreator: true installCount: 0 changed: true security: - x-api-key: [] components: schemas: SkillResponseDtoSuccessResponse: type: object properties: success: type: boolean description: Success status example: true message: type: string description: Success message example: Operation completed successfully data: type: object properties: id: type: string slug: type: string name: type: string description: type: string instructions: type: string category: type: string nullable: true tags: nullable: true type: array items: type: string source: type: string enum: - custom - registry - platform registryMeta: type: object nullable: true presets: type: object nullable: true isPublic: type: boolean version: type: string activeStatus: type: boolean files: type: array items: type: object properties: path: type: string description: Path relative to skill root, e.g. scripts/run.py sizeBytes: type: number contentType: type: string required: - path - sizeBytes - contentType packageFileCount: type: number description: >- Companion package file count (excludes SKILL.md, which lives on the skill row). sourceUrl: type: string skillsShUrl: type: string isCreator: type: boolean description: True when the current user authored this skill. installCount: type: number description: Total memberships (installs) across all users. changed: type: boolean description: True when a registry sync overwrote the shared catalog copy. required: - id - slug - name - description - instructions - source - isPublic - version example: id: '' slug: '' name: '' description: '' instructions: '' category: '' tags: - '' source: custom registryMeta: {} presets: {} isPublic: true version: '' activeStatus: true files: - path: '' sizeBytes: 0 contentType: '' packageFileCount: 0 sourceUrl: '' skillsShUrl: '' isCreator: true installCount: 0 changed: true required: - success - message - data securitySchemes: x-api-key: type: apiKey in: header name: x-api-key description: >- Project API key. Create and manage keys in the dashboard under Project → API Keys. Send as header: x-api-key: ````