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

# Crear

> Crea una subcategoría.



## OpenAPI

````yaml /api/openapi.json post /categories/{categoryId}/subcategories
openapi: 3.1.0
info:
  title: Riqra API
  version: '1.0'
  contact:
    email: soporte@riqra.com
    url: https://www.riqra.com/
    name: Riqra Support
  description: >-
    Usando nuestra API puedes integrar tu ERP o tu sistema actual de
    administración con [Riqra](https://www.riqra.com/).
servers:
  - url: https://sandbox.api.riqra.com
    description: Sandbox
  - description: Producción
    url: https://api.riqra.com
security:
  - API Key: []
tags:
  - name: Almacenes
  - name: Banners
  - name: Categorías
  - name: Clientes
  - name: Clientes - Direcciones
  - name: Cobertura
  - name: Comercio
  - name: Cupones
  - name: Inventario
  - name: Líneas de Crédito
  - name: Lista de Precios
  - name: Lista de Precios - Precios
  - name: Marcas
  - name: Pedidos
  - name: Productos
  - name: Productos Sugeridos
  - name: Promociones
  - name: Stock
  - name: Subcategorías
  - name: Variantes
paths:
  /categories/{categoryId}/subcategories:
    parameters:
      - schema:
          type: integer
          format: int64
        name: categoryId
        in: path
        required: true
        description: ID de la categoría padre.
    post:
      tags:
        - Subcategorías
      summary: Crear
      description: Crea una subcategoría.
      operationId: post-categories-categoryId-subcategories
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SubcategoryRequestCreate'
      responses:
        '201':
          description: Created
          headers:
            Location:
              schema:
                type: string
              description: Ubicación del recurso creado.
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequest'
components:
  schemas:
    SubcategoryRequestCreate:
      title: SubcategoryRequestCreate
      type: object
      properties:
        name:
          $ref: '#/components/schemas/SubcategoryName'
        description:
          $ref: '#/components/schemas/SubcategoryDescription'
        seo:
          $ref: '#/components/schemas/SubcategorySeo'
        order:
          $ref: '#/components/schemas/SubcategoryOrder'
      required:
        - name
    BadRequest:
      title: BadRequest
      type: object
      x-examples: {}
      properties:
        errors:
          type: array
          items:
            type: object
            properties:
              message:
                type: string
              code:
                type:
                  - integer
                  - string
                deprecated: true
                description: Código referencial del error. No usar.
      description: ''
    SubcategoryName:
      title: SubcategoryName
      type: string
      description: Nombre de la subcategoría.
    SubcategoryDescription:
      title: SubcategoryDescription
      type: string
      description: Descripción de la subcategoría.
    SubcategorySeo:
      title: SubcategorySeo
      type: object
      description: Atributos para el SEO.
      properties:
        description:
          type: string
          description: La descripción de la subcategoría para el SEO.
    SubcategoryOrder:
      type: integer
      title: SubcategoryOrder
      format: int64
      default: 9999
      description: |-
        El orden de la categoría con respecto a las demás subcategorías.

        Ejemplo: `1` significa que será mostrado primero.
  securitySchemes:
    API Key:
      name: api-key
      type: apiKey
      in: header
      description: >-
        Todas las llamadas al API tienen que contener este header junto a la
        clave para poder autenticar y autorizar al cliente.

````