Files

The AI Gateway supports Anthropic’s Files API (beta) for Claude Platform on AWS, enabling file upload, listing, retrieval, and deletion through the gateway. Uploaded files can be referenced in chat completions using file_id instead of re-uploading content each request.

The Files API is in beta and requires the files-api-2025-04-14 beta header. The AI Gateway sets this automatically for file endpoints when using the SDK. For cURL requests, include the anthropic-beta: files-api-2025-04-14 header.

Upload a file

REST
OpenAI Python
OpenAI NodeJS

curl -X POST https://aigw.portkey.ai/v1/files \
  -H "Authorization: Bearer $PORTKEY_API_KEY" \
  -H "x-portkey-provider: @claude-platform-aws-provider" \
  -H "anthropic-beta: files-api-2025-04-14" \
  -F 'file=@"document.pdf"'

from openai import OpenAI

client = OpenAI(
    api_key="PORTKEY_API_KEY",
    base_url="https://aigw.portkey.ai/v1",
    default_headers={"x-portkey-provider": "@claude-platform-aws-provider"}
)

file = client.files.create(
    purpose="assistants",
    file=open("document.pdf", "rb")
)

print(file.id)

import OpenAI from 'openai';
import fs from 'fs';

const client = new OpenAI({
    apiKey: "PORTKEY_API_KEY",
    baseURL: "https://aigw.portkey.ai/v1",
    defaultHeaders: { "x-portkey-provider": "@claude-platform-aws-provider" }
});

const file = await client.files.create({
    purpose: "assistants",
    file: fs.createReadStream("document.pdf")
});

console.log(file.id);

Use uploaded files in chat completions

Once a file is uploaded, reference it by file_id in chat completions:

REST

curl -X POST https://aigw.portkey.ai/v1/chat/completions \
  -H "Authorization: Bearer $PORTKEY_API_KEY" \
  -H "anthropic-beta: files-api-2025-04-14" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "@claude-platform-aws-provider/claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": [
          {"type": "text", "text": "Please summarize this document."},
          {"type": "file", "file": {"file_id": "<file_id>", "mime_type": "application/pdf"}}
        ]
      }
    ]
  }'

When using the SDK, the anthropic-beta header is set automatically for file endpoints. For chat completions with file references via cURL, include anthropic-beta: files-api-2025-04-14 in your request headers.

List files

REST
OpenAI Python
OpenAI NodeJS

curl https://aigw.portkey.ai/v1/files \
  -H "Authorization: Bearer $PORTKEY_API_KEY" \
  -H "x-portkey-provider: @claude-platform-aws-provider" \
  -H "anthropic-beta: files-api-2025-04-14"

from openai import OpenAI

client = OpenAI(
    api_key="PORTKEY_API_KEY",
    base_url="https://aigw.portkey.ai/v1",
    default_headers={"x-portkey-provider": "@claude-platform-aws-provider"}
)

files = client.files.list()

print(files)

import OpenAI from 'openai';

const client = new OpenAI({
    apiKey: "PORTKEY_API_KEY",
    baseURL: "https://aigw.portkey.ai/v1",
    defaultHeaders: { "x-portkey-provider": "@claude-platform-aws-provider" }
});

const files = await client.files.list();

console.log(files);

Get file

REST
OpenAI Python
OpenAI NodeJS

curl https://aigw.portkey.ai/v1/files/<file_id> \
  -H "Authorization: Bearer $PORTKEY_API_KEY" \
  -H "x-portkey-provider: @claude-platform-aws-provider" \
  -H "anthropic-beta: files-api-2025-04-14"

from openai import OpenAI

client = OpenAI(
    api_key="PORTKEY_API_KEY",
    base_url="https://aigw.portkey.ai/v1",
    default_headers={"x-portkey-provider": "@claude-platform-aws-provider"}
)

file = client.files.retrieve("<file_id>")

print(file)

import OpenAI from 'openai';

const client = new OpenAI({
    apiKey: "PORTKEY_API_KEY",
    baseURL: "https://aigw.portkey.ai/v1",
    defaultHeaders: { "x-portkey-provider": "@claude-platform-aws-provider" }
});

const file = await client.files.retrieve("<file_id>");

console.log(file);

Delete file

REST
OpenAI Python
OpenAI NodeJS

curl -X DELETE https://aigw.portkey.ai/v1/files/<file_id> \
  -H "Authorization: Bearer $PORTKEY_API_KEY" \
  -H "x-portkey-provider: @claude-platform-aws-provider" \
  -H "anthropic-beta: files-api-2025-04-14"

from openai import OpenAI

client = OpenAI(
    api_key="PORTKEY_API_KEY",
    base_url="https://aigw.portkey.ai/v1",
    default_headers={"x-portkey-provider": "@claude-platform-aws-provider"}
)

response = client.files.delete("<file_id>")

print(response)

import OpenAI from 'openai';

const client = new OpenAI({
    apiKey: "PORTKEY_API_KEY",
    baseURL: "https://aigw.portkey.ai/v1",
    defaultHeaders: { "x-portkey-provider": "@claude-platform-aws-provider" }
});

const response = await client.files.delete("<file_id>");

console.log(response);

Supported file types

Type	MIME types
PDF	`application/pdf`
Images	`image/jpeg`, `image/png`, `image/gif`, `image/webp`

Integrations

LLM Integrations

Cloud Platforms

Guardrails

Plugins

Vector Databases

Agents

AI Apps

Libraries

Tracing Providers

MCP Clients

MCP Servers

Upload a file

Use uploaded files in chat completions

List files

Get file

Delete file

Supported file types

See Also

​Upload a file

​Use uploaded files in chat completions

​List files

​Get file

​Delete file

​Supported file types

​See Also

Upload a file

Use uploaded files in chat completions

List files

Get file

Delete file

Supported file types

See Also