> ## Documentation Index
> Fetch the complete documentation index at: https://docs.worksong.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# POST /api/skills/import

> Store the skills the owner picked, read again at the commit the preview showed.



## OpenAPI

````yaml /api/worksong.openapi.json post /api/skills/import
openapi: 3.1.0
info:
  title: Worksong API
  version: 042e65d5f227
  description: >-
    The HTTP API behind the Worksong apps, generated from the code at the commit
    below. Request and response shapes come from the shared zod contract; an
    operation marked `x-gaps` has a part the generator could not resolve.
  x-source: worksong-ai/worksong@042e65d5f2275493f60f879c7970dcfdeceb7e0e
servers:
  - url: https://app.worksong.ai
security:
  - bearerAuth: []
tags:
  - name: Approvals
  - name: Audit
  - name: Avatar generator
  - name: Bootstrap
  - name: Bot compute limit
  - name: Bot mcp servers
  - name: Bots
  - name: Calls
  - name: Connections
  - name: Contacts
  - name: Conversations
  - name: Coupons
  - name: Day grants
  - name: Desktop
  - name: Entity files
  - name: Files
  - name: Github
  - name: Insights
  - name: Login
  - name: Mcp servers
  - name: Me
  - name: Me bot messaging
  - name: Me chat header
  - name: Me daily limit
  - name: Me time zone
  - name: Memory
  - name: Message delete
  - name: Messages
  - name: Notifications
  - name: Optimize prompt
  - name: Phone
  - name: Places
  - name: Projects
  - name: Public file links
  - name: Push
  - name: Queue
  - name: Reactions
  - name: Register
  - name: Rooms
  - name: Routes
  - name: Routines
  - name: Runs
  - name: Skills
  - name: Tasks
  - name: Transcribe
  - name: Tts
  - name: Webhooks
  - name: Whats new
  - name: Whatsapp
  - name: Workspace files
paths:
  /api/skills/import:
    post:
      tags:
        - Skills
      summary: POST /api/skills/import
      description: >-
        Store the skills the owner picked, read again at the commit the preview
        showed.
      operationId: post_api_skills_import
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                repo:
                  type: string
                  minLength: 1
                  maxLength: 300
                path:
                  type: string
                  maxLength: 300
                sha:
                  type: string
                  pattern: ^[0-9a-f]{40}$
                keys:
                  minItems: 1
                  maxItems: 100
                  type: array
                  items:
                    type: string
                    minLength: 1
                    maxLength: 300
              required:
                - repo
                - sha
                - keys
              additionalProperties: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  sha:
                    type: string
                  added:
                    type: array
                    items:
                      type: object
                      properties:
                        key:
                          type: string
                        skill:
                          type: object
                          properties:
                            id:
                              type: string
                              format: uuid
                            name:
                              type: string
                              minLength: 1
                              maxLength: 64
                              pattern: ^[a-z0-9]+(-[a-z0-9]+)*$
                            description:
                              type: string
                            source:
                              type: string
                              enum:
                                - manual
                                - upload
                                - github
                            sourceRef:
                              type:
                                - string
                                - 'null'
                            sourceSha:
                              type:
                                - string
                                - 'null'
                            sizeBytes:
                              type: integer
                              minimum: 0
                              maximum: 9007199254740991
                            fileCount:
                              type: integer
                              minimum: 0
                              maximum: 9007199254740991
                            scriptCount:
                              default: 0
                              type: integer
                              minimum: 0
                              maximum: 9007199254740991
                            createdAt:
                              type: string
                              format: date-time
                            updatedAt:
                              type: string
                              format: date-time
                          required:
                            - id
                            - name
                            - description
                            - source
                            - sourceRef
                            - sourceSha
                            - sizeBytes
                            - fileCount
                            - scriptCount
                            - createdAt
                            - updatedAt
                          additionalProperties: false
                        leftOutFiles:
                          type: integer
                          minimum: 0
                          maximum: 9007199254740991
                      required:
                        - key
                        - skill
                        - leftOutFiles
                      additionalProperties: false
                  skipped:
                    type: array
                    items:
                      type: object
                      properties:
                        key:
                          type: string
                        name:
                          type:
                            - string
                            - 'null'
                        reason:
                          type: string
                          enum:
                            - name_taken
                            - name_reserved
                            - invalid
                            - skill_limit
                            - missing
                            - too_large
                        message:
                          type: string
                      required:
                        - key
                        - name
                        - reason
                        - message
                      additionalProperties: false
                required:
                  - sha
                  - added
                  - skipped
                additionalProperties: false
        4XX:
          description: Error. A problem object with a status and a message.
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.