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

# List skills

> <Note>
  This endpoint is currently in development and may change.
</Note>

List skills accessible to the calling user. If the caller is an Organization Admin, the response will include all skills in the organization; otherwise, only skills the caller created are returned.




## OpenAPI

````yaml /api/openapi.yaml get /v1/skills
openapi: 3.1.0
info:
  title: Omni API
  description: >
    The Omni REST API provides programmatic access to your Omni instance for
    managing users, documents, queries, schedules, and more.  
  version: 1.0.0
  contact:
    name: Omni Support
    url: https://docs.omni.co
servers:
  - url: https://{instance}.omniapp.co/api
    description: Production
    variables:
      instance:
        default: blobsrus
        description: Your production Omni instance subdomain
  - url: https://{instance}.playground.exploreomni.dev/api
    description: Playground
    variables:
      instance:
        default: blobsrus
        description: Your playground Omni instance subdomain
security:
  - bearerAuth: []
  - orgApiKey: []
tags:
  - name: Who Am I
    description: Inspect your own user permissions
  - name: AI
    description: AI-powered query generation
  - name: AI Credit Controls
    description: Manage organization-level AI credit usage
  - name: AI Credit Usage
    description: Monitor AI credit usage
  - name: AI Evals
    description: >-
      Manage prompt sets and runs used to score AI quality against curated
      prompt suites.
  - name: AI Model Suggestions
    description: Manage AI-generated suggestions for shared models
  - name: AI Routines
    description: >-
      Manage Routines, which are scheduled, recurring AI-powered tasks that run
      automatically on your data
  - name: Apps
    description: Draft and publish app documents.
  - name: Documents v2
    description: >
      A draft-based workflow for creating and editing documents: create a
      document, patch a draft, then publish.
  - name: Documents
    description: Create, retrieve, and manage documents
  - name: API Tokens
    description: >-
      Manage API tokens (Organization keys, Personal Access Tokens, MCP OAuth
      grants)
  - name: Connections
    description: Manage database connections
  - name: Connection environments
    description: Manage connection environments database connections
  - name: Content
    description: Unified content retrieval (documents and folders)
  - name: Content migration
    description: Export and import dashboards
  - name: Content validator
    description: Validate content against models and perform find/replace operations
  - name: Dashboard downloads
    description: Download dashboards and tiles as PDF, PNG, XLSX, CSV, or JSON files
  - name: Dashboard filters and controls
    description: Read and update dashboard filter and control default values
  - name: dbt
    description: Manage dbt configuration for connections
  - name: Document favorites
    description: Favorite and unfavorite documents
  - name: Document labels
    description: Apply and manage labels on documents
  - name: Document permissions
    description: Manage document-level access
  - name: Labels
    description: |
      Manage labels in the organization
  - name: Folders
    description: Create and organize content folders
  - name: Folder labels
    description: Apply and manage labels on folders
  - name: Folder permissions
    description: Manage folder-level access
  - name: Jobs
    description: Check status of asynchronous jobs
  - name: Models
    description: Create and manage data models
  - name: Model branches
    description: Manage model branches and merge changes
  - name: Model git configuration
    description: Manage git configuration for shared models
  - name: Queries
    description: Execute workbook queries
  - name: Schedules
    description: Create and manage scheduled tasks
  - name: Schedule recipients
    description: Manage schedule recipients
  - name: Schema refresh schedules
    description: Manage automated schema refresh schedules for connections
  - name: Skills
    description: >-
      Manage skills, the saved slash-command instructions the Omni AI assistant
      runs
  - name: Topics
    description: Retrieve topic information from models
  - name: Uploads
    description: Manage file uploads
  - name: Users
    description: Manage users
  - name: User attributes
    description: Manage user attribute definitions
  - name: User groups
    description: Manage user groups
  - name: User model roles
    description: Manage model and connection role assignments for users
  - name: User group model roles
    description: Manage model and connection role assignments for user groups
  - name: Uploads
    description: Manage CSV and spreadsheet uploads
