Archivos · Documentación de Ephemeral

Sube archivos a tu organización y adminístralos. Las claves de miembro y de administrador pueden usar todos los endpoints de esta página. Consulta archivos para saber cómo los montan las ejecuciones.

El objeto de archivo

idstring

ID del archivo, como file_9c41d2a07be35f1e8a6c0d4b9e2f7a13.

namestring

Ruta relativa que se usa como nombre del archivo, como guides/refunds.md.

sizeinteger

Tamaño en bytes.

content_typestring

Detectado a partir del contenido del archivo cuando se subió.

created_attimestamp

Cuándo se subió.

Subir un archivo

POST/v1/files

Almacena un archivo de hasta 1 MiB. Envíalo como multipart/form-data.

Campos del formulario

filefileobligatorio

El contenido del archivo.

namestring

El nombre con el que se almacena. Por defecto, el nombre del archivo subido. Debe ser una ruta relativa de hasta 240 caracteres.

curl $EPHEMERAL_URL/v1/files \
  -H "Authorization: Bearer $EPHEMERAL_API_KEY" \
  -F [email protected] \
  -F name=guides/refunds.md

La respuesta es 201 Created con el objeto de archivo. Si subes de nuevo con un nombre existente, se añade un archivo nuevo con un ID nuevo; la subida anterior se conserva.

JSON

{
  "id": "file_9c41d2a07be35f1e8a6c0d4b9e2f7a13",
  "name": "guides/refunds.md",
  "size": 18234,
  "content_type": "text/plain; charset=utf-8",
  "created_at": "2026-10-03T08:02:17.553Z"
}

Listar archivos

GET/v1/files

Devuelve un array de objetos de archivo con la última subida de cada nombre, ordenados por nombre.

Descargar un archivo

GET/v1/files/{id}

Devuelve el contenido sin procesar como adjunto, con el tipo de contenido almacenado. Puedes pasar un nombre en lugar de un ID para obtener la última subida con ese nombre.

Terminal

curl $EPHEMERAL_URL/v1/files/file_9c41d2a07be35f1e8a6c0d4b9e2f7a13 \
  -H "Authorization: Bearer $EPHEMERAL_API_KEY" -o refunds.md

Renombrar un archivo

PATCH/v1/files/{id}

Cambia el nombre de una subida. Recibe un ID.

Cuerpo

namestringobligatorio

El nombre nuevo. Una ruta relativa de hasta 240 caracteres.

La respuesta es {"id": "...", "name": "..."}. Los flujos de trabajo que hacen referencia al archivo por su nombre anterior dejan de encontrarlo, mientras que las referencias por ID siguen funcionando.

Eliminar un archivo

DELETE/v1/files/{id}

Elimina una subida y su contenido y devuelve 204 No Content. Recibe un ID.

Las ejecuciones en cola que hacen referencia al archivo fallan al iniciarse, y las ejecuciones posteriores que lo nombren fallan al crearse con 400. Si existe una subida anterior con el mismo nombre, las referencias por nombre se resuelven a esa.