From d230a6dd6eb1a0dbee9fec55e2f00a96e28dff81 Mon Sep 17 00:00:00 2001
From: Lance Martin <122662504+rlancemartin@users.noreply.github.com>
Date: Sun, 3 May 2026 06:58:40 -0700
Subject: [PATCH] Remove non-existent purpose field from Files API examples
 (#1081)

The Files API upload endpoint does not accept a purpose parameter.
Drop it from the managed-agents skill examples (TS and curl).
---
 skills/claude-api/curl/managed-agents.md                   | 3 +--
 skills/claude-api/shared/managed-agents-client-patterns.md | 2 +-
 skills/claude-api/shared/managed-agents-environments.md    | 1 -
 skills/claude-api/typescript/managed-agents/README.md      | 1 -
 4 files changed, 2 insertions(+), 5 deletions(-)

diff --git a/skills/claude-api/curl/managed-agents.md b/skills/claude-api/curl/managed-agents.md
index 626d04215..cd7d2f6b9 100644
--- a/skills/claude-api/curl/managed-agents.md
+++ b/skills/claude-api/curl/managed-agents.md
@@ -248,8 +248,7 @@ curl -X POST https://api.anthropic.com/v1/files \
   -H "x-api-key: $ANTHROPIC_API_KEY" \
   -H "anthropic-version: 2023-06-01" \
   -H "anthropic-beta: files-api-2025-04-14" \
-  -F "file=@path/to/file.txt" \
-  -F "purpose=agent"
+  -F "file=@path/to/file.txt"
 ```
 
 ---
diff --git a/skills/claude-api/shared/managed-agents-client-patterns.md b/skills/claude-api/shared/managed-agents-client-patterns.md
index aa26c1e07..ac0e60b09 100644
--- a/skills/claude-api/shared/managed-agents-client-patterns.md
+++ b/skills/claude-api/shared/managed-agents-client-patterns.md
@@ -168,7 +168,7 @@ The `Promise.all([stream, send])` shape works too, but stream-first is simpler a
 **The mounted resource has a different `file_id` than the file you uploaded.** Session creation makes a session-scoped copy.
 
 ```ts
-const uploaded = await client.beta.files.upload({ file, purpose: 'agent_resource' })
+const uploaded = await client.beta.files.upload({ file })
 // uploaded.id         → the original file
 const session = await client.beta.sessions.create({
   /* ... */
diff --git a/skills/claude-api/shared/managed-agents-environments.md b/skills/claude-api/shared/managed-agents-environments.md
index 2f50f4648..6724503ba 100644
--- a/skills/claude-api/shared/managed-agents-environments.md
+++ b/skills/claude-api/shared/managed-agents-environments.md
@@ -63,7 +63,6 @@ Upload a file first via the Files API, then reference by `file_id` + `mount_path
 // 1. Upload
 const file = await client.beta.files.upload({
   file: fs.createReadStream("data.csv"),
-  purpose: "agent",
 });
 
 // 2. Attach as a session resource
diff --git a/skills/claude-api/typescript/managed-agents/README.md b/skills/claude-api/typescript/managed-agents/README.md
index cc4d9e610..045470196 100644
--- a/skills/claude-api/typescript/managed-agents/README.md
+++ b/skills/claude-api/typescript/managed-agents/README.md
@@ -273,7 +273,6 @@ import fs from "fs";
 
 const file = await client.beta.files.upload({
   file: fs.createReadStream("data.csv"),
-  purpose: "agent",
 });
 
 // Use in a session