Saltar al contenido principal
Todas las rutas están bajo la base URL (/api/v1) y requieren autenticación. Las lecturas son de miembro del workspace; las escrituras requieren el scope work:write por OAuth. Renombrar y borrar un area o un tag son actos de curación owner/admin.

​
Comments

Un comentario apunta a un topic, record, card o página y se resuelve en una edición. Ver Comments.
MétodoRutaPermPropósito
POST/workspaces/:slug/commentsmember (work:write)Agrega un comentario
GET/workspaces/:slug/commentsmemberLista comentarios (?target_kind, target_id, target_ref, status)
GET/workspaces/:slug/comments/:idmemberDetalle del comentario
PATCH/workspaces/:slug/comments/:idmember (work:write)Actualiza body o status
Cuerpo de creación (CreateCommentDto): target_kind (obligatorio, uno de topic, page, record, card), target_id (uuid) o target_ref (slug de topic), field_key, body (obligatorio, hasta 10000 caracteres), author_id. El status es open, resolved o wont_fix.

​
Areas

MétodoRutaPermPropósito
GET/workspaces/:slug/areasmemberLista areas
POST/workspaces/:slug/areasmember (work:write)Crea un area
PATCH/workspaces/:slug/areas/:idowner/adminRenombra o describe
DELETE/workspaces/:slug/areas/:idowner/adminElimina (deja sus topics sin archivar)
Cuerpo (CreateAreaDto / UpdateAreaDto): name (obligatorio, hasta 64 caracteres), description (hasta 500 caracteres).

​
Tags

MétodoRutaPermPropósito
GET/workspaces/:slug/tagsmemberLista el registro (?limit, offset)
POST/workspaces/:slug/tagsmember (work:write)Pre-crea un tag
PATCH/workspaces/:slug/tags/:namerename owner/adminRenombra o describe
DELETE/workspaces/:slug/tags/:nameowner/adminBorra y desvincula en todos lados
curl -X POST https://api.driftless.icu/api/v1/workspaces/acme/comments \
  -H "x-api-key: drift_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"target_kind":"topic","target_ref":"billing-flow","body":"Esta decisión quedó stale."}'

​
Errores

Un target_kind o status desconocido, o un body demasiado largo, devuelve 400 VALIDATION_FAILED. Un miembro que intenta un acto de curación owner/admin (renombrar o borrar area/tag) recibe 403 INSUFFICIENT_ROLE. Ver errores para el sobre.

​
Relacionado

  • Comments - el modelo de anotación.
  • Areas - cómo se archivan los topics.