Administración

Endpoints para gestión de proyectos y API keys. Requieren el Admin Token.

🔒 Todos estos endpoints requieren el header X-Admin-Token.

Proyectos

Listar proyectos

GET/api/v1/projects

bash

curl -s "$SOLUCORTEX_URL/api/v1/projects" \
  -H "X-Admin-Token: $SOLUCORTEX_ADMIN_TOKEN" \
  -H "Accept: application/json"

Crear proyecto

POST/api/v1/projects

bash

curl -s -X POST "$SOLUCORTEX_URL/api/v1/projects" \
  -H "X-Admin-Token: $SOLUCORTEX_ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "name": "Mi Proyecto",
    "code": "mi-proyecto",
    "description": "Descripción opcional del proyecto",
    "repository_url": "https://github.com/org/repo",
    "notion_url": "https://notion.so/workspace/Pagina-abc123"
  }'

Campos de proyecto

Campo	Requerido	Descripción
`name`	✅	Nombre legible
`code`	✅	Identificador único. Minúsculas, sin espacios.
`description`	—	Descripción del proyecto
`repository_url`	—	URL del repositorio (GitHub, GitLab, Gitea)
`git_token`	—	Token de acceso para repos privados
`notion_url`	—	URL de página Notion principal
`notion_token`	—	Token de integración Notion (`ntn_...`)
`extra_url`	—	URL adicional (docs, landing, etc.)

💡 Si se proveen repository_url o notion_url, SoluCortex importa automáticamente memorias en background al crear el proyecto.

Ver proyecto

GET/api/v1/projects/{id}

bash

curl -s "$SOLUCORTEX_URL/api/v1/projects/$PROJECT_ID" \
  -H "X-Admin-Token: $SOLUCORTEX_ADMIN_TOKEN" \
  -H "Accept: application/json"

API Keys

Generar API key

POST/api/v1/projects/{id}/api-keys

bash

curl -s -X POST "$SOLUCORTEX_URL/api/v1/projects/$PROJECT_ID/api-keys" \
  -H "X-Admin-Token: $SOLUCORTEX_ADMIN_TOKEN" \
  -H "Accept: application/json"

Respuesta incluye la key en texto plano (solo en este momento):

json

{
  "id": "uuid-de-la-key",
  "key": "scx_AbCdEf1234...",
  "created_at": "2026-05-21T00:00:00Z"
}

Revocar API key

DELETE/api/v1/projects/{id}/api-keys/{key_id}

bash

curl -s -X DELETE \
  "$SOLUCORTEX_URL/api/v1/projects/$PROJECT_ID/api-keys/$KEY_ID" \
  -H "X-Admin-Token: $SOLUCORTEX_ADMIN_TOKEN"