Listar proyectos

GET/projects

Requiere el scope projects:read.

Incluye proyectos propios y compartidos como miembro activo, ordenados por nombre. Sin paginación a propósito (la colección por usuario es pequeña): la respuesta no lleva nextCursor.

Parámetros de query

statusProjectStatus: Filtra por estado del proyecto.
Valores: activearchived

Respuestas

200

Todos los proyectos accesibles.

dataarray<Project>obligatorio

Campos de Project

idstringobligatorio
namestringobligatorio
descriptionstring | nullobligatorio
colorstring | nullobligatorio
iconstring | nullobligatorio
tipoProjectTipo | nullobligatorio: Valores: trabajoociopersonal
statusProjectStatusobligatorio: Valores: activearchived
sharedbooleanobligatorio: Tiene al menos un miembro activo además del propietario/a.
rolestringobligatorio: Rol de la persona dueña de la key en el proyecto.
Valores: ownermember
createdAtnumberobligatorio
updatedAtnumberobligatorio

401

Key ausente, malformada, inexistente, revocada, expirada o API deshabilitada (invalid_api_key, indistinguibles a propósito).

Códigos: invalid_api_key

403

Scope insuficiente (insufficient_scope), recurso sin acceso (forbidden) o sincronización de calendario de una tarea que creó otra persona (calendar_creator_only).

Códigos: insufficient_scopeforbiddencalendar_creator_only

422

Entrada inválida (invalid_json, unknown_field, missing_field, invalid_field, invalid_query_param, empty_patch, body_too_large — cuerpos de más de 64 KB —, invalid_idempotency_key, validation_error, y al asignar assignee_not_member, task_not_shared, task_private).

Códigos: invalid_jsonunknown_fieldmissing_fieldinvalid_fieldinvalid_query_paramempty_patchbody_too_largeinvalid_idempotency_keyvalidation_errorassignee_not_membertask_not_sharedtask_private

429

Límite superado (rate_limited) — 60 req/min (ráfagas de 20) y 5.000 req/día por key. Reintentar tras Retry-After.

Códigos: rate_limited

Cabecera Retry-After: Segundos (enteros) a esperar antes de reintentar.

500

Error interno (internal_error). Cuerpo opaco a propósito; reintentar con backoff.

Códigos: internal_error

bash

curl 'https://system.secretar-ia.org/api/v1/projects?status=active' \
  -H "Authorization: Bearer $SECRETARIA_API_KEY"

Proyectos accesibles

JSON

{
  "data": [
    {
      "id": "kh72p9d3w1v8m4x6c0b5n2q7r9s3t1a8",
      "name": "Mudanza",
      "description": "Todo lo de la casa nueva.",
      "color": "verde",
      "icon": "casa",
      "tipo": "personal",
      "status": "active",
      "shared": true,
      "role": "owner",
      "createdAt": 1765200000000,
      "updatedAt": 1765804800000
    },
    {
      "id": "q8w2e6r0t4y8u2i6o0p4a8s2d6f0g4h8",
      "name": "Equipo de ventas",
      "description": null,
      "color": null,
      "icon": null,
      "tipo": "trabajo",
      "status": "active",
      "shared": true,
      "role": "member",
      "createdAt": 1764000000000,
      "updatedAt": 1765300000000
    }
  ]
}