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

# List Taxonomy Skills

> List the Ropes skill taxonomy: the canonical skills that problem scoring categories map to (`taxonomySkills` on problems and results). Includes global skills and your organization’s own. IDs are stable across renames; when two skills merge, the removed ID is listed in the surviving skill’s `mergedIds`.

**Required scope:** `problems:read`



## OpenAPI

````yaml https://api.ropes.ai/api/docs/openapi.json get /api/public/skills/taxonomy
openapi: 3.0.0
info:
  title: Ropes Public API
  version: 1.0.0
  description: >-
    Public API for Ropes. Authenticate using your API key in the x-api-key
    header.
servers:
  - url: https://api.ropes.ai
    description: Production server
  - url: http://localhost:3001
    description: Local development server
security: []
paths:
  /api/public/skills/taxonomy:
    get:
      tags:
        - Problems
      summary: List Taxonomy Skills
      description: >-
        List the Ropes skill taxonomy: the canonical skills that problem scoring
        categories map to (`taxonomySkills` on problems and results). Includes
        global skills and your organization’s own. IDs are stable across
        renames; when two skills merge, the removed ID is listed in the
        surviving skill’s `mergedIds`.


        **Required scope:** `problems:read`
      responses:
        '200':
          description: Successfully retrieved the skill taxonomy
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaxonomyResponse'
        '401':
          description: Unauthorized - Invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemErrorResponse'
        '403':
          description: Forbidden - API key is missing the required scope
        '429':
          description: >-
            Rate limit exceeded - contact support@ropes.ai for further
            assistance.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemErrorResponse'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemErrorResponse'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    TaxonomyResponse:
      type: object
      properties:
        skills:
          type: array
          items:
            $ref: '#/components/schemas/TaxonomyEntry'
          description: Every taxonomy skill visible to you, by name
      required:
        - skills
    ProblemErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Error message
      required:
        - error
    TaxonomyEntry:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Stable ID of the taxonomy skill
        name:
          type: string
          description: Current display name
        description:
          type: string
          nullable: true
          description: What the skill covers, when written
        scope:
          type: string
          enum:
            - global
            - organization
          description: >-
            global: shared by every organization. organization: specific to
            yours.
        mergedIds:
          type: array
          items:
            type: string
            format: uuid
          description: >-
            IDs of skills merged into this one. If you stored one of these, use
            this skill’s id instead.
      required:
        - id
        - name
        - description
        - scope
        - mergedIds
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Each key carries scopes chosen when it is created: `candidates:read`,
        `candidates:write`, `assessments:read`, `assessments:write`,
        `problems:read`, `problems:write`, `results:read`, `id_checks:read`,
        `id_checks:write`. Keys created before scopes existed have full access.
        A request with a key that lacks an operation's scope returns 403 naming
        the missing scope.

````

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