> ## 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/{skillId}/update/preview

> What would change if an imported skill took its source's newest version?



## OpenAPI

````yaml /api/worksong.openapi.json post /api/skills/{skillId}/update/preview
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/{skillId}/update/preview:
    post:
      tags:
        - Skills
      summary: POST /api/skills/{skillId}/update/preview
      description: What would change if an imported skill took its source's newest version?
      operationId: post_api_skills_skillId_update_preview
      parameters:
        - name: skillId
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  skillId:
                    type: string
                    format: uuid
                  repo:
                    type: string
                  path:
                    type: string
                  currentSha:
                    type:
                      - string
                      - 'null'
                  sha:
                    type: string
                  upToDate:
                    type: boolean
                  name:
                    type: object
                    properties:
                      from:
                        type: string
                      to:
                        type: string
                    required:
                      - from
                      - to
                    additionalProperties: false
                  description:
                    type: object
                    properties:
                      from:
                        type: string
                      to:
                        type: string
                    required:
                      - from
                      - to
                    additionalProperties: false
                  skillMd:
                    type: object
                    properties:
                      added:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      removed:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      hunks:
                        type: array
                        items:
                          type: object
                          properties:
                            oldStart:
                              type: integer
                              exclusiveMinimum: 0
                              maximum: 9007199254740991
                            newStart:
                              type: integer
                              exclusiveMinimum: 0
                              maximum: 9007199254740991
                            lines:
                              type: array
                              items:
                                type: object
                                properties:
                                  kind:
                                    type: string
                                    enum:
                                      - same
                                      - add
                                      - remove
                                  text:
                                    type: string
                                required:
                                  - kind
                                  - text
                                additionalProperties: false
                          required:
                            - oldStart
                            - newStart
                            - lines
                          additionalProperties: false
                      truncated:
                        type: boolean
                    required:
                      - added
                      - removed
                      - hunks
                      - truncated
                    additionalProperties: false
                  files:
                    type: array
                    items:
                      type: object
                      properties:
                        path:
                          type: string
                        change:
                          type: string
                          enum:
                            - added
                            - changed
                            - removed
                        sizeBytes:
                          type: integer
                          minimum: 0
                          maximum: 9007199254740991
                        diff:
                          type: object
                          properties:
                            added:
                              type: integer
                              minimum: 0
                              maximum: 9007199254740991
                            removed:
                              type: integer
                              minimum: 0
                              maximum: 9007199254740991
                            hunks:
                              type: array
                              items:
                                type: object
                                properties:
                                  oldStart:
                                    type: integer
                                    exclusiveMinimum: 0
                                    maximum: 9007199254740991
                                  newStart:
                                    type: integer
                                    exclusiveMinimum: 0
                                    maximum: 9007199254740991
                                  lines:
                                    type: array
                                    items:
                                      type: object
                                      properties:
                                        kind:
                                          type: string
                                          enum:
                                            - same
                                            - add
                                            - remove
                                        text:
                                          type: string
                                      required:
                                        - kind
                                        - text
                                      additionalProperties: false
                                required:
                                  - oldStart
                                  - newStart
                                  - lines
                                additionalProperties: false
                            truncated:
                              type: boolean
                          required:
                            - added
                            - removed
                            - hunks
                            - truncated
                          additionalProperties: false
                      required:
                        - path
                        - change
                        - sizeBytes
                        - diff
                      additionalProperties: false
                  leftOutFiles:
                    type: integer
                    minimum: 0
                    maximum: 9007199254740991
                  problems:
                    type: array
                    items:
                      type: string
                  version:
                    type: string
                    minLength: 1
                    maxLength: 64
                required:
                  - skillId
                  - repo
                  - path
                  - currentSha
                  - sha
                  - upToDate
                  - name
                  - description
                  - skillMd
                  - files
                  - leftOutFiles
                  - problems
                  - version
                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.