Dateien · Ephemeral Docs

Laden Sie Dateien in Ihre Organisation hoch und verwalten Sie sie. member- und admin-Schlüssel können jeden Endpunkt auf dieser Seite nutzen. Wie Ausführungen sie einbinden, beschreibt Dateien.

Das Dateiobjekt

idstring

Datei-ID, etwa file_9c41d2a07be35f1e8a6c0d4b9e2f7a13.

namestring

Relativer Pfad, der als Name der Datei dient, etwa guides/refunds.md.

sizeinteger

Größe in Bytes.

content_typestring

Wird beim Hochladen aus dem Dateiinhalt ermittelt.

created_attimestamp

Wann sie hochgeladen wurde.

Eine Datei hochladen

POST/v1/files

Speichert eine Datei mit bis zu 1 MiB. Senden Sie sie als multipart/form-data.

Formularfelder

filefileerforderlich

Der Dateiinhalt.

namestring

Der Name, unter dem sie gespeichert wird. Standardmäßig der Name der hochgeladenen Datei. Muss ein relativer Pfad mit bis zu 240 Zeichen sein.

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

Die Antwort lautet 201 Created mit dem Dateiobjekt. Erneutes Hochladen unter einem vorhandenen Namen legt eine neue Datei mit neuer ID an; der ältere Upload bleibt erhalten.

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

Dateien auflisten

GET/v1/files

Liefert ein Array von Dateiobjekten mit dem neuesten Upload für jeden Namen, nach Name sortiert.

Eine Datei herunterladen

GET/v1/files/{id}

Liefert den Rohinhalt als Anhang mit dem gespeicherten Content-Type. Sie können statt einer ID einen Namen angeben, um den neuesten Upload mit diesem Namen zu erhalten.

Terminal

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

Eine Datei umbenennen

PATCH/v1/files/{id}

Ändert den Namen eines Uploads. Erwartet eine ID.

Body

namestringerforderlich

Der neue Name. Ein relativer Pfad mit bis zu 240 Zeichen.

Die Antwort lautet {"id": "...", "name": "..."}. Workflows, die die Datei über ihren alten Namen referenzieren, finden sie nicht mehr, während Verweise über die ID weiterhin funktionieren.

Eine Datei löschen

DELETE/v1/files/{id}

Löscht einen Upload samt Inhalt und liefert 204 No Content. Erwartet eine ID.

Ausführungen in der Warteschlange, die die Datei referenzieren, schlagen beim Start fehl, und spätere Ausführungen, die sie nennen, schlagen bei der Erstellung mit 400 fehl. Existiert ein älterer Upload mit demselben Namen, lösen Verweise über den Namen stattdessen zu diesem auf.