GET /files/{file_id}

Includes the gated dashboard URL and a short-lived presigned `download_url`. To fetch the bytes locally, call this and then GET download_url immediately — the JSON API never carries the file. The CLI's `agent file get` wraps exactly that two-step.

curl "https://api.ellipsis.dev/v1/files/{file_id}" \
  -H "Authorization: Bearer $ELLIPSIS_API_KEY"

{
  "download_url": "string",
  "file": {
    "content_type": "string",
    "created_at": "2026-01-01T00:00:00Z",
    "filename": "string",
    "id": "string",
    "session_id": "string",
    "size_bytes": 0
  },
  "url": "string"
}

import os

from ellipsis import Ellipsis

client = Ellipsis(api_key=os.environ["ELLIPSIS_API_TOKEN"])

result = client.files.get("...")
print(result)

{
  "download_url": "string",
  "file": {
    "content_type": "string",
    "created_at": "2026-01-01T00:00:00Z",
    "filename": "string",
    "id": "string",
    "session_id": "string",
    "size_bytes": 0
  },
  "url": "string"
}

import { Ellipsis } from '@ellipsis-dev/sdk';

const client = new Ellipsis({
  apiKey: process.env.ELLIPSIS_API_TOKEN!,
});

const result = await client.files.get('...');
console.log(result);

{
  "download_url": "string",
  "file": {
    "content_type": "string",
    "created_at": "2026-01-01T00:00:00Z",
    "filename": "string",
    "id": "string",
    "session_id": "string",
    "size_bytes": 0
  },
  "url": "string"
}

No request body.

{
  "properties": {
    "download_url": {
      "type": "string"
    },
    "file": {
      "properties": {
        "content_type": {
          "type": "string"
        },
        "created_at": {
          "format": "date-time",
          "type": "string"
        },
        "filename": {
          "type": "string"
        },
        "id": {
          "type": "string"
        },
        "session_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "size_bytes": {
          "type": "integer"
        }
      },
      "required": [
        "id",
        "filename",
        "content_type",
        "size_bytes",
        "created_at"
      ],
      "type": "object"
    },
    "url": {
      "type": "string"
    }
  },
  "required": [
    "file",
    "url",
    "download_url"
  ],
  "type": "object"
}

Request

Responses

On this page