Saltar al contenido
Empieza gratis

Guías

Primeros pasos

En esta página

Crea una clave

  1. En la app de SecretarIA, ve a Ajustes → API → Crear clave nueva.
  2. Ponle un nombre que te diga para qué es (por ejemplo, «Zapier») y marca solo los permisos que necesite.
  3. Copia la clave (sk_live_…) en ese momento.

Cuidado

La clave completa solo se muestra una vez. Después solo verás su prefijo (sk_live_a3f9…). Si la pierdes, revócala y crea otra.

Puedes revocar una clave cuando quieras desde la misma pantalla: deja de funcionar al instante. Puedes tener 2 claves activas en el plan gratuito y 10 en el plan Pro.

Primera llamada

Guarda la clave en una variable de entorno y comprueba que funciona:

bash
export SECRETARIA_API_KEY="sk_live_TU_CLAVE_AQUI"

curl -s https://system.secretar-ia.org/api/v1/me \
  -H "Authorization: Bearer $SECRETARIA_API_KEY"

Si todo va bien, recibes la identidad de la clave:

JSON
{
  "data": {
    "userId": "…",
    "keyId": "…",
    "name": "Zapier",
    "prefix": "sk_live_a3f9",
    "scopes": ["tasks:read", "tasks:write"]
  }
}

Si recibes un 401, revisa que la clave esté completa y que la cabecera empiece por Bearer .

Crea una tarea

Necesitas el permiso tasks:write:

bash
curl -s -X POST https://system.secretar-ia.org/api/v1/tasks \
  -H "Authorization: Bearer $SECRETARIA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: mi-script-2026-08-15-001" \
  -d '{"title": "Revisar informe mensual", "priority": "high"}'

La respuesta es la tarea completa, con todos sus campos:

JSON
{
  "data": {
    "id": "…",
    "title": "Revisar informe mensual",
    "status": "backlog",
    "priority": "high",
    "progress": 0,
    "notes": null,
    "projectId": null,
    "deadline": null,
    "deadlineStart": null,
    "deadlineType": null,
    "recurrence": null,
    "seriesId": null,
    "createdAt": 1765804800000,
    "updatedAt": 1765804800000,
    "completedAt": null,
    "createdBy": { "id": "k1m8x2c5v9b3n7q0w4e6r1t8y2u5i3o9", "name": "Ana" },
    "assignee": null
  }
}

La cabecera Idempotency-Key hace que reintentar sea seguro: lo tienes en Idempotencia.

Lista, completa y borra

Lista tus tareas pendientes (permiso tasks:read):

bash
curl -s "https://system.secretar-ia.org/api/v1/tasks?status=backlog&limit=20" \
  -H "Authorization: Bearer $SECRETARIA_API_KEY"

Márcala como hecha:

bash
curl -s -X PATCH https://system.secretar-ia.org/api/v1/tasks/TASK_ID \
  -H "Authorization: Bearer $SECRETARIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status": "done"}'

Bórrala. Responde 204, sin cuerpo:

bash
curl -s -X DELETE https://system.secretar-ia.org/api/v1/tasks/TASK_ID \
  -H "Authorization: Bearer $SECRETARIA_API_KEY" -o /dev/null -w "%{http_code}\n"

Si la tarea se repite, indica qué quieres borrar con scope. Sin él, la API responde 409 y no borra nada:

bash
curl -s -X DELETE "https://system.secretar-ia.org/api/v1/tasks/TASK_ID?scope=occurrence" \
  -H "Authorization: Bearer $SECRETARIA_API_KEY" -o /dev/null -w "%{http_code}\n"

Siguientes pasos

  • Todas las operaciones, con ejemplos en curl, Node y Python, en la referencia.
  • Los campos de una tarea, en el modelo de tarea.
Documentación