Fichiers · Documentation Ephemeral

Importez des fichiers dans votre organisation et gérez-les. Les clés member et admin peuvent utiliser tous les endpoints de cette page. Voir fichiers pour la façon dont les exécutions les montent.

L'objet fichier

idstring

ID du fichier, par exemple file_9c41d2a07be35f1e8a6c0d4b9e2f7a13.

namestring

Chemin relatif utilisé comme nom du fichier, par exemple guides/refunds.md.

sizeinteger

Taille en octets.

content_typestring

Détecté à partir du contenu du fichier lors de l'import.

created_attimestamp

Date de l'import.

Importer un fichier

POST/v1/files

Stocke un fichier de 1 Mio au maximum. Envoyez-le en multipart/form-data.

Champs du formulaire

filefileobligatoire

Le contenu du fichier.

namestring

Le nom sous lequel le stocker. Par défaut, le nom du fichier importé. Doit être un chemin relatif de 240 caractères au maximum.

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

La réponse est 201 Created avec l'objet fichier. Importer de nouveau sous un nom existant ajoute un nouveau fichier avec un nouvel ID ; l'import précédent est conservé.

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"
}

Lister les fichiers

GET/v1/files

Renvoie un tableau d'objets fichier avec l'import le plus récent pour chaque nom, triés par nom.

Télécharger un fichier

GET/v1/files/{id}

Renvoie le contenu brut en pièce jointe, avec le type de contenu stocké. Vous pouvez passer un nom au lieu d'un ID pour obtenir l'import le plus récent portant ce nom.

Terminal

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

Renommer un fichier

PATCH/v1/files/{id}

Change le nom d'un import. Prend un ID.

Corps

namestringobligatoire

Le nouveau nom. Un chemin relatif de 240 caractères au maximum.

La réponse est {"id": "...", "name": "..."}. Les workflows qui désignent le fichier par son ancien nom ne le trouvent plus, tandis que les références par ID continuent de fonctionner.

Supprimer un fichier

DELETE/v1/files/{id}

Supprime un import et son contenu et renvoie 204 No Content. Prend un ID.

Les exécutions en file d'attente qui référencent le fichier échouent à leur démarrage, et les exécutions ultérieures qui le nomment échouent à la création avec 400. S'il existe un import plus ancien portant le même nom, les références par nom pointent alors vers celui-ci.