Archivos

Textos y archivos guardados en la cuenta.

Guardar un archivo

POSThttps://api.drometra.com/v1/objects

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.
idempotency-keyobligatoriostring · uuid: Un UUID nuevo por operación. Si repites la petición con la misma clave, el cambio no se aplica dos veces.

Cuerpo

titleobligatoriostring
textobligatoriostring

Respuesta · 202

idstring · uuidsiempre
tenantIdstring · uuidsiempre
ownerIdstring · uuidsiempre
titlestringsiempre
stateenum: quarantined | ready | rejected | deletedsiempre
sha256stringsiempre
bytesintegersiempre
createdAtstring · date-timesiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X POST "https://api.drometra.com/v1/objects" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "idempotency-key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "…",
    "text": "…"
  }'

respuesta · 202

{
  "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "tenantId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "ownerId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "title": "…",
  "state": "quarantined",
  "sha256": "…",
  "bytes": 32768,
  "createdAt": "2026-10-21T14:02:31Z"
}

Listar archivos

GEThttps://api.drometra.com/v1/objects

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Parámetros de consulta

afterstring · uuid
limitinteger

Respuesta · 200

idstring · uuidsiempre
tenantIdstring · uuidsiempre
ownerIdstring · uuidsiempre
titlestringsiempre
stateenum: quarantined | ready | rejected | deletedsiempre
sha256stringsiempre
bytesintegersiempre
createdAtstring · date-timesiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X GET "https://api.drometra.com/v1/objects" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Accept: application/json"

respuesta · 200

[
  {
    "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
    "tenantId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
    "ownerId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
    "title": "…",
    "state": "quarantined",
    "sha256": "…",
    "bytes": 32768,
    "createdAt": "2026-10-21T14:02:31Z"
  }
]

Ver un archivo

GEThttps://api.drometra.com/v1/objects/{id}

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Parámetros de ruta

idobligatoriostring · uuid: ej. 0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d

Respuesta · 200

idstring · uuidsiempre
tenantIdstring · uuidsiempre
ownerIdstring · uuidsiempre
titlestringsiempre
stateenum: quarantined | ready | rejected | deletedsiempre
sha256stringsiempre
bytesintegersiempre
createdAtstring · date-timesiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X GET "https://api.drometra.com/v1/objects/0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Accept: application/json"

respuesta · 200

{
  "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "tenantId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "ownerId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "title": "…",
  "state": "quarantined",
  "sha256": "…",
  "bytes": 32768,
  "createdAt": "2026-10-21T14:02:31Z"
}

Borrar un archivo

DELETEhttps://api.drometra.com/v1/objects/{id}

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Parámetros de ruta

idobligatoriostring · uuid: ej. 0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X DELETE "https://api.drometra.com/v1/objects/0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Accept: application/json"

respuesta · 204

(sin cuerpo)

Descargar el contenido de un archivo

GEThttps://api.drometra.com/v1/objects/{id}/content

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Parámetros de ruta

idobligatoriostring · uuid: ej. 0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X GET "https://api.drometra.com/v1/objects/0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d/content" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Accept: application/json"

respuesta · 200

(text/plain)