# Create a new category

Creates a new category within an ontology. The new category will initially have no bound metadata queries. Use the metadata query binding endpoints to associate metadata queries with this category.

Endpoint: POST /accounts/{accountId}/ontologies/{ontologyId}/categories
Version: 1.0.0
Security: bearerAuth

## Path parameters:

  - `accountId` (string, required)
    Short account ID with scd- prefix
    Example: "scd-k2j8n4m1"

  - `ontologyId` (string, required)
    The ID of the ontology
    Example: "123e4567-e89b-12d3-a456-426614174001"

## Request fields (application/json):

  - `name` (string, required)
    Name of the category
    Example: "Research Papers"

  - `description` (string, required)
    Description of the category
    Example: "Academic research papers and publications"

  - `instructions` (string,null)
    Instructions for this category
    Example: "Please ensure all papers include proper citations"

## Response 201 fields (application/json):

  - `id` (string, required)
    Example: "cat-123abc45"

  - `name` (string, required)
    Example: "Research Papers"

  - `description` (string, required)
    Example: "Academic research papers and publications"

  - `instructions` (string,null, required)
    Example: "Please ensure all papers include proper citations"

  - `ontologyId` (string, required)
    Example: "123e4567-e89b-12d3-a456-426614174001"

  - `boundMetadataQueries` (array, required)
    Metadata keys bound to this category with their binding properties

  - `boundMetadataQueries.dataType` (string, required)
    Enum: "STRING", "SHORT_STRING", "NUMBER", "BOOLEAN", "DATE"

  - `boundMetadataQueries.createdAt` (string, required)
    Example: "2024-01-15T10:30:00Z"

  - `boundMetadataQueries.updatedAt` (string,null, required)
    Example: "2024-01-15T14:30:00Z"

  - `boundMetadataQueries.binding` (object, required)
    Binding properties for this metadata query in this category

  - `boundMetadataQueries.binding.required` (boolean, required)
    Whether this metadata query is required for this category
    Example: true

  - `boundMetadataQueries.binding.uniqueIndexElement` (boolean, required)
    Whether this metadata query is part of the unique index for this category


## Response 400 fields

## Response 401 fields

## Response 404 fields