paths:
  /v1/skills:
    get:
      tags:
        - Skills
      summary: List skills
      description: >
        <Note>
          This endpoint is currently in development and may change.
        </Note>


        List skills accessible to the calling user. If the caller is an
        Organization Admin, the response will include all skills in the
        organization; otherwise, only skills the caller created are returned.
      operationId: skillsList
      parameters:
        - $ref: '#/components/parameters/cursor'
        - $ref: '#/components/parameters/pageSize'
        - $ref: '#/components/parameters/sortDirection'
        - name: sortField
          schema:
            type: string
            enum:
              - createdAt
              - name
              - updatedAt
            default: updatedAt
          required: false
          description: Field to sort results by
          in: query
        - name: userId
          schema:
            type: string
            format: uuid
          required: false
          description: |
            **Organization API key required.** Target user membership ID.
          in: query
        - name: creatorId
          schema:
            type: string
            format: uuid
          required: false
          description: >
            Filter by creator membership ID — `creator.id` from a listed skill,
            or your own `membershipId` from the [Who am I?
            endpoint](/api/who-am-i/get-current-identity-and-permissions).
            Applies within what the caller can already see.
          in: query
        - name: identifier
          schema:
            type: string
            minLength: 1
            maxLength: 48
            pattern: ^[a-z0-9][a-z0-9-]*$
            example: quarterly-report
          required: false
          description: Filter to skills holding this handle.
          in: query
      responses:
        '200':
          description: Paginated list of skills
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SkillsListResponse'
              example:
                pageInfo:
                  hasNextPage: false
                  nextCursor: null
                  pageSize: 20
                  totalRecords: 1
                records:
                  - id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                    identifier: quarterly-report
                    name: Quarterly report
                    description: Summarizes the quarter and flags anything off trend.
                    creator:
                      id: b2c3d4e5-f6a7-8901-bcde-f12345678901
                      name: Blob Ross
                    createdAt: '2026-01-15T10:00:00.000Z'
                    updatedAt: '2026-02-01T09:30:00.000Z'
        '400':
          description: Invalid query parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError400'
        '403':
          description: Invalid bearer token, or skills are not enabled for the caller
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError403'
        '404':
          description: |
            `creatorId` names no member of this organization
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError404'
      security:
        - bearerAuth: []
components:
  parameters:
    cursor:
      name: cursor
      schema:
        type: string
        example: eyJpZCI6IjEyMzQ1In0
      required: false
      description: |
        Cursor for pagination from previous response `nextCursor`.
      in: query
    pageSize:
      name: pageSize
      schema:
        type: integer
        minimum: 1
        maximum: 100
        default: 20
        example: 20
      required: false
      description: Number of results per page
      in: query
    sortDirection:
      name: sortDirection
      in: query
      required: false
      schema:
        type: string
        enum:
          - asc
          - desc
      description: |
        Direction for sorting results:

        - `asc` - Ascending order (A-Z, 0-9)
        - `desc` - Descending order (Z-A, 9-0)
  schemas:
    SkillsListResponse:
      type: object
      properties:
        pageInfo:
          $ref: '#/components/schemas/PageInfo'
        records:
          type: array
          items:
            type: object
            properties: null
            createdAt:
              type: string
              format: date-time
              description: ISO 8601 timestamp of when the skill was created
              example: '2026-01-15T10:00:00.000Z'
            creator:
              $ref: '#/components/schemas/SkillCreator'
            description:
              type: string
              description: >
                Describes what the skill is for. Shown in the skills list and
                given to the agent when it chooses between skills.
              example: Summarizes the quarter and flags anything off trend.
            id:
              type: string
              format: uuid
              description: Unique identifier for the skill
              example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
            identifier:
              type: string
              description: >
                Slash-command handle, stored without the slash. Lowercase
                letters, numbers and hyphens, starting with a letter or number;
                up to 48 characters.
              example: quarterly-report
            name:
              type: string
              description: Human-readable name for the skill
              example: Quarterly report
            updatedAt:
              type: string
              format: date-time
              description: ISO 8601 timestamp of the last edit
              example: '2026-02-01T09:30:00.000Z'
          required:
            - createdAt
            - creator
            - description
            - id
            - identifier
            - name
            - updatedAt
      required:
        - pageInfo
        - records
    ApiError400:
      type: object
      properties:
        detail:
          type: string
          description: Human-readable error message describing what went wrong.
        status:
          type: integer
          description: HTTP status code of the error.
          example: 400
      required:
        - detail
        - status
    ApiError403:
      type: object
      properties:
        detail:
          type: string
          description: Human-readable error message describing what went wrong.
        status:
          type: integer
          description: HTTP status code of the error.
          example: 403
      required:
        - detail
        - status
    ApiError404:
      type: object
      properties:
        detail:
          type: string
          description: Human-readable error message describing what went wrong.
        status:
          type: integer
          description: HTTP status code of the error.
          example: 404
      required:
        - detail
        - status
    PageInfo:
      type: object
      description: Pagination information for paginated responses.
      properties:
        hasNextPage:
          type: boolean
          description: Indicates if there are more records available.
        nextCursor:
          type: string
          nullable: true
          description: Cursor for the next page of results. `null` if no more results.
        pageSize:
          type: integer
          description: Number of records per page.
        totalRecords:
          type: integer
          description: Total number of records matching the query.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >
        Can be either an [Organization API
        Key](/api/authentication#organization-api-keys) or [Personal Access
        Token (PAT)](/api/authentication#token-types).


        Include in the `Authorization` header as: `Bearer YOUR_TOKEN`
    orgApiKey:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >
        Requires an [Organization API
        Key](/api/authentication#organization-api-keys). Personal Access Tokens
        (PATs) are not supported for this endpoint.


        Include in the `Authorization` header as: `Bearer ORGANIZATION_API_KEY`

````