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

# Crear datastore

> Crear un nuevo datastore en tu organización.

## Endpoint

```
POST /api/datastores
```

## Headers

<ParamField header="Authorization" type="string" required>
  Bearer token con tu API key. Formato: `Bearer sk_live_xxx`
</ParamField>

<ParamField header="Content-Type" type="string" required>
  Siempre `application/json`
</ParamField>

## Request Body

<ParamField body="name" type="string">
  Nombre del datastore. Si no se proporciona, se genera automáticamente.
</ParamField>

<ParamField body="description" type="string">
  Descripción del datastore.
</ParamField>

<ParamField body="type" type="string" default="qdrant">
  Tipo de vector store. Actualmente solo `qdrant`.
</ParamField>

<ParamField body="isPublic" type="boolean" default="false">
  Si el datastore es público (no requiere auth para queries).
</ParamField>

<ParamField body="pluginName" type="string">
  Nombre corto para plugins (máx. 20 caracteres).
</ParamField>

<ParamField body="pluginDescriptionForHumans" type="string">
  Descripción legible para humanos.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://app.horneross.com/api/datastores \
    -H "Authorization: Bearer sk_live_xxx" \
    -H "Content-Type: application/json" \
    -d '{
      "name": "Base de conocimientos",
      "description": "Documentación de productos",
      "isPublic": false
    }'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://app.horneross.com/api/datastores',
    {
      method: 'POST',
      headers: {
        'Authorization': 'Bearer sk_live_xxx',
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        name: 'Base de conocimientos',
        description: 'Documentación de productos',
        isPublic: false,
      }),
    }
  );

  const datastore = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      'https://app.horneross.com/api/datastores',
      headers={
          'Authorization': 'Bearer sk_live_xxx',
          'Content-Type': 'application/json',
      },
      json={
          'name': 'Base de conocimientos',
          'description': 'Documentación de productos',
          'isPublic': False
      }
  )

  datastore = response.json()
  ```
</RequestExample>

## Response

<ResponseField name="id" type="string" required>
  ID del datastore creado
</ResponseField>

<ResponseField name="name" type="string" required>
  Nombre del datastore
</ResponseField>

<ResponseField name="visibility" type="string">
  Visibilidad del datastore
</ResponseField>

<ResponseExample>
  ```json 200 - Success theme={null}
  {
    "id": "ds_new123",
    "name": "Base de conocimientos",
    "description": "Documentación de productos",
    "type": "qdrant",
    "visibility": "private",
    "createdAt": "2024-01-21T16:00:00Z"
  }
  ```

  ```json 402 - Payment Required theme={null}
  {
    "error": "Has alcanzado el límite de 3 fuentes de datos para tu plan actual. Actualiza tu plan para crear más."
  }
  ```
</ResponseExample>