Arquivos · Documentação da Ephemeral

Envie arquivos para a sua organização e gerencie-os. Chaves de membro e de administrador podem usar todos os endpoints desta página. Veja os arquivos para saber como as execuções os montam.

O objeto de arquivo

idstring

ID do arquivo, como file_9c41d2a07be35f1e8a6c0d4b9e2f7a13.

namestring

Caminho relativo usado como nome do arquivo, como guides/refunds.md.

sizeinteger

Tamanho em bytes.

content_typestring

Detectado a partir do conteúdo do arquivo quando ele foi enviado.

created_attimestamp

Quando foi enviado.

Enviar um arquivo

POST/v1/files

Armazena um arquivo de até 1 MiB. Envie-o como multipart/form-data.

Campos do formulário

filefileobrigatório

O conteúdo do arquivo.

namestring

O nome com que armazená-lo. Assume por padrão o nome do arquivo enviado. Deve ser um caminho relativo de até 240 caracteres.

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

A resposta é 201 Created com o objeto de arquivo. Enviar de novo com um nome existente adiciona um novo arquivo com um novo ID; o envio anterior é mantido.

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 arquivos

GET/v1/files

Retorna um array de objetos de arquivo com o envio mais recente de cada nome, ordenados por nome.

Baixar um arquivo

GET/v1/files/{id}

Retorna o conteúdo bruto como anexo, com o tipo de conteúdo armazenado. Você pode passar um nome em vez de um ID para obter o envio mais recente com esse nome.

Terminal

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

Renomear um arquivo

PATCH/v1/files/{id}

Altera o nome de um envio. Recebe um ID.

Corpo

namestringobrigatório

O novo nome. Um caminho relativo de até 240 caracteres.

A resposta é {"id": "...", "name": "..."}. Os fluxos de trabalho que se referem ao arquivo pelo nome antigo deixam de encontrá-lo, enquanto as referências por ID continuam funcionando.

Excluir um arquivo

DELETE/v1/files/{id}

Exclui um envio e seu conteúdo e retorna 204 No Content. Recebe um ID.

As execuções na fila que referenciam o arquivo falham quando começam, e as execuções posteriores que o citam falham na criação com 400. Se existir um envio mais antigo com o mesmo nome, as referências por nome passam a resolver para ele.