diff --git a/content/.metadata.json b/content/.metadata.json index 0e6afcc82..08ce4e0d2 100644 --- a/content/.metadata.json +++ b/content/.metadata.json @@ -1,7 +1,7 @@ { "metadata": { "version": "1.0", - "fetch_date": "2026-04-07T16:44:16.101230Z" + "fetch_date": "2026-04-08T11:44:17.716242Z" }, "items": [ { @@ -22,8 +22,8 @@ "url": "https://platform.claude.com/docs/en/about-claude/models/overview", "status": "success", "path": "en/about-claude/models/overview.md", - "sha256": "6810d59c341b3aed35ad7dc265e125a2901f412d9752591b1a5fed4ffdb10119", - "size": 9584 + "sha256": "db4358115c019eb7eb23012ec34de4ba0683159aa25a96b626f8f0e5d565c560", + "size": 10037 }, { "url": "https://platform.claude.com/docs/en/about-claude/models/choosing-a-model", @@ -57,22 +57,22 @@ "url": "https://platform.claude.com/docs/en/about-claude/pricing", "status": "success", "path": "en/about-claude/pricing.md", - "sha256": "758d503d1746bcdda52d1c408251defb80daf9263b6556f7945b01cb3299589d", - "size": 20642 + "sha256": "acdade6d72307ed5f370d8cc01b8cda4c21ec38146e069b687cc5d920ab6e89e", + "size": 20885 }, { "url": "https://platform.claude.com/docs/en/build-with-claude/overview", "status": "success", "path": "en/build-with-claude/overview.md", - "sha256": "cd40a1ca5381b4ac6bf45be6837b53bfd6081478824cec5415632079f22111fe", - "size": 12746 + "sha256": "ffad06f6f34609f0a5ffb62275bef9ac356241763ad27407faec669d65b0d529", + "size": 12717 }, { "url": "https://platform.claude.com/docs/en/build-with-claude/working-with-messages", "status": "success", "path": "en/build-with-claude/working-with-messages.md", - "sha256": "3c7652292608f6acbe31600027a77e4e3705c09e85745f2ebe0f698911c6a7f1", - "size": 32255 + "sha256": "1b0735cd3122c463926fc8898f9c3836a1d5459a7de79c9d0f603c1886286ca4", + "size": 32314 }, { "url": "https://platform.claude.com/docs/en/build-with-claude/handling-stop-reasons", @@ -85,29 +85,29 @@ "url": "https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices", "status": "success", "path": "en/build-with-claude/prompt-engineering/claude-prompting-best-practices.md", - "sha256": "8045bdd2f8c9d1673bb3fc5501cdd58adbe9ed1f2dc27262d3ca30471d0d3cef", - "size": 46684 + "sha256": "5387b42af4e10ee84c29d988fad36e4d8623f5c40eec34a682b8758c1f7daf90", + "size": 46827 }, { "url": "https://platform.claude.com/docs/en/build-with-claude/extended-thinking", "status": "success", "path": "en/build-with-claude/extended-thinking.md", - "sha256": "c1e9fa87415a890fcd9c1d49fd29d4e1062b4fb05a83199b2f2e0ee93b9b3160", - "size": 131688 + "sha256": "675f93e33dfaf7523de39df3f84b94894418dc37881335e9d834ea3cabdb3b92", + "size": 134777 }, { "url": "https://platform.claude.com/docs/en/build-with-claude/adaptive-thinking", "status": "success", "path": "en/build-with-claude/adaptive-thinking.md", - "sha256": "a2ce9c3775170f4f4c7958d09cad6a28a1a8dc3d5e088f89d0aaa720e1171586", - "size": 32361 + "sha256": "1090bb59f5f0beb2ec817338a91f55880952c4b0c0942c5c4ce0399ce5ba6818", + "size": 33409 }, { "url": "https://platform.claude.com/docs/en/build-with-claude/effort", "status": "success", "path": "en/build-with-claude/effort.md", - "sha256": "a8bc4b56dbb971f2294cf4b2eba00f05419201953e1fe32d44464cff8bded206", - "size": 12580 + "sha256": "277a214b03c522810c58850a16f1c706941b58c012bb368bd3e0544beb2ad6f1", + "size": 12940 }, { "url": "https://platform.claude.com/docs/en/build-with-claude/fast-mode", @@ -120,8 +120,8 @@ "url": "https://platform.claude.com/docs/en/build-with-claude/structured-outputs", "status": "success", "path": "en/build-with-claude/structured-outputs.md", - "sha256": "ef315a75468fc21a58815d0ce8368b775c4f953d4f0d9de622f12a2d9c08c990", - "size": 85936 + "sha256": "c41d099e71a06cd378c225d088f9c275fceec3a8535e32bd45e48662a9b9fc5e", + "size": 86086 }, { "url": "https://platform.claude.com/docs/en/build-with-claude/citations", @@ -204,8 +204,8 @@ "url": "https://platform.claude.com/docs/en/agents-and-tools/tool-use/define-tools", "status": "success", "path": "en/agents-and-tools/tool-use/define-tools.md", - "sha256": "1dba539faefaa44f99a5d3ddfb8a34ed705a2cd5f808cc7c57c607c4e0d847b2", - "size": 23143 + "sha256": "a4455dfae407bb148caaf5290f21a916be77185e1b654c94b0042e95633822c2", + "size": 23515 }, { "url": "https://platform.claude.com/docs/en/agents-and-tools/tool-use/handle-tool-calls", @@ -218,8 +218,8 @@ "url": "https://platform.claude.com/docs/en/agents-and-tools/tool-use/parallel-tool-use", "status": "success", "path": "en/agents-and-tools/tool-use/parallel-tool-use.md", - "sha256": "436d79c17552460016ef74d9b104e74feb88b964c56ddfea0eda9e410a686de5", - "size": 30725 + "sha256": "b39229b20635003c3b809fa91103f5ef1e196ac8faaa6c24cd0f2ae9afd36b8c", + "size": 30275 }, { "url": "https://platform.claude.com/docs/en/agents-and-tools/tool-use/tool-runner", @@ -267,22 +267,22 @@ "url": "https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-search-tool", "status": "success", "path": "en/agents-and-tools/tool-use/web-search-tool.md", - "sha256": "e454182789ce5df2c941c90152d979eeeeef3ae2c1ffa28c4c9325469cc80cfc", - "size": 20128 + "sha256": "05074f62a90c5d568241b3435feb5bb9f6ba5d7cfdda1b85aa31acee05e2c8e6", + "size": 20393 }, { "url": "https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-fetch-tool", "status": "success", "path": "en/agents-and-tools/tool-use/web-fetch-tool.md", - "sha256": "ba4339089b46f4baff57bb9780a3c8f2547fb0bf6fc6354f656e33e02918098a", - "size": 23035 + "sha256": "f0622b4302ab52259d49ef938932038c7d84671b070a3a3d1c1976971a85e799", + "size": 23297 }, { "url": "https://platform.claude.com/docs/en/agents-and-tools/tool-use/code-execution-tool", "status": "success", "path": "en/agents-and-tools/tool-use/code-execution-tool.md", - "sha256": "07a2d0e44b664572d4a08397acd40d76aa0df05b4a1d9a2e346fb72e09d6cd05", - "size": 52691 + "sha256": "d4856566311bc55bfe173b4fcec88846c854805b771cfc588c004ec7588800e9", + "size": 52124 }, { "url": "https://platform.claude.com/docs/en/agents-and-tools/tool-use/memory-tool", @@ -330,8 +330,8 @@ "url": "https://platform.claude.com/docs/en/agents-and-tools/tool-use/tool-search-tool", "status": "success", "path": "en/agents-and-tools/tool-use/tool-search-tool.md", - "sha256": "de9941100ffacefe8d374f77efa9d65f263bca1142fcd5720529e26ac5072879", - "size": 29606 + "sha256": "5a0377fe589a543ba20760a4f0703a310b0c5a5373a957a8e03d89be93af3240", + "size": 29664 }, { "url": "https://platform.claude.com/docs/en/agents-and-tools/tool-use/programmatic-tool-calling", @@ -351,29 +351,29 @@ "url": "https://platform.claude.com/docs/en/build-with-claude/context-windows", "status": "success", "path": "en/build-with-claude/context-windows.md", - "sha256": "e11013e7744c2923a713409ed9f4ce326b2b3ed5e6d6d942d5dc2fb2b2ff565a", - "size": 13431 + "sha256": "ffa3ee57c040ef5983148b01c009c37a7c556be0f927ceaf3a87ef98301e52b0", + "size": 13497 }, { "url": "https://platform.claude.com/docs/en/build-with-claude/compaction", "status": "success", "path": "en/build-with-claude/compaction.md", - "sha256": "71cb71a9e6fd28d433d06ddd5b7256fe9ed3dd9e1a819fbbf8b482510617b187", - "size": 95638 + "sha256": "5e63ea97fcbae8dcc4714e1e2c2d1e1f777a57cd074bf686ab20b12fce064368", + "size": 95723 }, { "url": "https://platform.claude.com/docs/en/build-with-claude/context-editing", "status": "success", "path": "en/build-with-claude/context-editing.md", - "sha256": "fe35af2ad0fa425648c16dcb36c6dd4839d69d7d8aea3efb6a77676bb5e29ad5", - "size": 76790 + "sha256": "ee16690987f0c061ce5f5aa69de8cb943a9073999f7aff3f739dcfcc1542202d", + "size": 76453 }, { "url": "https://platform.claude.com/docs/en/build-with-claude/prompt-caching", "status": "success", "path": "en/build-with-claude/prompt-caching.md", - "sha256": "c001cd5044bcd6d04371b43657d238dcd4511d1e07f57819a56e73052f74e9ca", - "size": 113547 + "sha256": "88a84f107e1234efe53b61c0966e39c8900f0616474a4748a8f585bb8d13f8e6", + "size": 113085 }, { "url": "https://platform.claude.com/docs/en/build-with-claude/token-counting", @@ -449,8 +449,8 @@ "url": "https://platform.claude.com/docs/en/agent-sdk/agent-loop", "status": "success", "path": "en/agent-sdk/agent-loop.md", - "sha256": "77a76c3cc79cc0ddc32c27958d82ff131fb89901ce1234cff9f77c29b12ed7c4", - "size": 29625 + "sha256": "5ff1a7faa5019f1e1577673bf7c9f68d10dcd0880498831b9abf0db3bcccdb30", + "size": 29640 }, { "url": "https://platform.claude.com/docs/en/agent-sdk/claude-code-features", @@ -470,8 +470,8 @@ "url": "https://platform.claude.com/docs/en/agent-sdk/streaming-vs-single-mode", "status": "success", "path": "en/agent-sdk/streaming-vs-single-mode.md", - "sha256": "ce705f6e00c63bd212144315bc693281cac878363c0a43fd11601c1f282a4c67", - "size": 7680 + "sha256": "a3944aabf53a03f1f7506bf63c35533bc0f5c8ff166c45bde3f8a7c9e315543c", + "size": 7648 }, { "url": "https://platform.claude.com/docs/en/agent-sdk/streaming-output", @@ -491,22 +491,22 @@ "url": "https://platform.claude.com/docs/en/agent-sdk/custom-tools", "status": "success", "path": "en/agent-sdk/custom-tools.md", - "sha256": "b15d4fd831df1692c6515296cc219e6258f4d298e7cbb04472b2b24c103b356f", - "size": 31219 + "sha256": "37edf161dd83eb1f82308527b70bdff3f725eb037c90f896078c159b59928626", + "size": 31496 }, { "url": "https://platform.claude.com/docs/en/agent-sdk/tool-search", "status": "success", "path": "en/agent-sdk/tool-search.md", - "sha256": "cf80a6490afc1e57b5920a08d5d418a6eef651090d0a46c37e917bafecb0d308", - "size": 6445 + "sha256": "f97abbe892a6d553c83d05fcf3ed859cccb7fd4511b622416e1213e8a4be91d4", + "size": 6349 }, { "url": "https://platform.claude.com/docs/en/agent-sdk/permissions", "status": "success", "path": "en/agent-sdk/permissions.md", - "sha256": "0c49be2c89ba8c38aeeb041f2ab4077c5fc5013fb8888f82758109a57ebda3f8", - "size": 10759 + "sha256": "010617ce8d02c108a61878c6238a4ee034d815d259cdb3b699d2f59efdaee0d5", + "size": 10982 }, { "url": "https://platform.claude.com/docs/en/agent-sdk/user-input", @@ -561,8 +561,8 @@ "url": "https://platform.claude.com/docs/en/agent-sdk/subagents", "status": "success", "path": "en/agent-sdk/subagents.md", - "sha256": "aa965fa94558cdbec9464169559666a157045d984f5b73c55b986c925a7bcfea", - "size": 25258 + "sha256": "33231d55a08935113bc8ae17a112c219ea50a596fcd3ce7e140a268af4328d37", + "size": 25042 }, { "url": "https://platform.claude.com/docs/en/agent-sdk/slash-commands", @@ -575,8 +575,8 @@ "url": "https://platform.claude.com/docs/en/agent-sdk/skills", "status": "success", "path": "en/agent-sdk/skills.md", - "sha256": "1d2fa2919901165816457ebb4bf51207a14b9e5286325221265fb85d7ba7cc5c", - "size": 10463 + "sha256": "1fc8fe2f562fb8d7426167c59ad7b6186942e8d09f1fb44a19d307327a1f7a80", + "size": 10689 }, { "url": "https://platform.claude.com/docs/en/agent-sdk/cost-tracking", @@ -603,8 +603,8 @@ "url": "https://platform.claude.com/docs/en/agent-sdk/typescript", "status": "success", "path": "en/agent-sdk/typescript.md", - "sha256": "f34262c518725daf967d7af659405f42d6d04754b5c4fbbc04baabd7d3ef7501", - "size": 73153 + "sha256": "e1d2216372120977e551bedf1aaef7438c617ec2c7c23660a18d3582e800abfa", + "size": 73223 }, { "url": "https://platform.claude.com/docs/en/agent-sdk/typescript-v2-preview", @@ -617,8 +617,8 @@ "url": "https://platform.claude.com/docs/en/agent-sdk/python", "status": "success", "path": "en/agent-sdk/python.md", - "sha256": "ece42e5f2ca7e6e8082b50a2cb1b8344f2b091659fdc17eedd7117803570b1c4", - "size": 113238 + "sha256": "7b7b4ce9287afb19156198aac7004148c777ea2a5b187ae2909067459cb8aac6", + "size": 113246 }, { "url": "https://platform.claude.com/docs/en/agent-sdk/migration-guide", @@ -641,26 +641,33 @@ "sha256": "42aeab377e3bd764a9661a58119f60b92a3da01cdcd96feefd935df1c4b47c98", "size": 1271 }, + { + "url": "https://platform.claude.com/docs/en/build-with-claude/claude-in-amazon-bedrock", + "status": "success", + "path": "en/build-with-claude/claude-in-amazon-bedrock.md", + "sha256": "27d2db331d9649a1e75de2dd31637db9d8fe6b64b0ff5cede008b0d8ef015923", + "size": 11412 + }, { "url": "https://platform.claude.com/docs/en/build-with-claude/claude-on-amazon-bedrock", "status": "success", "path": "en/build-with-claude/claude-on-amazon-bedrock.md", - "sha256": "17c301726ab5710d29a947769dcb6d875c99210703366ac77dd0a0e2819c5b0e", - "size": 28192 + "sha256": "01ccd6388151bb8189a8c3514108af7f6091eb8386cad1cdceede1b8c57c9975", + "size": 28749 }, { "url": "https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry", "status": "success", "path": "en/build-with-claude/claude-in-microsoft-foundry.md", - "sha256": "b111dcdf12bcbb8ebe246c58024ada843fb3b673917d65d8b59470cd8c6f3865", - "size": 20519 + "sha256": "031d5f283e82e224f885c676db91d52071c200ae6c4102639374117327577a24", + "size": 20754 }, { "url": "https://platform.claude.com/docs/en/build-with-claude/claude-on-vertex-ai", "status": "success", "path": "en/build-with-claude/claude-on-vertex-ai.md", - "sha256": "aef403ac67d9a87fec3e901a89191873ff1d1595cd01ba3050ee52ccce84acce", - "size": 18935 + "sha256": "3eec9a604ceb11bf980c2d48afd035963734b1a2933a8ffac7790926698901e8", + "size": 23407 }, { "url": "https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/overview", @@ -708,8 +715,8 @@ "url": "https://platform.claude.com/docs/en/test-and-evaluate/strengthen-guardrails/increase-consistency", "status": "success", "path": "en/test-and-evaluate/strengthen-guardrails/increase-consistency.md", - "sha256": "d47b5652ef2c3e362d5735abdbb3a6882e0b2aa598d4415bc47429e6f7364888", - "size": 14292 + "sha256": "d52112e5bf7003f6f14a81bfcc6cd1ba4a012f3b4c394b3caf101bc25a1fcc43", + "size": 14351 }, { "url": "https://platform.claude.com/docs/en/test-and-evaluate/strengthen-guardrails/mitigate-jailbreaks", @@ -729,8 +736,8 @@ "url": "https://platform.claude.com/docs/en/test-and-evaluate/strengthen-guardrails/reduce-prompt-leak", "status": "success", "path": "en/test-and-evaluate/strengthen-guardrails/reduce-prompt-leak.md", - "sha256": "5c47eaaeea354aa7d36abd4b7e36dd6afc2ca7f3b44b97e44a099ba1bc571dc5", - "size": 3031 + "sha256": "8c621321a8b5942ce0ce990687a5973919c04482a300a7852f5dcaafcc74d41e", + "size": 3090 }, { "url": "https://platform.claude.com/docs/en/build-with-claude/administration-api", @@ -771,14 +778,14 @@ "url": "https://platform.claude.com/docs/en/build-with-claude/api-and-data-retention", "status": "success", "path": "en/build-with-claude/api-and-data-retention.md", - "sha256": "45f1bd35900902c3e097c9e3ff1533bff9caed8faac66462168fa2b407424cf6", - "size": 22369 + "sha256": "b40a6c17fb3bff3cbf719b0120b2421517f84967a5e82060a10490788dbd6b51", + "size": 22340 }, { "url": "https://platform.claude.com/docs/en/api/overview", "status": "success", "path": "en/api/overview.md", - "sha256": "4ae7935dda920bef62f181547a6d66392427e65f0b377868b346902c55ef7617", + "sha256": "a20b9ab4a4731c8f7a049fc4d05c1e4f885b7f60b5ec83edd8298eab726ab023", "size": 8848 }, { @@ -792,14 +799,14 @@ "url": "https://platform.claude.com/docs/en/api/errors", "status": "success", "path": "en/api/errors.md", - "sha256": "5f48d1e9682bf7f4312fa08a2ec2ca543fc3ba1b1cb0f38e0d186aede0c68759", - "size": 6504 + "sha256": "ec2bdfd204bc452f97839fde634e4edf14373b95a05d11a448aeca83fe6ef609", + "size": 6722 }, { "url": "https://platform.claude.com/docs/en/api/client-sdks", "status": "success", "path": "en/api/client-sdks.md", - "sha256": "10cb253283f257ac0348c448aa4ba9ef4ebb291f6f3de9e451d46571f027f464", + "sha256": "ccf1f17a782d130f28057df9eb9e7d7b9a08009dfde933b4ffe5e76e8eb51a65", "size": 7967 }, { @@ -862,8 +869,8 @@ "url": "https://platform.claude.com/docs/en/api/service-tiers", "status": "success", "path": "en/api/service-tiers.md", - "sha256": "13aa6e267a2e9ed5b050167c82757ff8dd767764a0687a0c4df08fdae61829cd", - "size": 5784 + "sha256": "6f081b4bb132610e8cd9dbecbea8dc4c6f1a6b23131384125c8c6f84fd281fe4", + "size": 5575 }, { "url": "https://platform.claude.com/docs/en/api/versioning", @@ -953,36 +960,36 @@ "url": "https://platform.claude.com/docs/en/release-notes/overview", "status": "success", "path": "en/release-notes/overview.md", - "sha256": "15c3d439915aee763a5478fc92411803adeb5cb42f7e80469f32af1476706d39", - "size": 37802 + "sha256": "701cb7908ba0c1b30ca959f08c696eb480e19b7a4946ee96c3872277842497cd", + "size": 38509 }, { "url": "https://platform.claude.com/docs/en/api/completions", "status": "success", "path": "en/api/completions.md", - "sha256": "cf0f2a2a2bc404cafc07e0e680be35d52f952c09b8c57d2c3664804788973d1d", - "size": 11471 + "sha256": "172aea891cf5a1fd881b339103cceddd97dd507272d898bbc41f25613c68b1ef", + "size": 11541 }, { "url": "https://platform.claude.com/docs/en/api/completions/create", "status": "success", "path": "en/api/completions/create.md", - "sha256": "db2231f4c889211f8234b89a288028105d1a2f877b53c7a42a38003b5b823e29", - "size": 8894 + "sha256": "a2dea0a4c840acce2bf49963c90bac3170c1a640292a81ac4ef9ea93cf44de7b", + "size": 8964 }, { "url": "https://platform.claude.com/docs/en/api/messages", "status": "success", "path": "en/api/messages.md", - "sha256": "0e993ad0894f7277fa438b5399af706222cc8a83b1b6b246041bf23bc531705a", - "size": 891396 + "sha256": "bb0ff317904c110a9abe768ed5385e1ade18167ed10002a9c62879657a260bf3", + "size": 897401 }, { "url": "https://platform.claude.com/docs/en/api/messages/create", "status": "success", "path": "en/api/messages/create.md", - "sha256": "4154d5b992e6cffa4bc5e2cc1564e159b7f5c50b9cc0d45adc678b074f893726", - "size": 121622 + "sha256": "533046bb19826e4cd7b0083c4624aeb056a5c4ceadd231ee677292c070613250", + "size": 122130 }, { "url": "https://platform.claude.com/docs/en/api/messages/count_tokens", @@ -995,8 +1002,8 @@ "url": "https://platform.claude.com/docs/en/api/messages/batches", "status": "success", "path": "en/api/messages/batches.md", - "sha256": "18ab273bcec95a0cb9302198b4b5291e03cc8f57bc9f73595a718585d6255529", - "size": 233356 + "sha256": "601377e6e3ae4a4bffb6a68d0bd3f5a5c5948d7953b8fe5596c46a77ee3f37e4", + "size": 235604 }, { "url": "https://platform.claude.com/docs/en/api/messages/batches/create", @@ -1037,267 +1044,309 @@ "url": "https://platform.claude.com/docs/en/api/messages/batches/results", "status": "success", "path": "en/api/messages/batches/results.md", - "sha256": "ca7d5edb5e6bcb2adfe805e9c0c08a2f41c678962b409740fdc761e38d57a03b", - "size": 27997 + "sha256": "d2e4da5349604b7b9e56fb915dedc4b639669143b681e623b22b99217e65a840", + "size": 28577 }, { "url": "https://platform.claude.com/docs/en/api/models", "status": "success", "path": "en/api/models.md", - "sha256": "48f0bac37ad9434f25035843b83703353b85116e5f1f9e1463d015a82510d1ec", - "size": 23076 + "sha256": "f86fad3c700a06dcfd10d8838c7c34d65d49c66038cef7f41afa37f23ee41d06", + "size": 23216 }, { "url": "https://platform.claude.com/docs/en/api/models/list", "status": "success", "path": "en/api/models/list.md", - "sha256": "89a6782bfb3a3f24f327a0a03725af8a0573e0ccc532dc247523af86412952f9", - "size": 6399 + "sha256": "c09d807618785ff65ca01eb9b44585cf1befe2718c61676dcc6a9d0ac41ee344", + "size": 6469 }, { "url": "https://platform.claude.com/docs/en/api/models/retrieve", "status": "success", "path": "en/api/models/retrieve.md", - "sha256": "6f7b15575a28a2871b638e6bac579a77913aef154ab486aefaaecdc199d6393f", - "size": 5748 + "sha256": "6a65e3554cabab2a1af71311d206de9d23dc17e6eb904b83774d76d3789b3756", + "size": 5818 }, { "url": "https://platform.claude.com/docs/en/api/beta", "status": "success", "path": "en/api/beta.md", - "sha256": "51dc8ec9f5c4a228d39543cdb15f9f0a767001b64a16f42ef4d51a20d3e8713d", - "size": 1163767 + "sha256": "0a56c3fd7ccf2424d7efe3c7ca4f15e0c0dbe2382cc525d51ba5fdc3ec9cdedd", + "size": 1188825 }, { "url": "https://platform.claude.com/docs/en/api/beta/models", "status": "success", "path": "en/api/beta/models.md", - "sha256": "e6d2b39111887815faa16023b6478d8925843b0b67b43a3660f82825a1a53cd8", - "size": 23531 + "sha256": "51dc5f5499e05437e2896227bdba34084e44075f28cfe6f97cf63ec69570f499", + "size": 23651 }, { "url": "https://platform.claude.com/docs/en/api/beta/models/list", "status": "success", "path": "en/api/beta/models/list.md", - "sha256": "2720dcb61dbef23706e7d108ce2a3f00fdd21a0c75a94e27fcc0de47fd1b6a2a", - "size": 6493 + "sha256": "4faa5b49a9cd85d2dcb3ad97b83ed4b94e535f142903dd856ede1e419509f60f", + "size": 6553 }, { "url": "https://platform.claude.com/docs/en/api/beta/models/retrieve", "status": "success", "path": "en/api/beta/models/retrieve.md", - "sha256": "e7364e098fdd2c9d1a17f1b7c9bfdaa6c20a6d5f5579544dbb6b9c5e6438a9c6", - "size": 5842 + "sha256": "d88760c7cbdb29b351c6677ad94d18c63f22db1352e80e2410a9af8d63d7a2c1", + "size": 5902 }, { "url": "https://platform.claude.com/docs/en/api/beta/messages", "status": "success", "path": "en/api/beta/messages.md", - "sha256": "150d88ff37fdc9aee5a7876daa75fd7c8021ddecc5d10a1193e13208e94955ed", - "size": 1105203 + "sha256": "0bb19b96d04020cb2607b64ce256c3695c7239ad0f3b6c04ae350e2e4f73dd97", + "size": 1112061 }, { "url": "https://platform.claude.com/docs/en/api/beta/messages/create", "status": "success", "path": "en/api/beta/messages/create.md", - "sha256": "c5933c80fd0ca556fadfe60a62fda05d171518a548e2ecb68bc6a99dfec3aa27", - "size": 153001 + "sha256": "3f16b1363d0194eaa8bf94fee46b5f4303d3663cad427a39fde0d1b4db42e823", + "size": 153731 }, { "url": "https://platform.claude.com/docs/en/api/beta/messages/count_tokens", "status": "success", "path": "en/api/beta/messages/count_tokens.md", - "sha256": "84cf2c95101921cbd3c54f16de3ae5aa7de76587bc2723c2b23acf636bd63f77", - "size": 119262 + "sha256": "9eab57d92b24cbe7f027da5acb6c9f737a0c56bf74465b63ea93d754fdeba416", + "size": 119322 }, { "url": "https://platform.claude.com/docs/en/api/beta/messages/batches", "status": "success", "path": "en/api/beta/messages/batches.md", - "sha256": "6b32ae3561ff34edac268c3191e4b18dc4a491808a04456f394e60239824c77e", - "size": 300735 + "sha256": "4d22404990bb278be2178275c0e62ab2c78c4ccc98f774e62b0fb54b222aa185", + "size": 303525 }, { "url": "https://platform.claude.com/docs/en/api/beta/messages/batches/create", "status": "success", "path": "en/api/beta/messages/batches/create.md", - "sha256": "3211176777ea273da7da0a746b5a37d0108e0b2c61c2a7e8782a2e6a579388a5", - "size": 136008 + "sha256": "a4124411cfb44775d218a5e5b46d67552bfcbf972f283b1ac8b56a0491581e4c", + "size": 136234 }, { "url": "https://platform.claude.com/docs/en/api/beta/messages/batches/retrieve", "status": "success", "path": "en/api/beta/messages/batches/retrieve.md", - "sha256": "59042d81e7f41db0e11a8e823b40631784627a5cad9e8cce3e0d8064a675fcaf", - "size": 4548 + "sha256": "ec4b4c463cb4568760f56b3080adfd2bbd5b1bf1dbeb534e520be2f40e4076d2", + "size": 4608 }, { "url": "https://platform.claude.com/docs/en/api/beta/messages/batches/list", "status": "success", "path": "en/api/beta/messages/batches/list.md", - "sha256": "6a8ca7bde3ac36c80bab2ed2b056c89af99fd16fa3ffb919b818bce01dc8102e", - "size": 5060 + "sha256": "be943a5c8ec4f1743e8ac1fb553cecc1768a1f83af25d9444f2af96b12593418", + "size": 5120 }, { "url": "https://platform.claude.com/docs/en/api/beta/messages/batches/cancel", "status": "success", "path": "en/api/beta/messages/batches/cancel.md", - "sha256": "6ee0767999d4e413981b24dbeb6d16e559347e43d0ac73057752623c0ba107ca", - "size": 4885 + "sha256": "6107448f700894cc1d05cdd8489b233548743488b701fd951cc0aba5753a2b55", + "size": 4945 }, { "url": "https://platform.claude.com/docs/en/api/beta/messages/batches/delete", "status": "success", "path": "en/api/beta/messages/batches/delete.md", - "sha256": "8cb34be98461b7d2138e89ccaa66e75f4519569c48066d5c654c7b880b585fda", - "size": 2003 + "sha256": "74834f88895232bfcd441fa20f7774fea8cab97c1e5535d2ccf95f00507672c1", + "size": 2063 }, { "url": "https://platform.claude.com/docs/en/api/beta/messages/batches/results", "status": "success", "path": "en/api/beta/messages/batches/results.md", - "sha256": "038879440cab9df54ef2e433df169ca887320876dc0fafa668778f2c3da014e3", - "size": 38618 + "sha256": "26367ab9fc5ad3d468ae1b0a8f52ad9c2c624e372508c657fad0f7e650b78af3", + "size": 39262 }, { "url": "https://platform.claude.com/docs/en/api/beta/files", "status": "success", "path": "en/api/beta/files.md", - "sha256": "48a72a549287e7c1416312a082fd986b8aacfb4238988d821b1bb485be87a776", - "size": 10517 + "sha256": "087a774ac9f313d9360450426736730ea0cbdedcec3a658f89fe19aa040eb70f", + "size": 10817 }, { "url": "https://platform.claude.com/docs/en/api/beta/files/upload", "status": "success", "path": "en/api/beta/files/upload.md", - "sha256": "b38be0600b4cbf5c34131f76bdb689b821abe67c9fcef59ce0bbe7e5ba63cdb2", - "size": 1988 + "sha256": "d60fac3d5af65aa69c42c50fcbc1007052db0c0ce1dc9b2e77260fe784512420", + "size": 2048 }, { "url": "https://platform.claude.com/docs/en/api/beta/files/list", "status": "success", "path": "en/api/beta/files/list.md", - "sha256": "60f567fd8153a4c1a923960ea30005206feedfe14e6796ccf3b558c221ad6e32", - "size": 2605 + "sha256": "8fd406de7d4840e001381d3819e60c1a25361b1615d3438650865bc2456c9269", + "size": 2665 }, { "url": "https://platform.claude.com/docs/en/api/beta/files/download", "status": "success", "path": "en/api/beta/files/download.md", - "sha256": "fd9010af885df69f11e89f695c9d4ee4393c508df6d8eb5c941a03ff04e83f77", - "size": 1379 + "sha256": "942f577b25dcd6e886f309be7bd577b2724e170c3cbdae600314179f869f5e90", + "size": 1439 }, { "url": "https://platform.claude.com/docs/en/api/beta/files/retrieve_metadata", "status": "success", "path": "en/api/beta/files/retrieve_metadata.md", - "sha256": "7c3fd51b6588afde4e6711a09c647bd1ea75135237f4a8117a35bf1da0cd8b7d", - "size": 2008 + "sha256": "266093eb24bb0e8d71e70c6e7ee526be82026e5664c6ba9de0265bc5d3128b10", + "size": 2068 }, { "url": "https://platform.claude.com/docs/en/api/beta/files/delete", "status": "success", "path": "en/api/beta/files/delete.md", - "sha256": "1930a26dbcea224bd034af3c5dd25f9ae578a5a9da4c816c5dc7bc47996ffc55", - "size": 1621 + "sha256": "83c59b4a72977c24892cc7f1f608b30138365ed059e7b516335a4c6360c879f4", + "size": 1681 }, { "url": "https://platform.claude.com/docs/en/api/beta/skills", "status": "success", "path": "en/api/beta/skills.md", - "sha256": "c78605fa5fccb1b5cb84d20de86f36a7e0e7a5a896a587e3ee717958a3377907", - "size": 19092 + "sha256": "ec8d6162e784ff398f03c6367ba155031ca41fd1dc6929d8230ee76343b0fa20", + "size": 26346 }, { "url": "https://platform.claude.com/docs/en/api/beta/skills/create", "status": "success", "path": "en/api/beta/skills/create.md", - "sha256": "91fa60c558ccc7bd4eff46a7416e2049b0e6c4bf001ba965d5fdcc1ad9452e8c", - "size": 2140 + "sha256": "e5be729d0312312dcd3f67ee10545e1f78a08fcbde857780038ed589bb593431", + "size": 2200 }, { "url": "https://platform.claude.com/docs/en/api/beta/skills/list", "status": "success", "path": "en/api/beta/skills/list.md", - "sha256": "f4fc4dd599f6ac34c79643c052b7a9a8c5b3cf1f19bd170910c7c7663aa68dae", - "size": 3172 + "sha256": "231840aa4f0fe004d84bccd314136eded80ab44ba84912c431f40647dc49891e", + "size": 3232 }, { "url": "https://platform.claude.com/docs/en/api/beta/skills/retrieve", "status": "success", "path": "en/api/beta/skills/retrieve.md", - "sha256": "f8053e9f9da366cd0114cbaf58e5c645886a5bbab162bc99b5f1d8eda64e338e", - "size": 2278 + "sha256": "3f3134ae00cfb70b9653f21eb397d709682454a253c0543a3fc8804bb263382f", + "size": 2338 }, { "url": "https://platform.claude.com/docs/en/api/beta/skills/delete", "status": "success", "path": "en/api/beta/skills/delete.md", - "sha256": "eda675c3e73f4a3b5d5e7b168cc9ca3fa383609674c1c18badbdbeb8b2709386", - "size": 1662 + "sha256": "0e20fc3ff1501f59ce5ec7874379871ffab4c49388fc23b20981c355fe1ac8ed", + "size": 1722 }, { "url": "https://platform.claude.com/docs/en/api/beta/skills/versions", "status": "success", "path": "en/api/beta/skills/versions.md", - "sha256": "d64e66e4402139351c2749b7d1eb11430c0026ecb462f28f8c96599b1f160968", - "size": 9826 + "sha256": "f0c309756dc9e0eed11d8fbdda70aef1ddeaced9ab3213a62d2f6cf1aba8bafa", + "size": 13606 }, { "url": "https://platform.claude.com/docs/en/api/beta/skills/versions/create", "status": "success", "path": "en/api/beta/skills/versions/create.md", - "sha256": "1092cfbd6f7732ae1a2b749c934acbf29f0853e4c00dcf4ef301c51f73ab4a72", - "size": 2401 + "sha256": "f9934b49e021653159e1a42c51859a508fb83644932a0517b8970e86d068fff6", + "size": 2461 }, { "url": "https://platform.claude.com/docs/en/api/beta/skills/versions/list", "status": "success", "path": "en/api/beta/skills/versions/list.md", - "sha256": "62311a861d02927ca979bc40e8998971ccd920114020848bce86013ab45e5c26", - "size": 2968 + "sha256": "e5cc2369e694fe57705a4c15489d2baa7c2a907c5cfd06f79ba96cdd5964b6a8", + "size": 3028 }, { "url": "https://platform.claude.com/docs/en/api/beta/skills/versions/retrieve", "status": "success", "path": "en/api/beta/skills/versions/retrieve.md", - "sha256": "4de16b22ea7dd18f58f3e179cf1bcfca539a084a60f5ac21fa3e9178b1699efd", - "size": 2546 + "sha256": "3fb8ecdf51ebed03fa634c51a9b638f855ec707382e0a007e64520543a557c2a", + "size": 2606 }, { "url": "https://platform.claude.com/docs/en/api/beta/skills/versions/delete", "status": "success", "path": "en/api/beta/skills/versions/delete.md", - "sha256": "69731e2f0f254334f5a58a4f300885cd62314c3d6f2bfa312fc524dbd477e3d7", - "size": 1896 + "sha256": "4183c41d34f3d122dba12c0b63c7fcab407bb944ab66b72b24a8ed98a5d2bba4", + "size": 1956 + }, + { + "url": "https://platform.claude.com/docs/en/api/beta/user_profiles", + "status": "success", + "path": "en/api/beta/user_profiles.md", + "sha256": "ce200a1a9d0303db4ba72501e42c39dd1e36d64ba7507d914f1f6f5e724128f2", + "size": 10455 + }, + { + "url": "https://platform.claude.com/docs/en/api/beta/user_profiles/create", + "status": "success", + "path": "en/api/beta/user_profiles/create.md", + "sha256": "a65fa336bf46be02ad6058f50d8c92c8d081f2647a0c2f40145cf3a5a567a588", + "size": 2072 + }, + { + "url": "https://platform.claude.com/docs/en/api/beta/user_profiles/list", + "status": "success", + "path": "en/api/beta/user_profiles/list.md", + "sha256": "929957f5928e16872463b7ee6939b0aa84256d90457677950cff45c882cf818f", + "size": 1975 + }, + { + "url": "https://platform.claude.com/docs/en/api/beta/user_profiles/retrieve", + "status": "success", + "path": "en/api/beta/user_profiles/retrieve.md", + "sha256": "020d9734138d8caa2c299c32f9ffec84ed6ab8df997dcc4d8288c7b15ad46ef5", + "size": 1795 + }, + { + "url": "https://platform.claude.com/docs/en/api/beta/user_profiles/update", + "status": "success", + "path": "en/api/beta/user_profiles/update.md", + "sha256": "a668cac16338837049265a7d26429a33d879410d3b04102dc10bc428d261e9fe", + "size": 2208 + }, + { + "url": "https://platform.claude.com/docs/en/api/beta/user_profiles/create_enrollment_url", + "status": "success", + "path": "en/api/beta/user_profiles/create_enrollment_url.md", + "sha256": "0e0d18e49fcef63b99dea3f45df8cee8f04cbc84cffedc81a80cb9c3050c8b43", + "size": 1658 }, { "url": "https://platform.claude.com/docs/en/api/typescript/completions", "status": "success", "path": "en/api/typescript/completions.md", - "sha256": "86aa00f3c94a4098884794a043fe7f1a4258b6878b621ade740a3af76b1a73b9", - "size": 12090 + "sha256": "c3a4e6f18f8d30379663bfa910a4b4dea6638ddf3678ce62d7303b157c6ffcd6", + "size": 12168 }, { "url": "https://platform.claude.com/docs/en/api/typescript/completions/create", "status": "success", "path": "en/api/typescript/completions/create.md", - "sha256": "89b8d96565eeae3f4f177837fcccac80e6a55079934c0e805c4d2336520bd9b5", - "size": 9732 + "sha256": "6a5fabec438558c76d8eef437ac211e68f8655e7016f8ec225048d434f2d5069", + "size": 9810 }, { "url": "https://platform.claude.com/docs/en/api/typescript/messages", "status": "success", "path": "en/api/typescript/messages.md", - "sha256": "2f5fbb4b1ecbd29e7b2b37eeedda584e866e2b129c381e373b3f40f578df4d28", - "size": 834420 + "sha256": "fc4f6170bbec73dbdb30bc07792635b2e66575bee1ec026325c6df48fa47b7d2", + "size": 840569 }, { "url": "https://platform.claude.com/docs/en/api/typescript/messages/create", "status": "success", "path": "en/api/typescript/messages/create.md", - "sha256": "593517c5da01204bddaeee878300e056ba90f6d349a84170e6bcfb0430e8f13d", - "size": 120550 + "sha256": "4388da4bf4b129d7bf53309c1f1a48ebdf4db779a8ee0dd8f7782ccfef14fac9", + "size": 121078 }, { "url": "https://platform.claude.com/docs/en/api/typescript/messages/count_tokens", @@ -1310,8 +1359,8 @@ "url": "https://platform.claude.com/docs/en/api/typescript/messages/batches", "status": "success", "path": "en/api/typescript/messages/batches.md", - "sha256": "51a5b8663326c46edbf2448f1c5c309f758aaa9f2ab6ea8da9b79a0cda41e9f3", - "size": 221844 + "sha256": "299d6fcb97a4ea0a7d2db0fc95cee91692b3805c9b8c69e05cfc252b7b2fbd69", + "size": 224172 }, { "url": "https://platform.claude.com/docs/en/api/typescript/messages/batches/create", @@ -1352,267 +1401,309 @@ "url": "https://platform.claude.com/docs/en/api/typescript/messages/batches/results", "status": "success", "path": "en/api/typescript/messages/batches/results.md", - "sha256": "8f791f32f30210d8376084213d5bbe0bc1fcdbad336040175eaa843fc121841f", - "size": 26232 + "sha256": "7b46f643f5c2a52fb7d51181cae3fcebb175e4de235a3d2cc2069bcb477f6b5c", + "size": 26832 }, { "url": "https://platform.claude.com/docs/en/api/typescript/models", "status": "success", "path": "en/api/typescript/models.md", - "sha256": "9e44983edc64ba97fb3660fc047a9393f6026ed4dcb1f3b660f967041eb1ac96", - "size": 23107 + "sha256": "bb205f61bf328904b8d3903f45782a94e685a5f13bd799ef95d7a2ff55ac7d72", + "size": 23255 }, { "url": "https://platform.claude.com/docs/en/api/typescript/models/list", "status": "success", "path": "en/api/typescript/models/list.md", - "sha256": "8fd952bf67aca35ce174d4bfe65ba537b2b31450172392029505380af16aa56f", - "size": 6434 + "sha256": "f2b9c02a90fec89fa3a086f0a965002473802dbef5b59f09d2577acc46026d38", + "size": 6508 }, { "url": "https://platform.claude.com/docs/en/api/typescript/models/retrieve", "status": "success", "path": "en/api/typescript/models/retrieve.md", - "sha256": "ed5c9820efb5d1dd6b82aa1e38afca04024c8f6ea72fda4d7ce6dc86c06e9e8c", - "size": 5976 + "sha256": "4f3cc381ef7ccc98386b65238c2845d2c6eba7b5b73c65de58193982b9d4d18a", + "size": 6050 }, { "url": "https://platform.claude.com/docs/en/api/typescript/beta", "status": "success", "path": "en/api/typescript/beta.md", - "sha256": "58070a55a1c584b2663367e0bc6a68f26d5dd95d4e6e068386cec7f02ad2e3c4", - "size": 1095028 + "sha256": "a0894f076ae7564a06bc6c114cd227144d88301a8655b01df23967350ce762d2", + "size": 1121295 }, { "url": "https://platform.claude.com/docs/en/api/typescript/beta/models", "status": "success", "path": "en/api/typescript/beta/models.md", - "sha256": "581ad656040bccc365cc2432176952d66d6d5420c672496a84ed5cad77375c91", - "size": 23586 + "sha256": "9905ee8d39832b6e3976b13ae13e88c8b8d8522a47a8a68de2bc12bfd453b441", + "size": 23734 }, { "url": "https://platform.claude.com/docs/en/api/typescript/beta/models/list", "status": "success", "path": "en/api/typescript/beta/models/list.md", - "sha256": "7a7073d079a00741fb009bb8af37b88adc5327b01ba321a2c1bb4849b7e5adb1", - "size": 6540 + "sha256": "b6f8b02fc55828aecb12a1620156fe414e4d056f7f71e1944fc1943293be013c", + "size": 6614 }, { "url": "https://platform.claude.com/docs/en/api/typescript/beta/models/retrieve", "status": "success", "path": "en/api/typescript/beta/models/retrieve.md", - "sha256": "687864a0e2ec11bc79eb8160f825cc4a2b4c0d1ddb35f34ebbdd6a2d8a450766", - "size": 6082 + "sha256": "2d57558c0e24310642126a93b98a69d882c41a4ad2fc3e54ebcfe3662d65d3b9", + "size": 6156 }, { "url": "https://platform.claude.com/docs/en/api/typescript/beta/messages", "status": "success", "path": "en/api/typescript/beta/messages.md", - "sha256": "7922e00b2b3c85ba225ac526ffa449e7170e5764d37a35147e9014290e61e5a4", - "size": 1034374 + "sha256": "b57cdb575db97c6742afb9a13abf83ad4bac7c0b8520a24fdb04fd4d584207af", + "size": 1041514 }, { "url": "https://platform.claude.com/docs/en/api/typescript/beta/messages/create", "status": "success", "path": "en/api/typescript/beta/messages/create.md", - "sha256": "62fd353e68a500463525072b9b293a9e43620fdeb0e8fe0ab93d5ff58046ed4f", - "size": 151576 + "sha256": "6d036ecd707125b395f6689b883842e19bfab103b17b979ec9f3d701e1898a0c", + "size": 152363 }, { "url": "https://platform.claude.com/docs/en/api/typescript/beta/messages/count_tokens", "status": "success", "path": "en/api/typescript/beta/messages/count_tokens.md", - "sha256": "bfe5e89c2643280b43afcbf29940c97f183b27cbbf167d2385a1f847b8615c32", - "size": 114708 + "sha256": "29b8c2aae9b19b725048ef31888264d9a0bde0fb891191691b8dd2326cc1628a", + "size": 114782 }, { "url": "https://platform.claude.com/docs/en/api/typescript/beta/messages/batches", "status": "success", "path": "en/api/typescript/beta/messages/batches.md", - "sha256": "75bb3709d44577508e7d2faccee907eee686bea42f1e934e0ff46c42d1741fcc", - "size": 285468 + "sha256": "cc041e336ae57820894a42eb6c73f7234f4523b65346aa09c942e5f274512c7f", + "size": 288425 }, { "url": "https://platform.claude.com/docs/en/api/typescript/beta/messages/batches/create", "status": "success", "path": "en/api/typescript/beta/messages/batches/create.md", - "sha256": "12dbdb67bce570aed2c1692c090f8bd110462e2ce6417def77030215e5b9c245", - "size": 131075 + "sha256": "6a5c85e1e8035892ef7961539f97d493e91f4e9050bd1ad59dd2ea651e3c3178", + "size": 131318 }, { "url": "https://platform.claude.com/docs/en/api/typescript/beta/messages/batches/retrieve", "status": "success", "path": "en/api/typescript/beta/messages/batches/retrieve.md", - "sha256": "d2e0e10a8cc340a550a1ac8b19466a633d1b4dc956252c4921d39aaf7e54f2b2", - "size": 4735 + "sha256": "69074a74be215b9ea4939f2db29d9317f09a0fa662a939f7b8ca7ed538bf051f", + "size": 4809 }, { "url": "https://platform.claude.com/docs/en/api/typescript/beta/messages/batches/list", "status": "success", "path": "en/api/typescript/beta/messages/batches/list.md", - "sha256": "a98b63290ad12c3baac4dff67311296ddc41aff0edfba6b95ea26cdbb1cc7486", - "size": 5056 + "sha256": "e90ac1c58cd82ae51d94d83ceb69bfc15829102218e0a86c5c135a0911f7ac55", + "size": 5130 }, { "url": "https://platform.claude.com/docs/en/api/typescript/beta/messages/batches/cancel", "status": "success", "path": "en/api/typescript/beta/messages/batches/cancel.md", - "sha256": "e6f93dcdfba17df08cb709ec5825632a0382b1c1fd54fe61ab5fdfcd2722c6a4", - "size": 5043 + "sha256": "7bab1ae3086de09d28c49c87ef3f7becf28d19d3fbdd4b74686598ec9bfe70bf", + "size": 5117 }, { "url": "https://platform.claude.com/docs/en/api/typescript/beta/messages/batches/delete", "status": "success", "path": "en/api/typescript/beta/messages/batches/delete.md", - "sha256": "fdffeb516753cdf7732dfd6064f17ae282bff078a84ce895fd693bbec48f3a1f", - "size": 2197 + "sha256": "c011dad0e5718f22226631962b4e8a10b629c008ed51d73de372580c4fcf256b", + "size": 2271 }, { "url": "https://platform.claude.com/docs/en/api/typescript/beta/messages/batches/results", "status": "success", "path": "en/api/typescript/beta/messages/batches/results.md", - "sha256": "b0f7d71a3909fadc6de681ac13e161b564b5e2e7f1def146c7e29d3b147db768", - "size": 36147 + "sha256": "cf6ffdc486238b6a25bedd1f9f60739082b4cd4ab2fc526eee7ac8d45ebf53ee", + "size": 36825 }, { "url": "https://platform.claude.com/docs/en/api/typescript/beta/files", "status": "success", "path": "en/api/typescript/beta/files.md", - "sha256": "6579b22f3e20de06d27770a6e67283ef56d661e53adad0aaad3fd852bb2ecf87", - "size": 11177 + "sha256": "bd27307c62fa1f6ce78b044a71c9ff4d83427dc08a827e34366f5b256776f756", + "size": 11547 }, { "url": "https://platform.claude.com/docs/en/api/typescript/beta/files/upload", "status": "success", "path": "en/api/typescript/beta/files/upload.md", - "sha256": "73e35ea7715295fdda615959d816c036603b1305ed6f000baebc9b8858fd7657", - "size": 2169 + "sha256": "d4e4090121a934a5104667093bdb7fca8cfb9ee2c25166cea5949ed773edd857", + "size": 2243 }, { "url": "https://platform.claude.com/docs/en/api/typescript/beta/files/list", "status": "success", "path": "en/api/typescript/beta/files/list.md", - "sha256": "3d856d23e85a610a6005e936d9ba7dd013dddbdd7676e2dc2772d9acb27eb3ec", - "size": 2583 + "sha256": "8f3864a0d343bb18bd3c3fc64500b30319cdff06dab1c77eb599010e89af8fee", + "size": 2657 }, { "url": "https://platform.claude.com/docs/en/api/typescript/beta/files/download", "status": "success", "path": "en/api/typescript/beta/files/download.md", - "sha256": "60d77c77456c4f116ee97ce4afc5f90bba0200e78203ac1efa7555020b81ff79", - "size": 1657 + "sha256": "17fe55152e649aa40107afafd79c319c59fadc05fe44c6aa0346f09ef5e13da3", + "size": 1731 }, { "url": "https://platform.claude.com/docs/en/api/typescript/beta/files/retrieve_metadata", "status": "success", "path": "en/api/typescript/beta/files/retrieve_metadata.md", - "sha256": "d34b61c5b1b8e7a7f83de93a3019cb0b03cc1eb2e48b971f14938d3c34e0806d", - "size": 2179 + "sha256": "e582dbb4eab92d5457f947360014927a60fe5a50609f0d4fd91caceb6fce3b11", + "size": 2253 }, { "url": "https://platform.claude.com/docs/en/api/typescript/beta/files/delete", "status": "success", "path": "en/api/typescript/beta/files/delete.md", - "sha256": "705952ef0428ee3107f6efa392174e45407289030e66f482e22185f220f3a7e3", - "size": 1757 + "sha256": "7cac6a05c2eac6a556945b2c207c41f48761a8a5b4b32ad4992e5b19b1e2715d", + "size": 1831 }, { "url": "https://platform.claude.com/docs/en/api/typescript/beta/skills", "status": "success", "path": "en/api/typescript/beta/skills.md", - "sha256": "694095920dfa828be48ee85f5d39132e79ed9786df9ce43c3f5b487a65a50223", - "size": 21252 + "sha256": "4e8f14b094682f9b5ed8b058bc784aaeb4bf577dd60611c2ccd95df846d9cee7", + "size": 28316 }, { "url": "https://platform.claude.com/docs/en/api/typescript/beta/skills/create", "status": "success", "path": "en/api/typescript/beta/skills/create.md", - "sha256": "17b3b4c44418f47775bd8e8cca04b78911c43acc74b929f2441d4cdaf3fcfa34", - "size": 2793 + "sha256": "e0eeb1db457cd6362c5732fa13de6f6bfc91f6a26006ad6c6fa7b8b6681d31b3", + "size": 2867 }, { "url": "https://platform.claude.com/docs/en/api/typescript/beta/skills/list", "status": "success", "path": "en/api/typescript/beta/skills/list.md", - "sha256": "91fd7284ca7f476477251221ae174b1ee39abb6661150652963ebfa6cfe878a4", - "size": 3070 + "sha256": "000f1ce237972c0d27d6b6183dc5949947b4843331104040c59fe5aaf8b5e474", + "size": 3144 }, { "url": "https://platform.claude.com/docs/en/api/typescript/beta/skills/retrieve", "status": "success", "path": "en/api/typescript/beta/skills/retrieve.md", - "sha256": "119e21c811f2b162d60a40bb260a3dcc8dde591de407879aa26bb537f6e8afe1", - "size": 2556 + "sha256": "b5a93189097faadfd629e603b673ff7c735adb9cf750c0c80ec49ecd6462e929", + "size": 2630 }, { "url": "https://platform.claude.com/docs/en/api/typescript/beta/skills/delete", "status": "success", "path": "en/api/typescript/beta/skills/delete.md", - "sha256": "e5e3761ea41b5cb8224442524852b7b1131800da0460572a23258224e40d53df", - "size": 1868 + "sha256": "c2ef5cd187a7ed2cd0081bf5109518b985f2a1952b03e78767ed15015ef9b094", + "size": 1942 }, { "url": "https://platform.claude.com/docs/en/api/typescript/beta/skills/versions", "status": "success", "path": "en/api/typescript/beta/skills/versions.md", - "sha256": "0066e97a508f5ca2a2131b52a5e5dcd4e80b4ec2859c22dfcf1855c7a565b724", - "size": 10951 + "sha256": "22f8450eb84a5d0421309929a23dc677ac45d5dfd6256c50b122f00d39923839", + "size": 14618 }, { "url": "https://platform.claude.com/docs/en/api/typescript/beta/skills/versions/create", "status": "success", "path": "en/api/typescript/beta/skills/versions/create.md", - "sha256": "4344a164581d53cad534c466a9a6e3172c172802edcc3ae2dd55baf30c74f333", - "size": 2883 + "sha256": "bc59c6ab0a4ebee2410b843a491910862b57518bfa02076d38b33ab7f7998519", + "size": 2957 }, { "url": "https://platform.claude.com/docs/en/api/typescript/beta/skills/versions/list", "status": "success", "path": "en/api/typescript/beta/skills/versions/list.md", - "sha256": "aaafe9fa4ad9705751363159fab00f7e470fcc0fbc8c9b1e7935b4aea843436e", - "size": 3001 + "sha256": "156005e2ac083058987d298a02a646a8baed9e443ecce3bfc51de2fa5717d397", + "size": 3075 }, { "url": "https://platform.claude.com/docs/en/api/typescript/beta/skills/versions/retrieve", "status": "success", "path": "en/api/typescript/beta/skills/versions/retrieve.md", - "sha256": "137a4b13ebb5330da7b22cc3334734b0aa6d33a15ee5dfe150d14803157cb4fc", - "size": 2881 + "sha256": "bc1d1cea1e728474cb47c462248e26ee68a0054833c6c4fee2d3a46493bddf1a", + "size": 2955 }, { "url": "https://platform.claude.com/docs/en/api/typescript/beta/skills/versions/delete", "status": "success", "path": "en/api/typescript/beta/skills/versions/delete.md", - "sha256": "308612f48d9b50edddc0612f2c438a8349c13cf6d094256d3a6ce9c7c068eefb", - "size": 2171 + "sha256": "c6fdb5801d1a6b3195e3a5387d63bd6a2bf2c6d4c103f52ffb5654917f2968f5", + "size": 2245 + }, + { + "url": "https://platform.claude.com/docs/en/api/typescript/beta/user_profiles", + "status": "success", + "path": "en/api/typescript/beta/user_profiles.md", + "sha256": "3ad2a44879e7dd5c6b1844312edd2ec0eeee0d1ae87758d44d257f4232fec00b", + "size": 11474 + }, + { + "url": "https://platform.claude.com/docs/en/api/typescript/beta/user_profiles/create", + "status": "success", + "path": "en/api/typescript/beta/user_profiles/create.md", + "sha256": "fb063f616bc8da71754117172860dcc0484624ab0a7f2e070d3fa852defa7767", + "size": 2251 + }, + { + "url": "https://platform.claude.com/docs/en/api/typescript/beta/user_profiles/list", + "status": "success", + "path": "en/api/typescript/beta/user_profiles/list.md", + "sha256": "22cece3a2f52b2db49abc45d69f5ff84996fcd2b6fa31955ede5bd4a5cc89b3a", + "size": 2267 + }, + { + "url": "https://platform.claude.com/docs/en/api/typescript/beta/user_profiles/retrieve", + "status": "success", + "path": "en/api/typescript/beta/user_profiles/retrieve.md", + "sha256": "e016ebb736cae7a8515daf853f95bb6f362bbe927e1c905a8819dff0a5560c3c", + "size": 1999 + }, + { + "url": "https://platform.claude.com/docs/en/api/typescript/beta/user_profiles/update", + "status": "success", + "path": "en/api/typescript/beta/user_profiles/update.md", + "sha256": "525eaa21bc2232ac6725a7979a2bc123bd3a3737b5831999471fa632aa68c994", + "size": 2376 + }, + { + "url": "https://platform.claude.com/docs/en/api/typescript/beta/user_profiles/create_enrollment_url", + "status": "success", + "path": "en/api/typescript/beta/user_profiles/create_enrollment_url.md", + "sha256": "e3a89df43ea995924e93a200ee8ab9e8fb7bfe5fe28a1c55c185cec7e0a1f14a", + "size": 1914 }, { "url": "https://platform.claude.com/docs/en/api/python/completions", "status": "success", "path": "en/api/python/completions.md", - "sha256": "f49d56a90ff1e67b5cf13d4ca0c515caa39c507438221b496cb919b550a04f78", - "size": 15378 + "sha256": "7d9e0f7b0bdccc3d6018c5ae4ef9a5b79b72d8315968d3d7bffaffdeb574aeab", + "size": 15442 }, { "url": "https://platform.claude.com/docs/en/api/python/completions/create", "status": "success", "path": "en/api/python/completions/create.md", - "sha256": "1b3162653890d5dd905db2d08fad013a4f1f0c522dbb7a3c07db6dbeaa0f633e", - "size": 11501 + "sha256": "a6d5ed3b0d58b1a6a104c9dd331a774433d8d1fdd4e5c29043d83553d4863992", + "size": 11565 }, { "url": "https://platform.claude.com/docs/en/api/python/messages", "status": "success", "path": "en/api/python/messages.md", - "sha256": "88cc0c316d9687704e7465461492e54dd0e56dd992f90785b5380128ceeefb27", - "size": 861016 + "sha256": "6d2228f3767cc55c4d6d381fa00a2fbb81b1e8aec7f6061480d69b9c2e6b26c2", + "size": 867414 }, { "url": "https://platform.claude.com/docs/en/api/python/messages/create", "status": "success", "path": "en/api/python/messages/create.md", - "sha256": "34a8d5aae81659b9f944c7ec8dc21b5745c08bd7d890dd43184ff584bae6d145", - "size": 118784 + "sha256": "89d7762d3c783b56a9759e2e93002294de6724d0c98be9627b7ae9eead11b5e7", + "size": 119329 }, { "url": "https://platform.claude.com/docs/en/api/python/messages/count_tokens", @@ -1625,15 +1716,15 @@ "url": "https://platform.claude.com/docs/en/api/python/messages/batches", "status": "success", "path": "en/api/python/messages/batches.md", - "sha256": "286719c2b103d142f2a4498cb48cddee7385693b0a61e634473659c2759c5fac", - "size": 230903 + "sha256": "8a2128ab4986ebecff44b11ff506d7abae32c1b7e311009b0222bea91f8d9436", + "size": 233317 }, { "url": "https://platform.claude.com/docs/en/api/python/messages/batches/create", "status": "success", "path": "en/api/python/messages/batches/create.md", - "sha256": "53b1beda789827ab4de40acd75dd63cacfbf5f1d18649ad422500580e2c6ec98", - "size": 108477 + "sha256": "62852e117b399d73da052d7f0f610f5924dac0462ba3e28c333df2795998239f", + "size": 108471 }, { "url": "https://platform.claude.com/docs/en/api/python/messages/batches/retrieve", @@ -1667,267 +1758,309 @@ "url": "https://platform.claude.com/docs/en/api/python/messages/batches/results", "status": "success", "path": "en/api/python/messages/batches/results.md", - "sha256": "937aa4cce57fc08bddac93bc3b244bbe57fa3989fa9786dd0e8d14e1fcf52af3", - "size": 28193 + "sha256": "58be8ffb4c6a2bc1d15287f5211d2eef049daa068139eb19f9a17bda135c3020", + "size": 28816 }, { "url": "https://platform.claude.com/docs/en/api/python/models", "status": "success", "path": "en/api/python/models.md", - "sha256": "f3f85ab4c9a9d1ec75209d0d3539bd45c0c06cf7d4adb069cfa5df7225c77481", - "size": 22671 + "sha256": "09f716822cdf4b1bbef632c88a19c0ca27043d50a363fe2618ebf0a6e56d10a2", + "size": 22811 }, { "url": "https://platform.claude.com/docs/en/api/python/models/list", "status": "success", "path": "en/api/python/models/list.md", - "sha256": "ddeab3a0eb1655cde175dc2261b25e2b3751a0b8a087baa9a9685307b47fee98", - "size": 6185 + "sha256": "a9dac0f74d273aec3a9a8bbb901c523ac07469377056fbab4c6bedc61af7ab7a", + "size": 6255 }, { "url": "https://platform.claude.com/docs/en/api/python/models/retrieve", "status": "success", "path": "en/api/python/models/retrieve.md", - "sha256": "4c6ea69df924e00caf36d9e97b89d6ca44e7cfab492473075f6673fdcb958dde", - "size": 5830 + "sha256": "cd8844a34c43c65c0ec327b126350fb92e0f5e0829c971ce798a4914e1e6ef0f", + "size": 5900 }, { "url": "https://platform.claude.com/docs/en/api/python/beta", "status": "success", "path": "en/api/python/beta.md", - "sha256": "79ef0c88e320ea65c2cfb54f570aac80dac8db76d8b9cd00b98a65892f32bf18", - "size": 1115838 + "sha256": "bf661345da428258d1713754258e4898d6888dd7786b610e91dd24ff37a060de", + "size": 1141294 }, { "url": "https://platform.claude.com/docs/en/api/python/beta/models", "status": "success", "path": "en/api/python/beta/models.md", - "sha256": "45a22661e913b573675d1fdf7592446a3d035be4b3cd6c1d3152047ce716b911", - "size": 23144 + "sha256": "25b6631528efcfa7947a4e0de005a8aedff680b80f1197dd7b114323e23f7939", + "size": 23284 }, { "url": "https://platform.claude.com/docs/en/api/python/beta/models/list", "status": "success", "path": "en/api/python/beta/models/list.md", - "sha256": "e6f434b090158a83a7d9f12d05ed702aa391d1e35f656f4424548be81e041998", - "size": 6283 + "sha256": "eb4ad02e164fc363b195e84b0e012efcf2ec0b4846bc8d490e92e79a164f0c7d", + "size": 6353 }, { "url": "https://platform.claude.com/docs/en/api/python/beta/models/retrieve", "status": "success", "path": "en/api/python/beta/models/retrieve.md", - "sha256": "60c568e389987ee520428c78002a4b67718a45fae4b7c6df01f06d4564b037a5", - "size": 5938 + "sha256": "fb5634f9e0bdb64b252e172bc5e5793576b167800eb6156bfc9025791e0224dc", + "size": 6008 }, { "url": "https://platform.claude.com/docs/en/api/python/beta/messages", "status": "success", "path": "en/api/python/beta/messages.md", - "sha256": "53f517e4916e25d66e3791a778029c0ad3dcd6d337398732e06a893125c0474a", - "size": 1057333 + "sha256": "9af1ad1a19bf2a258ce86fb4f96ce17882a46338658226477df00a9bb7d7c355", + "size": 1064660 }, { "url": "https://platform.claude.com/docs/en/api/python/beta/messages/create", "status": "success", "path": "en/api/python/beta/messages/create.md", - "sha256": "4c238e92d9afb6d65528fb432c523dc004fc259e6b15117bfe476b58340d5b68", - "size": 148270 + "sha256": "a24c4e1befe9e9da1a7574ef52ad9720bccb1a7ed2e84c493529993b637f59c6", + "size": 149045 }, { "url": "https://platform.claude.com/docs/en/api/python/beta/messages/count_tokens", "status": "success", "path": "en/api/python/beta/messages/count_tokens.md", - "sha256": "128a3f5b2dd8692f1e6799bb7fca95b0377606eb40651fa47ef816ca1614e8f7", - "size": 115205 + "sha256": "2ada295308b73bc56ca9c5d29dfdbe667296923adb76612e8084d31c7b4150af", + "size": 115275 }, { "url": "https://platform.claude.com/docs/en/api/python/beta/messages/batches", "status": "success", "path": "en/api/python/beta/messages/batches.md", - "sha256": "841fedd3a5efb07841e6c3fc59fa26ed57ca914f91bb7b7eff7a3166e1da04cb", - "size": 293971 + "sha256": "d177901d881f2aa11d7d3d6b74f800d2aa994a3563e2864d848e4c9db69796af", + "size": 296985 }, { "url": "https://platform.claude.com/docs/en/api/python/beta/messages/batches/create", "status": "success", "path": "en/api/python/beta/messages/batches/create.md", - "sha256": "3143e4dc5364c7127d3e1cc7430a6e7a67e3e128bf23f8df23dcbf58bd901e3c", - "size": 131873 + "sha256": "fda5bebd8d3c6f233a593773af1619e26fe6a8058ba9611a1e3a3aa9d165a1cd", + "size": 132101 }, { "url": "https://platform.claude.com/docs/en/api/python/beta/messages/batches/retrieve", "status": "success", "path": "en/api/python/beta/messages/batches/retrieve.md", - "sha256": "517fe145d3b675f2a9da5c371e5205e9b71b8aa82a84bf47a1512a2ba9802817", - "size": 4655 + "sha256": "e64fee6dfb88bb40186c4964dcd87b194ae481a7a501294c9aae1236f80e2236", + "size": 4725 }, { "url": "https://platform.claude.com/docs/en/api/python/beta/messages/batches/list", "status": "success", "path": "en/api/python/beta/messages/batches/list.md", - "sha256": "682721dd9d7a7c59ba96c9479ed0abe07d89f176dd05cf757dd7c2bba0ef3c9b", - "size": 4847 + "sha256": "334d1f6983f58d27e2978584e8f1d6a7f9fc199bfe4921b8adbab00b0ee36a73", + "size": 4917 }, { "url": "https://platform.claude.com/docs/en/api/python/beta/messages/batches/cancel", "status": "success", "path": "en/api/python/beta/messages/batches/cancel.md", - "sha256": "f8a3faa297ffd83bb6b9fae7511f5d8d40605ea581ef67a84fac74d39ed929af", - "size": 4965 + "sha256": "9597153ad24ffcd0e595f341cffbc8dc71f76bfbdf485f2e698c81099d520c20", + "size": 5035 }, { "url": "https://platform.claude.com/docs/en/api/python/beta/messages/batches/delete", "status": "success", "path": "en/api/python/beta/messages/batches/delete.md", - "sha256": "87ed4d808ec63aadf02bcc88172f5099ead759ec4309ff293ede258daf73c1b9", - "size": 2110 + "sha256": "9164efd8d3df730ed6ab5dbb09e50d084c09ed20c338e80552f5ad9b8dc0efa5", + "size": 2180 }, { "url": "https://platform.claude.com/docs/en/api/python/beta/messages/batches/results", "status": "success", "path": "en/api/python/beta/messages/batches/results.md", - "sha256": "a91e17e2c621e58d0e8bb7da047f0501c96a29484d0ebd8cd7713a3436487c6a", - "size": 38073 + "sha256": "c4c33ae312c60a4a362cae87ea049f092ec9517e4039fc2defd3b9a139efb0ee", + "size": 38770 }, { "url": "https://platform.claude.com/docs/en/api/python/beta/files", "status": "success", "path": "en/api/python/beta/files.md", - "sha256": "22d70cc1403db65e8d88477c3eac64c5d599099730c466644cb1462b1178c59c", - "size": 10508 + "sha256": "1340804bc87f66ac44bb739f0ac60dd4a55ea6f375eedbe020706b4a53575d0d", + "size": 10858 }, { "url": "https://platform.claude.com/docs/en/api/python/beta/files/upload", "status": "success", "path": "en/api/python/beta/files/upload.md", - "sha256": "b6858e7075e7e20da48f4aa7e32b2ec79f143bb0e8b06ddeaa06879017819dfe", - "size": 2008 + "sha256": "a825a89332f9da3970b5dceae3a3838d914f18b25f4e3fc81ac1a3ff65e5d4bc", + "size": 2078 }, { "url": "https://platform.claude.com/docs/en/api/python/beta/files/list", "status": "success", "path": "en/api/python/beta/files/list.md", - "sha256": "1dade284d5f61b9fb03f5eaee7da5b398031d23dd14cec10f0d4514f58f05ad8", - "size": 2371 + "sha256": "5cf946fa05f1e7c5b8009eba25016bd47fe58e619f85965d4fe09e9e490454b6", + "size": 2441 }, { "url": "https://platform.claude.com/docs/en/api/python/beta/files/download", "status": "success", "path": "en/api/python/beta/files/download.md", - "sha256": "f13ade7f31feccf801ecf8b6e3c82e32594a721a8695f04fa7243ee93270335c", - "size": 1521 + "sha256": "d749f9f5e073fe464d703fb744ef3bad631f38fd8f63d49a6614460ebd564691", + "size": 1591 }, { "url": "https://platform.claude.com/docs/en/api/python/beta/files/retrieve_metadata", "status": "success", "path": "en/api/python/beta/files/retrieve_metadata.md", - "sha256": "f2156364b20ace90abc587cb36ebc79be14d4c5285026e724ebe1a92ae8cee41", - "size": 2069 + "sha256": "2dee0f5a621a6cf0381ff736e080afdbe8774ff575d42fe99a8ee675fae007dc", + "size": 2139 }, { "url": "https://platform.claude.com/docs/en/api/python/beta/files/delete", "status": "success", "path": "en/api/python/beta/files/delete.md", - "sha256": "0baf48e9206afbc6107627305a6aec1f7b0e1c85d41f196f2b9b10fc53dc00b3", - "size": 1665 + "sha256": "2c7f56ba4582bf4aa150c7468f6e051db7d51db5f26dbf9a7166b8d8b967536a", + "size": 1735 }, { "url": "https://platform.claude.com/docs/en/api/python/beta/skills", "status": "success", "path": "en/api/python/beta/skills.md", - "sha256": "6e4fe3ef826b396eb367e12aae76d2202a8d7616073ad266f626c5ce03de261b", - "size": 19833 + "sha256": "5f8a903d4e8e42053c6fbbdb2b3e9ee70d25b783c05aadbe525e9a0fd207fc6b", + "size": 26812 }, { "url": "https://platform.claude.com/docs/en/api/python/beta/skills/create", "status": "success", "path": "en/api/python/beta/skills/create.md", - "sha256": "46c6d5b36bd7fb7ed92599fa60d1633bd6a47e7e5b4bf571ab6c47372978f3ea", - "size": 2616 + "sha256": "d2efeafa149a06a154bc6e254872339dd99f898917f4b7ac1c2fae7f6105ddad", + "size": 2680 }, { "url": "https://platform.claude.com/docs/en/api/python/beta/skills/list", "status": "success", "path": "en/api/python/beta/skills/list.md", - "sha256": "15c42c4aa221b11cfc4ec3de2a14486e77856c48d2b471e64152628487ebe002", - "size": 2805 + "sha256": "c4ebd42c04f780a128205df33e29e95c658a11ea08ca2bde53f3b3656b0ff9b1", + "size": 2875 }, { "url": "https://platform.claude.com/docs/en/api/python/beta/skills/retrieve", "status": "success", "path": "en/api/python/beta/skills/retrieve.md", - "sha256": "dccbb734cd635e0861a7562d09e5f64842c95e083b06bb9ab68bbde828bc3a56", - "size": 2430 + "sha256": "ae33c90427d1b975db5f7ea345dad30bd1425889410e5c43378c3edd02c071eb", + "size": 2500 }, { "url": "https://platform.claude.com/docs/en/api/python/beta/skills/delete", "status": "success", "path": "en/api/python/beta/skills/delete.md", - "sha256": "2bf37319aa595faae4d32231ff8cf5225d2ac16a75d4bd6ebd154097478914b9", - "size": 1753 + "sha256": "35e74b9c89f37406053f2932ee15abebe2ddc9ab717d0e7ff38d32bdb860d79c", + "size": 1823 }, { "url": "https://platform.claude.com/docs/en/api/python/beta/skills/versions", "status": "success", "path": "en/api/python/beta/skills/versions.md", - "sha256": "4f6c900c7d325c5c5ecd053db936bac75399bd37b83046c1c1bd68b4e3a9125e", - "size": 10215 + "sha256": "35db706d65535f789f0260d1a5a50f891bd7563ac8263549726feef26bd3f9b9", + "size": 13826 }, { "url": "https://platform.claude.com/docs/en/api/python/beta/skills/versions/create", "status": "success", "path": "en/api/python/beta/skills/versions/create.md", - "sha256": "ccdf0f1e81c9705884bc06c8e3af5072f96a7492b0c51dc035e02d764269c72a", - "size": 2726 + "sha256": "2add11e637f68875c3e055878fdba0e5a7218eb4142b3e89c54f2ffb70a47c6f", + "size": 2790 }, { "url": "https://platform.claude.com/docs/en/api/python/beta/skills/versions/list", "status": "success", "path": "en/api/python/beta/skills/versions/list.md", - "sha256": "75ea599e613466767825e6a66dbc5f9669d17bb0f747e486c2de3540160d32df", - "size": 2752 + "sha256": "97ca5d6d566293ef6da1c0544ee3ff7f82a6ed9f0364dadc92c527ad8a485910", + "size": 2822 }, { "url": "https://platform.claude.com/docs/en/api/python/beta/skills/versions/retrieve", "status": "success", "path": "en/api/python/beta/skills/versions/retrieve.md", - "sha256": "562212d728e6109d9ae7ce5d4a3fb6520f15f0a43df323128c7997fa8d6f2366", - "size": 2706 + "sha256": "6d3e2e6c054b2adf3e4b37ffc6893d01dfd548d884e15f6446f6b2811004cb73", + "size": 2776 }, { "url": "https://platform.claude.com/docs/en/api/python/beta/skills/versions/delete", "status": "success", "path": "en/api/python/beta/skills/versions/delete.md", - "sha256": "ea4b6f8f13759793a9531e55f237605278c6648312e3e8aef335145111c70d34", - "size": 2016 + "sha256": "85eee7f9031f994b58ca91deb5f70ca749111ae810f65a1502d9eaafbe6cf217", + "size": 2086 + }, + { + "url": "https://platform.claude.com/docs/en/api/python/beta/user_profiles", + "status": "success", + "path": "en/api/python/beta/user_profiles.md", + "sha256": "336b13663820ea5e051ad2091b66bd515f821600932a790bbd3737cdeb14c297", + "size": 10589 + }, + { + "url": "https://platform.claude.com/docs/en/api/python/beta/user_profiles/create", + "status": "success", + "path": "en/api/python/beta/user_profiles/create.md", + "sha256": "93f69bbec96df09274185dda11a57a2f0ada14cc0149b6087acee0f57b5b48ff", + "size": 2060 + }, + { + "url": "https://platform.claude.com/docs/en/api/python/beta/user_profiles/list", + "status": "success", + "path": "en/api/python/beta/user_profiles/list.md", + "sha256": "6b63681ced10ed5826d4fafa4b5f1ec3c2310af912e535f0f7922e8baad65ca9", + "size": 2025 + }, + { + "url": "https://platform.claude.com/docs/en/api/python/beta/user_profiles/retrieve", + "status": "success", + "path": "en/api/python/beta/user_profiles/retrieve.md", + "sha256": "11905b3075f3836f3dc34934fff883915a9151c8293257fa2ba91913a88a99f6", + "size": 1857 + }, + { + "url": "https://platform.claude.com/docs/en/api/python/beta/user_profiles/update", + "status": "success", + "path": "en/api/python/beta/user_profiles/update.md", + "sha256": "ea5373607ed6c032b7f89181b274a12ea43668abd402227b6e3bdb97bfa753db", + "size": 2189 + }, + { + "url": "https://platform.claude.com/docs/en/api/python/beta/user_profiles/create_enrollment_url", + "status": "success", + "path": "en/api/python/beta/user_profiles/create_enrollment_url.md", + "sha256": "28aa9359e5a53bbe77db1a6d835944481e0b0fa5feb75400d1f65fcaabb818a4", + "size": 1784 }, { "url": "https://platform.claude.com/docs/en/api/java/completions", "status": "success", "path": "en/api/java/completions.md", - "sha256": "84d724d36e120d66010788ca012199c7b9dc8127620e15454181d198092a2b95", - "size": 10343 + "sha256": "094172215ca0cb3be34c83e0127af8c95363c63365eb4ba55f5f2f2ee055b354", + "size": 10463 }, { "url": "https://platform.claude.com/docs/en/api/java/completions/create", "status": "success", "path": "en/api/java/completions/create.md", - "sha256": "cdf7c4fc5fd4acf83fc79a889ded912274b1f5a851fd0e6409d0e0aee4300880", - "size": 7788 + "sha256": "fd3bff7322dc0f78c98c160e80ffdc895a1cce5722362fd02760ffa83128e855", + "size": 7908 }, { "url": "https://platform.claude.com/docs/en/api/java/messages", "status": "success", "path": "en/api/java/messages.md", - "sha256": "747a9514f290a89e38829bea1e836dbc73515f465632ec3e7313e423b4e57ecf", - "size": 912525 + "sha256": "f2c77cd02fceec0065b341846e2620ec610a56c4054abe61b142feed2d3def48", + "size": 919087 }, { "url": "https://platform.claude.com/docs/en/api/java/messages/create", "status": "success", "path": "en/api/java/messages/create.md", - "sha256": "41d3ba35256fac19913068a360e89749b72154dc287dff0e547be2d7161535f5", - "size": 121957 + "sha256": "31053f1e246ece648883755c5d493da0adb22357523109f957b49e6cdda8b698", + "size": 122522 }, { "url": "https://platform.claude.com/docs/en/api/java/messages/count_tokens", @@ -1940,8 +2073,8 @@ "url": "https://platform.claude.com/docs/en/api/java/messages/batches", "status": "success", "path": "en/api/java/messages/batches.md", - "sha256": "f8d4b3c6ada759057c8d8fc2e80cc44e10eb0593934fc5a81603d80963552bc9", - "size": 245838 + "sha256": "8fec18621022ffb1cbab40f0f10c0f0ba47bc155fa1d04d462b84ab8b89b26f9", + "size": 248314 }, { "url": "https://platform.claude.com/docs/en/api/java/messages/batches/create", @@ -1982,267 +2115,309 @@ "url": "https://platform.claude.com/docs/en/api/java/messages/batches/results", "status": "success", "path": "en/api/java/messages/batches/results.md", - "sha256": "ff9212eb1afddd2de299b3b0c4f53239f60f3afda9a216938539ad4ee04767c3", - "size": 29835 + "sha256": "2b7d45a99474a2e7ec57ab7ab3bb27e58575a0017b53834353b71d4fa3274030", + "size": 30472 }, { "url": "https://platform.claude.com/docs/en/api/java/models", "status": "success", "path": "en/api/java/models.md", - "sha256": "e588256f0bb955423debfe433b030a54727fdefdb14dca96b07bbfd2cc75344f", - "size": 24242 + "sha256": "fbeaf7ac96e5a6e39d87659c132e8953288d149b2a167ab1127cb4e1fc39100e", + "size": 24482 }, { "url": "https://platform.claude.com/docs/en/api/java/models/list", "status": "success", "path": "en/api/java/models/list.md", - "sha256": "52111c6539173c96a522bee04854c6283bbff151b3c0bf5b287d574affc9df30", - "size": 6967 + "sha256": "50cdfdf1b1a5eb9577a77cffa7644aca1fccf2bbb72e0d52a0e5bbb5cc442570", + "size": 7087 }, { "url": "https://platform.claude.com/docs/en/api/java/models/retrieve", "status": "success", "path": "en/api/java/models/retrieve.md", - "sha256": "dae6568f1fbc407d34dcc0005e48a45f260b9792333d09f0ea8a70549df135d7", - "size": 6605 + "sha256": "e783d88a291934cd7c2421abf17b0adb8b0a3fd41d0acff11aef4564e1f24826", + "size": 6725 }, { "url": "https://platform.claude.com/docs/en/api/java/beta", "status": "success", "path": "en/api/java/beta.md", - "sha256": "368a02873ba587bc74c0257ea247a3a31c56084cc6c3302213e25dfdd7ca4a92", - "size": 1182587 + "sha256": "0d2c16b59c9e1f321b93462d9548bad8061b2bc9845c68f3f70bf2a28f6994b6", + "size": 1207081 }, { "url": "https://platform.claude.com/docs/en/api/java/beta/models", "status": "success", "path": "en/api/java/beta/models.md", - "sha256": "15ff4e736e6f066c8108f4e1a0f2efccdff6c9f6a6b5c7d67e75f7460116eb9d", - "size": 24741 + "sha256": "e6795265860633374e0516d76819656472ae5f1adbbb9f578d04ab386ba23775", + "size": 24981 }, { "url": "https://platform.claude.com/docs/en/api/java/beta/models/list", "status": "success", "path": "en/api/java/beta/models/list.md", - "sha256": "8cfe02cdc4aa41c7c5b5cd19c925078906bb6cb77c486432f5c5b6ad6c9dbf79", - "size": 7075 + "sha256": "cab2d4602dcab3b625f8bb55220d6bb66e46fa41643a834d06d644782d8697e8", + "size": 7195 }, { "url": "https://platform.claude.com/docs/en/api/java/beta/models/retrieve", "status": "success", "path": "en/api/java/beta/models/retrieve.md", - "sha256": "730be50928f50899594ffd2758531aa5b908279d418ae661f489edf564ab8c53", - "size": 6729 + "sha256": "0d076cd83d56fc0a88e10796c58a3243a80fed93a3b39aa74c42ab242978a1c2", + "size": 6849 }, { "url": "https://platform.claude.com/docs/en/api/java/beta/messages", "status": "success", "path": "en/api/java/beta/messages.md", - "sha256": "79997530aea901cfe0dec04ce8949222507e527c761c108e4411ce615b1cb1be", - "size": 1112100 + "sha256": "2161e74f6399f81669a499549d87ff240587fcb732814136ada4e942701a234e", + "size": 1119999 }, { "url": "https://platform.claude.com/docs/en/api/java/beta/messages/create", "status": "success", "path": "en/api/java/beta/messages/create.md", - "sha256": "2efdddf77cccccd1942d4b3d1950d43c4165ed35de1ae8cf6a6f9a5990f7fa94", - "size": 150284 + "sha256": "9f6c66f81e399757404ddfd6a055992ffbe5a1caa741fadc01d67c1aa7ee4a43", + "size": 151133 }, { "url": "https://platform.claude.com/docs/en/api/java/beta/messages/count_tokens", "status": "success", "path": "en/api/java/beta/messages/count_tokens.md", - "sha256": "d18e6aa139d6c7cb5c0618d86b7413b02cf668b1eef12b6e3f3b6805c23fe3d8", - "size": 116695 + "sha256": "f044d2ecd009cc1a996bc1bf60a77e3bee52254aaac7e021ee8bd6dcf36a986d", + "size": 116815 }, { "url": "https://platform.claude.com/docs/en/api/java/beta/messages/batches", "status": "success", "path": "en/api/java/beta/messages/batches.md", - "sha256": "dea11cfd8b7e88c02307e29a7d5eb9b6d9f7bbc53398453d638b722ab278af68", - "size": 313026 + "sha256": "aeac9b26458820441ecfcb37ac53c84dce651c09fbe95d18199b6c23c0f4e071", + "size": 316406 }, { "url": "https://platform.claude.com/docs/en/api/java/beta/messages/batches/create", "status": "success", "path": "en/api/java/beta/messages/batches/create.md", - "sha256": "fd23f0e51caca30f5053ab1ab5b27becfbff6050def9560d5c5717df6cd9e63d", - "size": 141874 + "sha256": "cf7e1791a139105925b08b16044b4c89644d08fcb3677d13f655bff01a11141f", + "size": 142162 }, { "url": "https://platform.claude.com/docs/en/api/java/beta/messages/batches/retrieve", "status": "success", "path": "en/api/java/beta/messages/batches/retrieve.md", - "sha256": "457213a5bd13bcc87492f63527d80184a25e23a8126d74aa180e45bc09455fa6", - "size": 5472 + "sha256": "c265b929ed6a0d6ad00de81812d02d5d8e7c2b6473352a6c110b9bc9a5b07d71", + "size": 5592 }, { "url": "https://platform.claude.com/docs/en/api/java/beta/messages/batches/list", "status": "success", "path": "en/api/java/beta/messages/batches/list.md", - "sha256": "5e575cd0c298976fc45aec2f4e2c48af016ef2c404035dc72ad272951ede5c14", - "size": 5676 + "sha256": "6c70571ebb5051939a1301640bf63f352337165c7b8b0e7677922cd59b854602", + "size": 5796 }, { "url": "https://platform.claude.com/docs/en/api/java/beta/messages/batches/cancel", "status": "success", "path": "en/api/java/beta/messages/batches/cancel.md", - "sha256": "e9e6cdc79acb653bd0d6401e5729dc592638365ee12d44659990ffb3cf9c561a", - "size": 5776 + "sha256": "de25b9555672c29c6e1d883d7f6a819344da0e48db5b3a52fd05ab31869b2f8c", + "size": 5896 }, { "url": "https://platform.claude.com/docs/en/api/java/beta/messages/batches/delete", "status": "success", "path": "en/api/java/beta/messages/batches/delete.md", - "sha256": "0473be596c2a09d206879ccebabce2891b98d1928c6464fe42f1d3d74e357967", - "size": 2920 + "sha256": "2edfbf0efa5528511a256a52dde839cc3fddf05ab6988bdc1c3975eb9d09a77d", + "size": 3040 }, { "url": "https://platform.claude.com/docs/en/api/java/beta/messages/batches/results", "status": "success", "path": "en/api/java/beta/messages/batches/results.md", - "sha256": "69a1c373e806d31d7684171288ac7c2639b75bbee94cacfab876f48537cec5f1", - "size": 40160 + "sha256": "9222cd0fb25a91bdad32c60be3eef5dc93920b4112bf8d4c832c935108e79619", + "size": 40921 }, { "url": "https://platform.claude.com/docs/en/api/java/beta/files", "status": "success", "path": "en/api/java/beta/files.md", - "sha256": "7eca26b694f48e31b174d4d035661b8e204e7dd2bf16466711292677dff07e7a", - "size": 14485 + "sha256": "a360e5431c518dd98b4a5604d9a52e64b1404566f199fed42ba120d4878fdb91", + "size": 15089 }, { "url": "https://platform.claude.com/docs/en/api/java/beta/files/upload", "status": "success", "path": "en/api/java/beta/files/upload.md", - "sha256": "af127d32eb04a46b6b6cd37649d0acb4df4c01636f1538a8b374f949374212a7", - "size": 2943 + "sha256": "60d0f8ff35b8541035fe43f300fab84e3e6b5653858113023136e828e7d6b197", + "size": 3067 }, { "url": "https://platform.claude.com/docs/en/api/java/beta/files/list", "status": "success", "path": "en/api/java/beta/files/list.md", - "sha256": "9a473bdf199a34f81e1f7829045a390c2936ec15a15ea2af5d27d631686532ee", - "size": 3156 + "sha256": "1db339de8db95d6b5517f69ffc0d84deca7afe78e93c3c52ba67db7308081dd0", + "size": 3276 }, { "url": "https://platform.claude.com/docs/en/api/java/beta/files/download", "status": "success", "path": "en/api/java/beta/files/download.md", - "sha256": "614868da40b532cd927f3c77811f07bf305267b840240224f695788d5dbd1e3f", - "size": 2201 + "sha256": "74472ae26d5130936ef6c73cb9445ed611059a6ac1d06b780ba3bd4e9a4de7d7", + "size": 2321 }, { "url": "https://platform.claude.com/docs/en/api/java/beta/files/retrieve_metadata", "status": "success", "path": "en/api/java/beta/files/retrieve_metadata.md", - "sha256": "b04c2f9fa687e364629d2ac30543bfea4d605383ad62913538fb2b65b8995f49", - "size": 2880 + "sha256": "bea2c6095eb02dcb0f66c176e6a2b18249f06e2030d65251360c8130176a35a0", + "size": 3000 }, { "url": "https://platform.claude.com/docs/en/api/java/beta/files/delete", "status": "success", "path": "en/api/java/beta/files/delete.md", - "sha256": "8430685dcdd72fd0a5198eee1171641286e42b6fc14a034785cf6803c1a757b9", - "size": 2419 + "sha256": "92dfca5a9c737757ab31de30f94f3275afc36655b9d91601d65be47a5fdcc063", + "size": 2539 }, { "url": "https://platform.claude.com/docs/en/api/java/beta/skills", "status": "success", "path": "en/api/java/beta/skills.md", - "sha256": "d64c0b11849cecdb6cd4a6d3c865e1aff52ae341a34bae7962896a2c2dd71ab7", - "size": 26506 + "sha256": "c712267b317f71f0489f905a9436dbce9e1d1a629164a6c97b09eb27dcac799c", + "size": 27466 }, { "url": "https://platform.claude.com/docs/en/api/java/beta/skills/create", "status": "success", "path": "en/api/java/beta/skills/create.md", - "sha256": "ecb72ab8e4feee0f7c981a3f1c91267b2a37c6d59f81f7eb9d5232db11c09189", - "size": 3424 + "sha256": "53326ceebeaba8a3c6f09dad26acd3ea2666788e14ce2122d57bbe68f1e618da", + "size": 3544 }, { "url": "https://platform.claude.com/docs/en/api/java/beta/skills/list", "status": "success", "path": "en/api/java/beta/skills/list.md", - "sha256": "f079765adb2ce48e3089b84d5d2b57384a251a2076966cdf2a7c5a4ae7133206", - "size": 3583 + "sha256": "f3bfbbe9e5f625ab29a45d1f715f2978865a32c72c3f02fc9a518280968ea738", + "size": 3703 }, { "url": "https://platform.claude.com/docs/en/api/java/beta/skills/retrieve", "status": "success", "path": "en/api/java/beta/skills/retrieve.md", - "sha256": "41ce54ad4daf4326dfb0dd0cb63852cb9349cbff7a6ae9f575219b6fa6e76199", - "size": 3237 + "sha256": "484f3e112c5b0e7d27328dc8b5f1178bd352cc10163606fc5f19c31b55234d46", + "size": 3357 }, { "url": "https://platform.claude.com/docs/en/api/java/beta/skills/delete", "status": "success", "path": "en/api/java/beta/skills/delete.md", - "sha256": "07206f72b310c0d18293b7a694d46ef80679d9afc37f47967537c4c4e13c9c07", - "size": 2544 + "sha256": "3a6e8a84c857209f40866a9936a13c5f0d96d58f19e1498c5e52122032b1d604", + "size": 2664 }, { "url": "https://platform.claude.com/docs/en/api/java/beta/skills/versions", "status": "success", "path": "en/api/java/beta/skills/versions.md", - "sha256": "928697c1de24023c880720413d5ff8f861c0a66d7a5c4441fe2da542d1cec9c5", - "size": 13704 + "sha256": "0bbe5cd2714ca58cd003416ba35f1986ad56671c35a055a38ce02fd2dd5e02d3", + "size": 14184 }, { "url": "https://platform.claude.com/docs/en/api/java/beta/skills/versions/create", "status": "success", "path": "en/api/java/beta/skills/versions/create.md", - "sha256": "9739c6e7461cf9293465ce937833437f89273d56166d632717c510bc367182d7", - "size": 3549 + "sha256": "7c218ca01f1e191947806c711c7495117ee640b4f070c67810c650e4235940cc", + "size": 3669 }, { "url": "https://platform.claude.com/docs/en/api/java/beta/skills/versions/list", "status": "success", "path": "en/api/java/beta/skills/versions/list.md", - "sha256": "4aa5dd395266ae9bab0e7b0be64bdf6c3c09fa82c6e6efb4a58802923499c868", - "size": 3540 + "sha256": "62b78395c4b77606a57b6ace75a45ae399abfbb5a678adcd29f5212b9ab11ee5", + "size": 3660 }, { "url": "https://platform.claude.com/docs/en/api/java/beta/skills/versions/retrieve", "status": "success", "path": "en/api/java/beta/skills/versions/retrieve.md", - "sha256": "1f974142eba3cf3e735f905ac7dbb1d52a10099553f00ada57d304b28a84f28e", - "size": 3656 + "sha256": "76a25bf9bcfcdd406891b0b960c59779987c5771aff8727fe25f3d56cc0e0759", + "size": 3776 }, { "url": "https://platform.claude.com/docs/en/api/java/beta/skills/versions/delete", "status": "success", "path": "en/api/java/beta/skills/versions/delete.md", - "sha256": "84ee1e26050025a84d5a31d60f5313be1ea1cd1882b6c5ba3e831c9c5be469d2", - "size": 2944 + "sha256": "107e78e5d518b798f145cf990574d3bfb89587b07e3c99d6a98afa94cdc15a43", + "size": 3064 + }, + { + "url": "https://platform.claude.com/docs/en/api/java/beta/user_profiles", + "status": "success", + "path": "en/api/java/beta/user_profiles.md", + "sha256": "047bbee9504f26847da9da62280fe7777ca7233eea56d0d7f7cd21ae05f60c34", + "size": 14790 + }, + { + "url": "https://platform.claude.com/docs/en/api/java/beta/user_profiles/create", + "status": "success", + "path": "en/api/java/beta/user_profiles/create.md", + "sha256": "73b6c3f3f91b7294fbf9b47b0994e7df719aec670a00931a174a5887030eec78", + "size": 2894 + }, + { + "url": "https://platform.claude.com/docs/en/api/java/beta/user_profiles/list", + "status": "success", + "path": "en/api/java/beta/user_profiles/list.md", + "sha256": "5f84fb66814fd8056515b57800b7f2e6595641100ee083869b1ad89b5917ea14", + "size": 2853 + }, + { + "url": "https://platform.claude.com/docs/en/api/java/beta/user_profiles/retrieve", + "status": "success", + "path": "en/api/java/beta/user_profiles/retrieve.md", + "sha256": "825bda62fce2272ab0f8a812cdd2207883783802ad7293987566d69667a10402", + "size": 2694 + }, + { + "url": "https://platform.claude.com/docs/en/api/java/beta/user_profiles/update", + "status": "success", + "path": "en/api/java/beta/user_profiles/update.md", + "sha256": "4b99c3c6145279edc006185a3a38a3d5b269d62b658f73cf17062a1faad2baa5", + "size": 3020 + }, + { + "url": "https://platform.claude.com/docs/en/api/java/beta/user_profiles/create_enrollment_url", + "status": "success", + "path": "en/api/java/beta/user_profiles/create_enrollment_url.md", + "sha256": "cbb373297c7ec30601fd81587524219d251c467f8e643065d569aded9e7b637c", + "size": 2679 }, { "url": "https://platform.claude.com/docs/en/api/go/completions", "status": "success", "path": "en/api/go/completions.md", - "sha256": "739d469da5805170bfe873c8b3525471a08e47630b60571fd924fd0955424a83", - "size": 11967 + "sha256": "59503fde3d089d8c31a585ec37e7d9a968bb086b8c5d79bf1b6167bfbae2e2e6", + "size": 12155 }, { "url": "https://platform.claude.com/docs/en/api/go/completions/create", "status": "success", "path": "en/api/go/completions/create.md", - "sha256": "9182b4296dd148bf2dedaea38a9368b9b49db3f8104cced0ebcf09e7d94a6882", - "size": 8903 + "sha256": "98366cf044bf37a7106a634d608eea40268e6a76690db9a167bb9ea8dca4c744", + "size": 9091 }, { "url": "https://platform.claude.com/docs/en/api/go/messages", "status": "success", "path": "en/api/go/messages.md", - "sha256": "bb8ee5cf99fb9807c6aff57331827ba42315f4dd3d7fcc365d1edbe2b95d4366", - "size": 1089040 + "sha256": "6d1291b8603e7b94434e0e780d5713b94dd2aecf1adaeaba04526127bb0ad064", + "size": 1096821 }, { "url": "https://platform.claude.com/docs/en/api/go/messages/create", "status": "success", "path": "en/api/go/messages/create.md", - "sha256": "a0571b595c14ccc350bf8143fbf3ee10e44608a5703ed73345153ea9f5fb8b4b", - "size": 143537 + "sha256": "5fb6c4c9c3fc29ab14ff97f9283eca5d305c8dc2a8758913d92f2a1fa8851853", + "size": 144211 }, { "url": "https://platform.claude.com/docs/en/api/go/messages/count_tokens", @@ -2255,8 +2430,8 @@ "url": "https://platform.claude.com/docs/en/api/go/messages/batches", "status": "success", "path": "en/api/go/messages/batches.md", - "sha256": "2084f5e59363711e94b8d606fbc8e69745f7fa0dd95fbd29348c3f6f46803d80", - "size": 284837 + "sha256": "5c8b47fd2e2822f217b6354f095171a6f8282579241227758b94c081df16b976", + "size": 287749 }, { "url": "https://platform.claude.com/docs/en/api/go/messages/batches/create", @@ -2297,267 +2472,309 @@ "url": "https://platform.claude.com/docs/en/api/go/messages/batches/results", "status": "success", "path": "en/api/go/messages/batches/results.md", - "sha256": "308abd687b70832d50a85d1bef35d71e13a19b6046fe9560fb036a715016f7f2", - "size": 35063 + "sha256": "b5bac6e09cb6a028f9b7589d991bfee2b8c1f1e305c06f0972d05797bfd1f4fb", + "size": 35809 }, { "url": "https://platform.claude.com/docs/en/api/go/models", "status": "success", "path": "en/api/go/models.md", - "sha256": "1562870227269b6fe85d76dad680e87a6ef4660e4a362830015e4237a36ce98e", - "size": 25042 + "sha256": "8429d69a3e857638d74963033564d3104fa3ec06f3754301c7bb323c7e11ad1e", + "size": 25418 }, { "url": "https://platform.claude.com/docs/en/api/go/models/list", "status": "success", "path": "en/api/go/models/list.md", - "sha256": "2440ffab41403c7ca1fb137c9378f887c0342eca1215f474e300760f2751a881", - "size": 7505 + "sha256": "0571cba13a2b7b09a3333076375a0e9a94f4f6f97621a9f7753ae6ddc8fe6fb8", + "size": 7693 }, { "url": "https://platform.claude.com/docs/en/api/go/models/retrieve", "status": "success", "path": "en/api/go/models/retrieve.md", - "sha256": "6db9ea460581229c664f095840b08385262fc297805e38025050f7bfd6d83311", - "size": 7080 + "sha256": "4fae89ea093a5ac46adb98381f662d0010731ea837272548b219296d57795a5b", + "size": 7268 }, { "url": "https://platform.claude.com/docs/en/api/go/beta", "status": "success", "path": "en/api/go/beta.md", - "sha256": "737d69185191ae30890384bb2c45897fb33e205a3d117f39cf56d5c2bbf36133", - "size": 1415477 + "sha256": "295bc3032061a29ede1a9a790c82fbce4c0448500d1efe5002b5a238da629dac", + "size": 1446713 }, { "url": "https://platform.claude.com/docs/en/api/go/beta/models", "status": "success", "path": "en/api/go/beta/models.md", - "sha256": "a50d5023070b835e8df218f44b40a5f9b688c0304c9620ce11e2ac88e44fdc81", - "size": 25529 + "sha256": "a31b5605ca82acc356637db766f8e57504f780ceb94317b6bb2d701234067429", + "size": 25905 }, { "url": "https://platform.claude.com/docs/en/api/go/beta/models/list", "status": "success", "path": "en/api/go/beta/models/list.md", - "sha256": "dea5f9010f1eca33350e0d51f7b7e3cbdf6c1a458913b72f72d645ef7403b766", - "size": 7611 + "sha256": "c35ceecb048ec8cc89a97329245d2e0b62725266aaa31093d21d2e5bb92e216d", + "size": 7799 }, { "url": "https://platform.claude.com/docs/en/api/go/beta/models/retrieve", "status": "success", "path": "en/api/go/beta/models/retrieve.md", - "sha256": "42f040b9e2f6a5c86f33781edcb3987f20ff0f9a50801843557e7ca43800107c", - "size": 7194 + "sha256": "38de992f281de9b94b74e3c695e25e8697d1bfa40a0dbdfd557d11d0195673c0", + "size": 7382 }, { "url": "https://platform.claude.com/docs/en/api/go/beta/messages", "status": "success", "path": "en/api/go/beta/messages.md", - "sha256": "d195645a62035c755da984f5dd81b661567e1af98eb8c84baaaa600b38b21547", - "size": 1333863 + "sha256": "ab2aa648632ebcb7024104766475165a2dc329d332876f73c0dbf9500f17419b", + "size": 1343750 }, { "url": "https://platform.claude.com/docs/en/api/go/beta/messages/create", "status": "success", "path": "en/api/go/beta/messages/create.md", - "sha256": "a36eeff9511081991c53ae398ba861dc5ef9fdc347574b2e1adc7ffc96f69d08", - "size": 179265 + "sha256": "17e11f7a7332ccc7b0b65868c169bea1a522a1901a35aced7a6d7eeb732f9f6d", + "size": 180326 }, { "url": "https://platform.claude.com/docs/en/api/go/beta/messages/count_tokens", "status": "success", "path": "en/api/go/beta/messages/count_tokens.md", - "sha256": "9b72fc492e1bd39ea9b7672d5abfb1fdd1549cdded204d2f17f958d7d7ca8db2", - "size": 138989 + "sha256": "ce94bbc4f02380f7272ba21a278bcfb2ba911d4788e2f561974c2bb72263e3f2", + "size": 139177 }, { "url": "https://platform.claude.com/docs/en/api/go/beta/messages/batches", "status": "success", "path": "en/api/go/beta/messages/batches.md", - "sha256": "98b6dae9a1fa8dbf1f51d92fc4d581ee46b33a23833843c67dc86ea18cbbff58", - "size": 367171 + "sha256": "038b0cbf3157bf93aa192fde1d89a608705bf5588c02985e1f2f295022ab3104", + "size": 371465 }, { "url": "https://platform.claude.com/docs/en/api/go/beta/messages/batches/create", "status": "success", "path": "en/api/go/beta/messages/batches/create.md", - "sha256": "3becffce9acf2010b7b1840dc76a27a6b74a2536a7b38bfdaffba3180637c3b5", - "size": 165658 + "sha256": "b76ff8f6927fb70fd0404eb026f52075ca5c3861b7700ca4fd7bd54a274e1b17", + "size": 166004 }, { "url": "https://platform.claude.com/docs/en/api/go/beta/messages/batches/retrieve", "status": "success", "path": "en/api/go/beta/messages/batches/retrieve.md", - "sha256": "12c715fbd1e55f9d7c201487c56ad7ab4f537f964d3d3025a88d39a63a5e8f3e", - "size": 6215 + "sha256": "70a3f4f19f8373adbc15ff880511cf4f655ea7854f3b5b04b220f46685e7d790", + "size": 6403 }, { "url": "https://platform.claude.com/docs/en/api/go/beta/messages/batches/list", "status": "success", "path": "en/api/go/beta/messages/batches/list.md", - "sha256": "712b2315361d7270bcd4ccc65bbbb54fbace38f3837f78c6b8c5fce40172dd65", - "size": 6489 + "sha256": "685b56ad69475cbd5c0df3730cee15bc6f19a2be8a9b835934846e32eae147f1", + "size": 6677 }, { "url": "https://platform.claude.com/docs/en/api/go/beta/messages/batches/cancel", "status": "success", "path": "en/api/go/beta/messages/batches/cancel.md", - "sha256": "c542c2fcb3de87bb579afe478c38a09e8f9f70071ec2e5279b39f3f2c70c2954", - "size": 6541 + "sha256": "c06f7f3a8b2467c5d0304322c4b0449a3af95886c68688a91fb56b085fe8d06c", + "size": 6729 }, { "url": "https://platform.claude.com/docs/en/api/go/beta/messages/batches/delete", "status": "success", "path": "en/api/go/beta/messages/batches/delete.md", - "sha256": "38a178b87e85de7c60579edfcd80cd522afea0d48deb7c86e001995a5c21ab40", - "size": 3539 + "sha256": "d9876fd6c2f63fc91fc61f6731f56b84b425be29e5142f2d794071b35f5d9151", + "size": 3727 }, { "url": "https://platform.claude.com/docs/en/api/go/beta/messages/batches/results", "status": "success", "path": "en/api/go/beta/messages/batches/results.md", - "sha256": "664fd4800dab6e7ba276b0a0f4fbb1a42dc3a04a08ed176aee3ab3a65db94743", - "size": 47357 + "sha256": "7af2d1e8802469198d061892b91f112997b15f9c235b08e60cf33d3c38b714a5", + "size": 48315 }, { "url": "https://platform.claude.com/docs/en/api/go/beta/files", "status": "success", "path": "en/api/go/beta/files.md", - "sha256": "5de0ea755b6fe81075a4938dae51ec3ee4eec9a68e9c81c2777099cb54c3ebf9", - "size": 17553 + "sha256": "77034cf1b8975999fcc63ba8c80dc48f64404f77cba17e2d78b1a2cbef48895a", + "size": 18493 }, { "url": "https://platform.claude.com/docs/en/api/go/beta/files/upload", "status": "success", "path": "en/api/go/beta/files/upload.md", - "sha256": "4f7828315169be62371563fb5cb41456e9d4b73b56c412aaa443610a48ec3727", - "size": 3471 + "sha256": "85b1f5eff0d948b4af355c743d779862c129095bf31b72dddb104dfa383ba92f", + "size": 3659 }, { "url": "https://platform.claude.com/docs/en/api/go/beta/files/list", "status": "success", "path": "en/api/go/beta/files/list.md", - "sha256": "52bc49ff5a03dfbd104e3d81f02c3c1f26a604d253d1d1fe6550b8c30889b52c", - "size": 3796 + "sha256": "7bdca38f109e5f5dfe67565b45cdea5347699282b3f0eadca6dab99dd5f08f75", + "size": 3984 }, { "url": "https://platform.claude.com/docs/en/api/go/beta/files/download", "status": "success", "path": "en/api/go/beta/files/download.md", - "sha256": "010f558f73e51105738bfce9dfeeaead48b27bb2a42713bf1052af18e2c90fd4", - "size": 2864 + "sha256": "9c042b40a520c63240db41f6efbb35b396075ed75e7a013a1d1b25e86b22e33b", + "size": 3052 }, { "url": "https://platform.claude.com/docs/en/api/go/beta/files/retrieve_metadata", "status": "success", "path": "en/api/go/beta/files/retrieve_metadata.md", - "sha256": "f15629b1117140d563e88f46bc943b5ccec357ce6cae404174df64a500dedbbb", - "size": 3431 + "sha256": "be297dfa313b64c74bd1c1669c08222cc22aa5169634b9552bedfcf5d01051e8", + "size": 3619 }, { "url": "https://platform.claude.com/docs/en/api/go/beta/files/delete", "status": "success", "path": "en/api/go/beta/files/delete.md", - "sha256": "863e79c31ac476a644d3b7d4117b01f9424f6d821f3eeb4e86320c976d605b2c", - "size": 3073 + "sha256": "9371ef05d6e7ed1471e9be3a6acb9d132f0f2232a42825916751432b80821a46", + "size": 3261 }, { "url": "https://platform.claude.com/docs/en/api/go/beta/skills", "status": "success", "path": "en/api/go/beta/skills.md", - "sha256": "a022ed1c2050f82efafc982cf0753ed9ba1e78dfa3f9e73311b39246b0265a7a", - "size": 31189 + "sha256": "caff12e86fc2bf24527eade364b0613a2f9e95d4f83b6d8cffa921bd355e3540", + "size": 32693 }, { "url": "https://platform.claude.com/docs/en/api/go/beta/skills/create", "status": "success", "path": "en/api/go/beta/skills/create.md", - "sha256": "8143ca5e7fe8aed6c62cfc6d0bbd1d42e8382ed5e66b00d144da0e9bfe1de21b", - "size": 4013 + "sha256": "b6b6318cea1688140935c3a9c865dddad70395d537ec4a69ae7bcc3f49770723", + "size": 4201 }, { "url": "https://platform.claude.com/docs/en/api/go/beta/skills/list", "status": "success", "path": "en/api/go/beta/skills/list.md", - "sha256": "fb545c84c6d48e96157f445d6725d4be947a9ebf884cf9af3c7348229f839191", - "size": 4241 + "sha256": "22626cc502ad898e57ff340d4604baa72ee4ea404ffa7ee56df4c309e5fd80e0", + "size": 4429 }, { "url": "https://platform.claude.com/docs/en/api/go/beta/skills/retrieve", "status": "success", "path": "en/api/go/beta/skills/retrieve.md", - "sha256": "2dbe925200056ea666f8ce71425a7c6f01e4fdd0903115de36d66a66789c45e2", - "size": 3778 + "sha256": "dd6337154a4c789d2350cdeb04234759cbfb1a79950856a9ebacc769810717ba", + "size": 3966 }, { "url": "https://platform.claude.com/docs/en/api/go/beta/skills/delete", "status": "success", "path": "en/api/go/beta/skills/delete.md", - "sha256": "a3938ea406aa531b087465253884f98b93a540f088ca51963344842bd15e92e7", - "size": 3141 + "sha256": "36c14b5c2a4ae46381766a65e5671d061cc5e517066deaea750a1294a4f6bdf9", + "size": 3329 }, { "url": "https://platform.claude.com/docs/en/api/go/beta/skills/versions", "status": "success", "path": "en/api/go/beta/skills/versions.md", - "sha256": "f247f1559eef34bc114a3833bae3b2d89cfb850cfc30191e6ce2307078ad9fd1", - "size": 16002 + "sha256": "9ca984a37b70d27f15d8a6dfb5b70d65968d2ef511f736c0f25b44016e779830", + "size": 16754 }, { "url": "https://platform.claude.com/docs/en/api/go/beta/skills/versions/create", "status": "success", "path": "en/api/go/beta/skills/versions/create.md", - "sha256": "a87dff03eccb16cdfe5155ad2be0ddff0237cd2441977daab491000a192ab3f5", - "size": 4149 + "sha256": "99013949cc614f798dd56d6436d3e8733b662d1cdce2ec5de2edb30b6bc806b1", + "size": 4337 }, { "url": "https://platform.claude.com/docs/en/api/go/beta/skills/versions/list", "status": "success", "path": "en/api/go/beta/skills/versions/list.md", - "sha256": "f13966d2a4b6122388e146aba635f82249aeb6b0a9282eb12bf141f7e64852ec", - "size": 4206 + "sha256": "86d26523fca63ec7b97d267675b815af883e9924e930f2e0d0f10a0e681d2cdf", + "size": 4394 }, { "url": "https://platform.claude.com/docs/en/api/go/beta/skills/versions/retrieve", "status": "success", "path": "en/api/go/beta/skills/versions/retrieve.md", - "sha256": "d5080978262a65eb1c76e45a1d278fa0316837c480a888d89e895735d5eee082", - "size": 4152 + "sha256": "6ccb63e1f62709d752e930e6cb8630a09631abd6830d27020469945adc8efde8", + "size": 4340 }, { "url": "https://platform.claude.com/docs/en/api/go/beta/skills/versions/delete", "status": "success", "path": "en/api/go/beta/skills/versions/delete.md", - "sha256": "5b4e9c5f3d91fe65528864c6ddeb5a30c4dada8c537fdcd7ee48cef27ef761ec", - "size": 3480 + "sha256": "7ff09f8a7f41c4acac851cbbe146b06f7958cf5bd5dcbce918568418c2c8d479", + "size": 3668 + }, + { + "url": "https://platform.claude.com/docs/en/api/go/beta/user_profiles", + "status": "success", + "path": "en/api/go/beta/user_profiles.md", + "sha256": "2c31f6bf798c5912c988e15b753b36c9a152fbaa54a9132067c6149817c11c1a", + "size": 18344 + }, + { + "url": "https://platform.claude.com/docs/en/api/go/beta/user_profiles/create", + "status": "success", + "path": "en/api/go/beta/user_profiles/create.md", + "sha256": "3ce254c211aaaa022f4d1df1fd4be14decd6f2304f9cccca21dc3863122de92e", + "size": 3592 + }, + { + "url": "https://platform.claude.com/docs/en/api/go/beta/user_profiles/list", + "status": "success", + "path": "en/api/go/beta/user_profiles/list.md", + "sha256": "c0923abe56005e88dbce50d291b4e04c6a4aed6f71eada040001fb12629f14c8", + "size": 3720 + }, + { + "url": "https://platform.claude.com/docs/en/api/go/beta/user_profiles/retrieve", + "status": "success", + "path": "en/api/go/beta/user_profiles/retrieve.md", + "sha256": "251e45eb64cd687037e607d2ea38f612fcb228235e275123461b68f644ea1e75", + "size": 3332 + }, + { + "url": "https://platform.claude.com/docs/en/api/go/beta/user_profiles/update", + "status": "success", + "path": "en/api/go/beta/user_profiles/update.md", + "sha256": "e13f9645942c208f8dc599c5a76f028a5db7f261d3194b3cffe89d75697a5150", + "size": 3743 + }, + { + "url": "https://platform.claude.com/docs/en/api/go/beta/user_profiles/create_enrollment_url", + "status": "success", + "path": "en/api/go/beta/user_profiles/create_enrollment_url.md", + "sha256": "6f92983fa847fbf6e2788383f886afa91a483764eff941e823ec38bcb7821f57", + "size": 3276 }, { "url": "https://platform.claude.com/docs/en/api/ruby/completions", "status": "success", "path": "en/api/ruby/completions.md", - "sha256": "877ad34c8b9cfed46d181955fe9b47a745146570b6ff0339fe657529733bfdaf", - "size": 11174 + "sha256": "55ab13d9e199c646e1ad2eb5f862ac9405e8c6b99e2cba79bd53dacc0375d189", + "size": 11246 }, { "url": "https://platform.claude.com/docs/en/api/ruby/completions/create", "status": "success", "path": "en/api/ruby/completions/create.md", - "sha256": "8739affa3159320ce08b64e0497500a789c8b8632fa987700dc348b394015604", - "size": 8651 + "sha256": "0d76f1a8265f52f42d6e64c26c73073181c92fa476102fc1e8a4875dc67d18f7", + "size": 8723 }, { "url": "https://platform.claude.com/docs/en/api/ruby/messages", "status": "success", "path": "en/api/ruby/messages.md", - "sha256": "6bbac70d17c13f5d5c40635b7766fdf10e19af06f357021957fbd4e888b6877e", - "size": 812658 + "sha256": "37e938263d1434bc91a13b99a593bc0119faa8c613dd40063183b5b3b49a97b7", + "size": 818551 }, { "url": "https://platform.claude.com/docs/en/api/ruby/messages/create", "status": "success", "path": "en/api/ruby/messages/create.md", - "sha256": "edac4b3d7eca5496d38f319461e100ce2c6340c29dfaaf80df01b2c8fb53db80", - "size": 111211 + "sha256": "50353a7a6f3a7ae5fc2e428ca476de9471b761d31ba0e4dc377fe49f32ca0353", + "size": 111712 }, { "url": "https://platform.claude.com/docs/en/api/ruby/messages/count_tokens", @@ -2570,8 +2787,8 @@ "url": "https://platform.claude.com/docs/en/api/ruby/messages/batches", "status": "success", "path": "en/api/ruby/messages/batches.md", - "sha256": "e156df051da8f0133158e0e943a1dc62aa781b8ebed0f4e22926bb10c1faf477", - "size": 216541 + "sha256": "2b77b0d9d97712781028e775a70da1ab3ec44a2c395f956fabedce250f454036", + "size": 218761 }, { "url": "https://platform.claude.com/docs/en/api/ruby/messages/batches/create", @@ -2612,1184 +2829,1352 @@ "url": "https://platform.claude.com/docs/en/api/ruby/messages/batches/results", "status": "success", "path": "en/api/ruby/messages/batches/results.md", - "sha256": "9b4067798051736d7b90fab767f7b2e20e6a07e066fd8b82fef5346a4c54db80", - "size": 26190 + "sha256": "4a9e660e591ce459cf1e867a094de078ceb981dbeb3ee1e99de1e5bfd398a631", + "size": 26763 }, { "url": "https://platform.claude.com/docs/en/api/ruby/models", "status": "success", "path": "en/api/ruby/models.md", - "sha256": "7e6f7cd990c26a805de3f6b0864420bc2643faf1ba6513ce28afca36f35c42d9", - "size": 22159 + "sha256": "60fc859dace3b5661822dcee745c7c2c2a82225250e397f3e6fb93c0f889a5da", + "size": 22303 }, { "url": "https://platform.claude.com/docs/en/api/ruby/models/list", "status": "success", "path": "en/api/ruby/models/list.md", - "sha256": "a4522b80f37075bde94d740910b1339f9a152e716d78933f900afd1f053a71ca", - "size": 5994 + "sha256": "4ced60416d908e8ef2286c95dad130abe68d352bbb78112b160c3c3b3762db4d", + "size": 6066 }, { "url": "https://platform.claude.com/docs/en/api/ruby/models/retrieve", "status": "success", "path": "en/api/ruby/models/retrieve.md", - "sha256": "2278214de3eea7fa02f970105aa1133b2beba55ca3be6fae35a73bae55f40b80", - "size": 5665 + "sha256": "11a3bcdf16cd009b2b45fc5f2d586a3c424dcb169e2c3c0edad117c485b4c1b0", + "size": 5737 }, { "url": "https://platform.claude.com/docs/en/api/ruby/beta", "status": "success", "path": "en/api/ruby/beta.md", - "sha256": "d8265e6c81344b800373f1804e01b361b395a468b3b33978bdc30c87f22aa7db", - "size": 1062768 + "sha256": "03af74df8881e2324e0def7af4ae51136e5819e33de75dd15f9a31c64caa2196", + "size": 1087233 }, { "url": "https://platform.claude.com/docs/en/api/ruby/beta/models", "status": "success", "path": "en/api/ruby/beta/models.md", - "sha256": "0409d9eee4d9a2ab627cd0dac4a3e24595bfaa5119e03ae02137b3b2cc1012e2", - "size": 22632 + "sha256": "14b821d04dc2699cccf9a840a03eda6e190970eec39e02cf317bf5921cb73d65", + "size": 22776 }, { "url": "https://platform.claude.com/docs/en/api/ruby/beta/models/list", "status": "success", "path": "en/api/ruby/beta/models/list.md", - "sha256": "f59631e4cb3b4a63e6fea712ed7debe193a1abf549c8d155e07fc0691e9ec620", - "size": 6092 + "sha256": "5dfe1f301ab8a05cc0e732961788e5738e8273775aa59f1e9c52a14c9fc9553f", + "size": 6164 }, { "url": "https://platform.claude.com/docs/en/api/ruby/beta/models/retrieve", "status": "success", "path": "en/api/ruby/beta/models/retrieve.md", - "sha256": "8bfd0f5ed402b40415660b87198e5c5ce16283fd40579306f3954b783372ed17", - "size": 5773 + "sha256": "071a384cb6b33691536c5b374bbe5b1c520e634929fb3e022a67c3a7cde719d9", + "size": 5845 }, { "url": "https://platform.claude.com/docs/en/api/ruby/beta/messages", "status": "success", "path": "en/api/ruby/beta/messages.md", - "sha256": "961b75b02e542ff72e03af2050d8673d1307a74765077c6d510c136d6ca48e0a", - "size": 1006553 + "sha256": "bceabf88487bbd9b50f4ca03464c82e35f90c02582e11993dd15d3b925a3ee5f", + "size": 1013377 }, { "url": "https://platform.claude.com/docs/en/api/ruby/beta/messages/create", "status": "success", "path": "en/api/ruby/beta/messages/create.md", - "sha256": "cf2170f2e621e8eea06afe4e3624c3a88ec7906d98210d9f91f9df7d05fea72f", - "size": 139751 + "sha256": "74cf23d6a9d566fb2513276b4a8c9dda33b47fe77f1fe0f077a95e53e1b165d3", + "size": 140477 }, { "url": "https://platform.claude.com/docs/en/api/ruby/beta/messages/count_tokens", "status": "success", "path": "en/api/ruby/beta/messages/count_tokens.md", - "sha256": "ddb11dc0411cf8edc80a9d618e5daaeb4a1dde9da12eb86b38d184b43662bfb1", - "size": 108659 + "sha256": "4abe48483ebee5f75c8935f171c51a82f95567765a92461db5f9de576ff5cdae", + "size": 108731 }, { "url": "https://platform.claude.com/docs/en/api/ruby/beta/messages/batches", "status": "success", "path": "en/api/ruby/beta/messages/batches.md", - "sha256": "5421e19687381ebfccbfe59224abd9fc8d69476e0259f3c47ee5548e348cbad0", - "size": 278251 + "sha256": "3d4f218a3a52ef503a206ccb6ad612f3e85be40aa8c72b8208df4f3cd4f2cd1d", + "size": 281076 }, { "url": "https://platform.claude.com/docs/en/api/ruby/beta/messages/batches/create", "status": "success", "path": "en/api/ruby/beta/messages/batches/create.md", - "sha256": "eb328bac9a9f7d8596cfa1f5618ea61cb864898698e84ca92d3c55668ac80381", - "size": 124994 + "sha256": "a0869ab7b1cd6dc36eada50fb1b50afd8e7199d3c02c67e2af3eb55922c0b977", + "size": 125223 }, { "url": "https://platform.claude.com/docs/en/api/ruby/beta/messages/batches/retrieve", "status": "success", "path": "en/api/ruby/beta/messages/batches/retrieve.md", - "sha256": "75ba16ec42254bdb6142fb8d1839beee21f9b48c684a03b8aeb61f703072911e", - "size": 4485 + "sha256": "566367f8552cea57741d1e9b847f72b2c1bea0fe588074e56f72b968236eee6c", + "size": 4557 }, { "url": "https://platform.claude.com/docs/en/api/ruby/beta/messages/batches/list", "status": "success", "path": "en/api/ruby/beta/messages/batches/list.md", - "sha256": "84ad9a7591c47d7199fe9359e2797ad1f57996ab57e4c4e8ad4987de5ff974e3", - "size": 4659 + "sha256": "5962d80833f8293b894b1af73c9f6e17cd82fb5135fd58f3be22d10a7a4835e1", + "size": 4731 }, { "url": "https://platform.claude.com/docs/en/api/ruby/beta/messages/batches/cancel", "status": "success", "path": "en/api/ruby/beta/messages/batches/cancel.md", - "sha256": "4f01bdba490e3356d81422581b0a913796221eda0161e85d2f97ba392cfd4ac5", - "size": 4797 + "sha256": "683cc517dec83b8c16243ce65696c6bb61168fe577a3737658b593cabacc8993", + "size": 4869 }, { "url": "https://platform.claude.com/docs/en/api/ruby/beta/messages/batches/delete", "status": "success", "path": "en/api/ruby/beta/messages/batches/delete.md", - "sha256": "2cb2052103eb42bf97ae4be36c199b69dd806011622f84ee61554cbded0b1bd4", - "size": 1992 + "sha256": "7dd803dad1195a75e9f23e40925ef5630813dd7aa0db98ad87e6b1de4aee8919", + "size": 2064 }, { "url": "https://platform.claude.com/docs/en/api/ruby/beta/messages/batches/results", "status": "success", "path": "en/api/ruby/beta/messages/batches/results.md", - "sha256": "2ca0a5e66c8433509b58b69f3fa0bda1ea81d1fde980588447ebc7b4da8553ac", - "size": 35949 + "sha256": "68f7fe20a12efb54b684ab327af5ab65fdf9c7f97b8cc9f8d07f84dd8fd9539d", + "size": 36598 }, { "url": "https://platform.claude.com/docs/en/api/ruby/beta/files", "status": "success", "path": "en/api/ruby/beta/files.md", - "sha256": "0eb58d88da679ee238e33d4b5f277fdb9cec97f4d3bc83d39077364f0e937cb4", - "size": 9833 + "sha256": "f28d82294b7e99f71a68cb54e8b609a4a22684039f370d52d9fc3f3dea5cca1a", + "size": 10193 }, { "url": "https://platform.claude.com/docs/en/api/ruby/beta/files/upload", "status": "success", "path": "en/api/ruby/beta/files/upload.md", - "sha256": "ade468de7c3baa093898c70df517862ad2787d7f58119cecd917fb80956d89eb", - "size": 1915 + "sha256": "c1f3e45e1485d2f976089416d85e3ae17273651bd1d0abeca6385f3ebcb368b4", + "size": 1987 }, { "url": "https://platform.claude.com/docs/en/api/ruby/beta/files/list", "status": "success", "path": "en/api/ruby/beta/files/list.md", - "sha256": "ce44fbc5c61ee2d1e16d8cb393dcc390270ca2320718582f6565264c2cada4ec", - "size": 2230 + "sha256": "31c6f205d0a6e7302c692668d9276d40583eacbd5b73d1bb430fd9d7b8268e4c", + "size": 2302 }, { "url": "https://platform.claude.com/docs/en/api/ruby/beta/files/download", "status": "success", "path": "en/api/ruby/beta/files/download.md", - "sha256": "7b2f7a85975c49199bcc87773f3a67ee3dbe4d11ecbd30ad05941b82d835c964", - "size": 1360 + "sha256": "b24ba891341b98acb90d1b241e4a3b0c37924551b6a8e1f8abc62f6ed8d27422", + "size": 1432 }, { "url": "https://platform.claude.com/docs/en/api/ruby/beta/files/retrieve_metadata", "status": "success", "path": "en/api/ruby/beta/files/retrieve_metadata.md", - "sha256": "e3a2683562cb923eeb23e095fc7a4165f2a634f8e6450937b63065fe735e2360", - "size": 1947 + "sha256": "bff45ef370f258a7bf1e0adea836d7e9f345cce68c74603f7c99ca6203af3bea", + "size": 2019 }, { "url": "https://platform.claude.com/docs/en/api/ruby/beta/files/delete", "status": "success", "path": "en/api/ruby/beta/files/delete.md", - "sha256": "cc6703f32129177395cd9381fda3727188ca9215e1e98dd340aa7950dfa2beef", - "size": 1547 + "sha256": "ebee7e937fcf30e5f1a5a0eba4fdad3e1f96ca6e5af7a7352d7808680408deeb", + "size": 1619 }, { "url": "https://platform.claude.com/docs/en/api/ruby/beta/skills", "status": "success", "path": "en/api/ruby/beta/skills.md", - "sha256": "6470a4a5cce2edb2a74486351a80faa33ba3e76bfb4197390d866f147832afb5", - "size": 18994 + "sha256": "204953f3172a3303e7d739724d53ad5d63430bb1c7448009c40ada6d25867ff2", + "size": 26048 }, { "url": "https://platform.claude.com/docs/en/api/ruby/beta/skills/create", "status": "success", "path": "en/api/ruby/beta/skills/create.md", - "sha256": "397208af18053a14d9a1d3d23b5fb4b8c3ca11bba5a23edcd090530e2264a349", - "size": 2500 + "sha256": "37b10923510435674ddb5cc2279e0e62066fd72a61a1bdea5d544392815a33c1", + "size": 2572 }, { "url": "https://platform.claude.com/docs/en/api/ruby/beta/skills/list", "status": "success", "path": "en/api/ruby/beta/skills/list.md", - "sha256": "8ed82ec7e7cf09da9ddb0bd19ea09f0da033d8760495e19b1c3e38e6a8cc50b2", - "size": 2676 + "sha256": "9fd3d3c58685134308468a6b508da42d6e3a663796ad507940f84bb89957dafe", + "size": 2748 }, { "url": "https://platform.claude.com/docs/en/api/ruby/beta/skills/retrieve", "status": "success", "path": "en/api/ruby/beta/skills/retrieve.md", - "sha256": "c713ff1023451c71d8b36091be27b3fc38f432fb1835605c1888655542a90dc5", - "size": 2327 + "sha256": "bc3c590734007f10202c10f349f92b6fa6fa3864f3a1c63005a048c62f8aa4e7", + "size": 2399 }, { "url": "https://platform.claude.com/docs/en/api/ruby/beta/skills/delete", "status": "success", "path": "en/api/ruby/beta/skills/delete.md", - "sha256": "09f01cb43f6d6ac33de5a4697dd866da95d7dab4b9a41bf649b32a4c0510cd39", - "size": 1657 + "sha256": "86cb76d854f1b05906285aa199bb28f96e60253b97ad103f734e0fb3dfdf1821", + "size": 1729 }, { "url": "https://platform.claude.com/docs/en/api/ruby/beta/skills/versions", "status": "success", "path": "en/api/ruby/beta/skills/versions.md", - "sha256": "8c6e9fcdeb087eb69e3dd759ba4ee2d1b5d547502b2d704f1a66ea86993fbaf3", - "size": 9820 + "sha256": "15dba608e8a8b57f89f444bdc573aee310d86ae7fece14e0b7fc10c7d7d7ad09", + "size": 13503 }, { "url": "https://platform.claude.com/docs/en/api/ruby/beta/skills/versions/create", "status": "success", "path": "en/api/ruby/beta/skills/versions/create.md", - "sha256": "fbdd355f1841c43c924fe01d1ef8b5bbd10a4e90fc0e9d50ef529c2094b2dcf5", - "size": 2624 + "sha256": "0c79efb2951d95feee19c4365cac8e24697519b4ae793fe4212cb4d58853beda", + "size": 2696 }, { "url": "https://platform.claude.com/docs/en/api/ruby/beta/skills/versions/list", "status": "success", "path": "en/api/ruby/beta/skills/versions/list.md", - "sha256": "01d1859a34047813f51dc23fd1601b2750cb87f6c15c1856d7891802198a5464", - "size": 2637 + "sha256": "b8c696d598618b3106b16c0c9c6cda506825acbf05616b8cf335f788cde19375", + "size": 2709 }, { "url": "https://platform.claude.com/docs/en/api/ruby/beta/skills/versions/retrieve", "status": "success", "path": "en/api/ruby/beta/skills/versions/retrieve.md", - "sha256": "d753c85ca1fa87b919013b6034c0ef2d9a34f44601f894222b5ea8c43ef22ec2", - "size": 2625 + "sha256": "1a686446bdf27a7d115513754e7a744be1ae4dab818c2283e43e7c6411d576f0", + "size": 2697 }, { "url": "https://platform.claude.com/docs/en/api/ruby/beta/skills/versions/delete", "status": "success", "path": "en/api/ruby/beta/skills/versions/delete.md", - "sha256": "c2267756a90f7ea37b585c56f5d00e4e4ef59df1e81e2936590b06629de1ce41", - "size": 1919 + "sha256": "fba18b492aafa54d7adae0230038415e9d644dbb85513344bf5a47fecaa5bfff", + "size": 1991 + }, + { + "url": "https://platform.claude.com/docs/en/api/ruby/beta/user_profiles", + "status": "success", + "path": "en/api/ruby/beta/user_profiles.md", + "sha256": "79f471b20b18d96dc9c34a36fe0bc5e05f37b40c0fc279209881c1bd784f084d", + "size": 10010 + }, + { + "url": "https://platform.claude.com/docs/en/api/ruby/beta/user_profiles/create", + "status": "success", + "path": "en/api/ruby/beta/user_profiles/create.md", + "sha256": "943657d08d5e83c83f94db5a6d1a4e71a9b7e9f8bda2c5763ecc78c5cbe434e8", + "size": 1960 + }, + { + "url": "https://platform.claude.com/docs/en/api/ruby/beta/user_profiles/list", + "status": "success", + "path": "en/api/ruby/beta/user_profiles/list.md", + "sha256": "ec80d444b1dac84d66f53871efc6e7b32b9d3036640b858dd31322045fcdc013", + "size": 1879 + }, + { + "url": "https://platform.claude.com/docs/en/api/ruby/beta/user_profiles/retrieve", + "status": "success", + "path": "en/api/ruby/beta/user_profiles/retrieve.md", + "sha256": "2809fe1281946c8200c6bfb44cf67f6b5c748917e8e60c7d3d125f2c4ce40471", + "size": 1758 + }, + { + "url": "https://platform.claude.com/docs/en/api/ruby/beta/user_profiles/update", + "status": "success", + "path": "en/api/ruby/beta/user_profiles/update.md", + "sha256": "b0b4badf5a0b1f1f25be45a5a43704250ab903cc0a956aaa5761d0d6bd288868", + "size": 2081 + }, + { + "url": "https://platform.claude.com/docs/en/api/ruby/beta/user_profiles/create_enrollment_url", + "status": "success", + "path": "en/api/ruby/beta/user_profiles/create_enrollment_url.md", + "sha256": "781a98856d1386d7a4af5435d4a9584c5b3ae4cf8a7813ec662a609f99a52bec", + "size": 1665 }, { "url": "https://platform.claude.com/docs/en/api/terraform/completions", "status": "success", "path": "en/api/terraform/completions.md", - "sha256": "2a35e5f214f8091a6904121e5bf8efacb2d5d3d6a85adfb708f5da4f48b4150a", - "size": 92457 + "sha256": "6678c94d32a5c4320cc37cd3357050f89c30c09ce707583070525aa71caa8470", + "size": 91179 }, { "url": "https://platform.claude.com/docs/en/api/terraform/completions/create", "status": "success", "path": "en/api/terraform/completions/create.md", - "sha256": "1c75386b48b8a87a8b0fe6f047ba351891a70fe05a8f1976d572245867b3469c", - "size": 92482 + "sha256": "fcd219f162f4fab53f2e8f786c6bdaa9032bcb23ab9c394017a9807dceed8960", + "size": 91204 }, { "url": "https://platform.claude.com/docs/en/api/terraform/messages", "status": "success", "path": "en/api/terraform/messages.md", - "sha256": "6dd276251821ed356891929b4bcb3626550321b4cf967362da601c3194dbde8c", - "size": 92448 + "sha256": "762239bf84e511ea341620e48c2e24202b7e1b2fc61aac1e7775e02687bf9c4f", + "size": 91170 }, { "url": "https://platform.claude.com/docs/en/api/terraform/messages/create", "status": "success", "path": "en/api/terraform/messages/create.md", - "sha256": "26f1e7c5b3de7f594cdcb876bf758d3c29b6a3324a1d8b56308afc4987136abe", - "size": 92473 + "sha256": "7555cbf37b7db79760d68cdcc6c7364002c4e23369828df5bbc0fb1f71f243a5", + "size": 91195 }, { "url": "https://platform.claude.com/docs/en/api/terraform/messages/count_tokens", "status": "success", "path": "en/api/terraform/messages/count_tokens.md", - "sha256": "066bb140497efc1b178b82dd08a69ee07643a645421faf83955d85ddb2e18cfb", - "size": 92491 + "sha256": "d1b98380dbff4cca5924ac3307223a25fc7bbde562e304235f767da100b26e56", + "size": 91213 }, { "url": "https://platform.claude.com/docs/en/api/terraform/messages/batches", "status": "success", "path": "en/api/terraform/messages/batches.md", - "sha256": "282ba20d20304f577f8def277ae8acd8d3e43095d3f022eb60fcbab2e410ebb9", - "size": 92476 + "sha256": "242ae268638d10fa4a63714f50306ac9bf3ea3252e729586436b70b72174bb27", + "size": 91198 }, { "url": "https://platform.claude.com/docs/en/api/terraform/messages/batches/create", "status": "success", "path": "en/api/terraform/messages/batches/create.md", - "sha256": "56e07b114462f9e756979b3abe17ad6d6a692b950c40f297566b772dcbe69808", - "size": 92501 + "sha256": "6f88ae79018ffa3f136109dd075821588bf1991f2cc6b8d624e9d5c014b2cad9", + "size": 91223 }, { "url": "https://platform.claude.com/docs/en/api/terraform/messages/batches/retrieve", "status": "success", "path": "en/api/terraform/messages/batches/retrieve.md", - "sha256": "c7e37cbc8dac9950b3c1cfc13c4a97088ec963de794aed9883c5cc7ad0ad4472", - "size": 92507 + "sha256": "cb49609109b00263dd709e47c3fce1b5d1c5f07a5080316be5cf93caf3bba5ac", + "size": 91229 }, { "url": "https://platform.claude.com/docs/en/api/terraform/messages/batches/list", "status": "success", "path": "en/api/terraform/messages/batches/list.md", - "sha256": "3243f453a37bc3b89a58080ad8de002ee4c260785bf07d2c2f1bc24f761e2fad", - "size": 92495 + "sha256": "6f3f48a6a9c62c47f362008d9325c0cc06fcfbe8bdfda9d444eab9486ebb29f9", + "size": 91217 }, { "url": "https://platform.claude.com/docs/en/api/terraform/messages/batches/cancel", "status": "success", "path": "en/api/terraform/messages/batches/cancel.md", - "sha256": "b1f6a7d5139aa1d6ef7fa3f95fac5ae8f45d57a98eb193ad0d9b63b8046caba7", - "size": 92501 + "sha256": "2b80a0940506974d7f64b9efd078308003f779a0992d8f2eeaed7a3a27a79b1e", + "size": 91223 }, { "url": "https://platform.claude.com/docs/en/api/terraform/messages/batches/delete", "status": "success", "path": "en/api/terraform/messages/batches/delete.md", - "sha256": "c2b5632777fb062f3e48c5fa188e490450a6a9f45f8f15faad58685b811471a9", - "size": 92501 + "sha256": "b951c996f42ba5e27b960e7f4b8481f846ca4af51e8325dc4a8f6d7453c9c390", + "size": 91223 }, { "url": "https://platform.claude.com/docs/en/api/terraform/messages/batches/results", "status": "success", "path": "en/api/terraform/messages/batches/results.md", - "sha256": "82b2fba1e1677398881e1a4a93ce716a7b1fd32677a87376f23e28cfe3d9edb6", - "size": 92504 + "sha256": "6307c31cc6b6ff6a019048725a4783de084bdb7699d208bd89c13e0e9caa94c4", + "size": 91226 }, { "url": "https://platform.claude.com/docs/en/api/terraform/models", "status": "success", "path": "en/api/terraform/models.md", - "sha256": "e03827fb20ff488c61e255c3c21ec7c8b4f501fa19a792df3852d9d189de9a23", - "size": 92442 + "sha256": "db425a8bc331e03c382a125997ce1c3942b655a75537fe36fa3a24be0f313461", + "size": 91164 }, { "url": "https://platform.claude.com/docs/en/api/terraform/models/list", "status": "success", "path": "en/api/terraform/models/list.md", - "sha256": "79bc7f70572569e1d08b733cc578a4b2b9c3c34c2b028b71aa44942b0594af88", - "size": 92461 + "sha256": "a5e7d86db9597949b88e0b5b695ef61d76fc59911dc8098f2950e7101ad6f5db", + "size": 91183 }, { "url": "https://platform.claude.com/docs/en/api/terraform/models/retrieve", "status": "success", "path": "en/api/terraform/models/retrieve.md", - "sha256": "aa4520f21a7ed31137a2d433afc70bc6bb84d14241696feb7601875858664370", - "size": 92473 + "sha256": "3fa53d6a2be359d09d17a4ea26007407cd3fd45d69881e2dab500e53696f1e5a", + "size": 91195 }, { "url": "https://platform.claude.com/docs/en/api/terraform/beta", "status": "success", "path": "en/api/terraform/beta.md", - "sha256": "27b08d584df24e1a9f8649e26b08e9da11883b7ad31f267816c5dcd6e85a75fb", - "size": 92436 + "sha256": "a61864a161c1b335a3b7c64b87e3b000928b157492cdc7c9328b9d4e6114eca7", + "size": 91158 }, { "url": "https://platform.claude.com/docs/en/api/terraform/beta/models", "status": "success", "path": "en/api/terraform/beta/models.md", - "sha256": "8edef1710b876f544bff5d87c31fdbabbdfa6e02b1625229f5d2a441d997488d", - "size": 92461 + "sha256": "81a6d2a78345503a107a3e92dc27684cc83eb50b887c53b5fbc310285e9a62ba", + "size": 91183 }, { "url": "https://platform.claude.com/docs/en/api/terraform/beta/models/list", "status": "success", "path": "en/api/terraform/beta/models/list.md", - "sha256": "c7f5d2eef05722e99bf8e8bc9e7e453d954945cc8f218182e1ff732f443bf4a5", - "size": 92480 + "sha256": "b9f61e33f9d1f1013438d7ae925533462f25ceb1807488c3c56b49ba6af087fd", + "size": 91202 }, { "url": "https://platform.claude.com/docs/en/api/terraform/beta/models/retrieve", "status": "success", "path": "en/api/terraform/beta/models/retrieve.md", - "sha256": "4458a5c1eeb62215330c1bef3d88567aa052dd661475dddf7405f4feed881639", - "size": 92492 + "sha256": "17c2a0aa3b90061bd7c1cff42ac7fe98adeae958e481a916baec866369c45dac", + "size": 91214 }, { "url": "https://platform.claude.com/docs/en/api/terraform/beta/messages", "status": "success", "path": "en/api/terraform/beta/messages.md", - "sha256": "15846924a5e7370ae649b6f7895ccfcb1fbc692eb4f2f6e946d2549630c4b57c", - "size": 92467 + "sha256": "2047f58f066161609e7b7bed8a60d424d578318b9e92506111252a511d63fa5e", + "size": 91189 }, { "url": "https://platform.claude.com/docs/en/api/terraform/beta/messages/create", "status": "success", "path": "en/api/terraform/beta/messages/create.md", - "sha256": "42ea886b5daba4cf35044fe6bc7a9d17c21a14d653abf35972c165802630e592", - "size": 92492 + "sha256": "744ff7b27eb9e4049b2823ce0df0cb17c79d80ba003ab9c2f2c4579f72f75e61", + "size": 91214 }, { "url": "https://platform.claude.com/docs/en/api/terraform/beta/messages/count_tokens", "status": "success", "path": "en/api/terraform/beta/messages/count_tokens.md", - "sha256": "7e6d2cd20b407469ca1bffb316a887303c618f5d6db46e775a4390dc6ca6f8d4", - "size": 92510 + "sha256": "9e911be1803655b6ccd5f18a43b33c7c93acc13545bd2572fa291d259be6fc25", + "size": 91232 }, { "url": "https://platform.claude.com/docs/en/api/terraform/beta/messages/batches", "status": "success", "path": "en/api/terraform/beta/messages/batches.md", - "sha256": "6d5016f9d2300fc9d2a73828fa90aa459547c63690b5031b9ab8a1f4b47dc736", - "size": 92495 + "sha256": "4ea7bc3d71e0a23a3b90ff033184075aea965112879f8cb0a4b373c7f4abdb8e", + "size": 91217 }, { "url": "https://platform.claude.com/docs/en/api/terraform/beta/messages/batches/create", "status": "success", "path": "en/api/terraform/beta/messages/batches/create.md", - "sha256": "3f35492aceb303234b295fa1e1148d5e6c6da2ca729b1028cb6ce065edb4e91c", - "size": 92520 + "sha256": "5d28720281c2c46c933acf5170085d893aee6deb757efff6f906e8e1607622b7", + "size": 91242 }, { "url": "https://platform.claude.com/docs/en/api/terraform/beta/messages/batches/retrieve", "status": "success", "path": "en/api/terraform/beta/messages/batches/retrieve.md", - "sha256": "ee876cfcb3efd3c6befdb1fe140a2a1520ac06a618ab726af7345aba7e29eb48", - "size": 92526 + "sha256": "eec62699e83c2ddb3be66a7cfb91bf5a95a7dce6e7c133c81a682eb64a1b3f61", + "size": 91248 }, { "url": "https://platform.claude.com/docs/en/api/terraform/beta/messages/batches/list", "status": "success", "path": "en/api/terraform/beta/messages/batches/list.md", - "sha256": "aca8d599617a6c3a287d0da10644a580000c6e84e64e784f080dc1d6f608b17f", - "size": 92514 + "sha256": "fad0525ae9ee2e3689b25b8687cbb2838ca9ad916db7547e839f73db931e0c56", + "size": 91236 }, { "url": "https://platform.claude.com/docs/en/api/terraform/beta/messages/batches/cancel", "status": "success", "path": "en/api/terraform/beta/messages/batches/cancel.md", - "sha256": "a0d87c05965b89a35c92d341afaeeb3436157e24fe90f84ddea447b843ed34d8", - "size": 92520 + "sha256": "7eeb361c2bd5373db0dd02214c04eac71cc864e9e1dc52c02b6b1fe3b86e54c0", + "size": 91242 }, { "url": "https://platform.claude.com/docs/en/api/terraform/beta/messages/batches/delete", "status": "success", "path": "en/api/terraform/beta/messages/batches/delete.md", - "sha256": "8ea6e994205dbabd104b6dc58f589bbc9856becee90f3d1f9d0bc24529dae4f8", - "size": 92520 + "sha256": "fb0e5e85a7e0aee71da4a3e1f0c9fa8def3b0fb54380cb7541574b4d9d4be482", + "size": 91242 }, { "url": "https://platform.claude.com/docs/en/api/terraform/beta/messages/batches/results", "status": "success", "path": "en/api/terraform/beta/messages/batches/results.md", - "sha256": "b872645ab401cf04f348c7110fb4e24f9e408dffcb9bff87f1dddbf3ad0ad612", - "size": 92523 + "sha256": "ba8e5985f08c3bd2d3b9191323502276a3cd5533cff0fa11eca7f1ae4278cbf6", + "size": 91245 }, { "url": "https://platform.claude.com/docs/en/api/terraform/beta/files", "status": "success", "path": "en/api/terraform/beta/files.md", - "sha256": "1de348c3a0d9864c1e9b61aa95bcd25e29b43eac8f203abf1278ac4c9948fd03", - "size": 92458 + "sha256": "f2a9076b63e48cfb8632ba5fbc02c9dd1e3dfc198c2ed64c9803ed5861ab0fcf", + "size": 91180 }, { "url": "https://platform.claude.com/docs/en/api/terraform/beta/files/upload", "status": "success", "path": "en/api/terraform/beta/files/upload.md", - "sha256": "4d2f3ab7fb7e79eb274920bfced678d7625f1c3794fb3445998b02dfd6f6dfed", - "size": 92483 + "sha256": "1e3bdf5f5b26d7c31d4cd04313ae4fc41db94a75556079f4846f949b166395fa", + "size": 91205 }, { "url": "https://platform.claude.com/docs/en/api/terraform/beta/files/list", "status": "success", "path": "en/api/terraform/beta/files/list.md", - "sha256": "3ecd734028a2ed0c5c1ce7696effcca8b1ecc274ef955d31ee05d15bdb690e26", - "size": 92477 + "sha256": "d106a278dac839487256c1c7f8af0f5247781659458be53ec0216570992d53b5", + "size": 91199 }, { "url": "https://platform.claude.com/docs/en/api/terraform/beta/files/download", "status": "success", "path": "en/api/terraform/beta/files/download.md", - "sha256": "84d02adb52ee747ea641be61a8c044629b10c70b279fd6d3a4cb7e061bfb72e6", - "size": 92489 + "sha256": "eba899b90051b53e2d847464b5bafe09dd29ec07b7155b2314d569a4c01586a1", + "size": 91211 }, { "url": "https://platform.claude.com/docs/en/api/terraform/beta/files/retrieve_metadata", "status": "success", "path": "en/api/terraform/beta/files/retrieve_metadata.md", - "sha256": "bc884af1c6be68cb7c2ae357f5ded896d5b08a2d22794d48b08ec94a586028ea", - "size": 92516 + "sha256": "8a08483febd9368cc2cb8de5b431310e4a1d22c0c02245f90134f76441592f6f", + "size": 91238 }, { "url": "https://platform.claude.com/docs/en/api/terraform/beta/files/delete", "status": "success", "path": "en/api/terraform/beta/files/delete.md", - "sha256": "cb2d0a8f08201477cdf2ff7571fd6c5a160dfe6271034a66ff31039ee6d85661", - "size": 92483 + "sha256": "277ce0affe1e84fdb393bf7ff222dc6f7008ba14ff0f1d09067edd79ecd0000d", + "size": 91205 }, { "url": "https://platform.claude.com/docs/en/api/terraform/beta/skills", "status": "success", "path": "en/api/terraform/beta/skills.md", - "sha256": "9479ac73bbef078dfbdf1aeb4fca2f54b10b9e4ae8851d25c885014d4a5574e3", - "size": 92461 + "sha256": "8f10b430f6bd7eb623fccd0142f0fc000cfee7a6f04f33504a0a6d3ae3f13fb1", + "size": 91183 }, { "url": "https://platform.claude.com/docs/en/api/terraform/beta/skills/create", "status": "success", "path": "en/api/terraform/beta/skills/create.md", - "sha256": "d38281524e3c436c9ad98ba1152f926b21c666dcfdc36d3683fe88f78f8d3e4c", - "size": 92486 + "sha256": "db3942313f6bf2665c43728a5d0a87a51dfe768c0fa12e807d0f285ef0983a7e", + "size": 91208 }, { "url": "https://platform.claude.com/docs/en/api/terraform/beta/skills/list", "status": "success", "path": "en/api/terraform/beta/skills/list.md", - "sha256": "bcc84a616d890f4d86f16f54e2f867227a550e2de5d0ca03575addbc22766ff3", - "size": 92480 + "sha256": "4fac4877cd62db64ed841c2da11b559133e4d2aee6ed8611df647e957084fa0d", + "size": 91202 }, { "url": "https://platform.claude.com/docs/en/api/terraform/beta/skills/retrieve", "status": "success", "path": "en/api/terraform/beta/skills/retrieve.md", - "sha256": "5fbf4e09bc82d9e9a5140011f097b89471f7eb8c939e42f8eee65cf9aaf2e172", - "size": 92492 + "sha256": "3b03fa7fd0164fb80b2478018d23f771c1b4e53244c299a00646f0653fd644ce", + "size": 91214 }, { "url": "https://platform.claude.com/docs/en/api/terraform/beta/skills/delete", "status": "success", "path": "en/api/terraform/beta/skills/delete.md", - "sha256": "bf8fcebf3bc05dd1a6694af8bf49d5a388279e6bc4ef83e038bea8a6ff31d543", - "size": 92486 + "sha256": "f5332d7de31f376dd4135aa7b9c51fbc2b772638e426bd3e90a4260c9262d267", + "size": 91208 }, { "url": "https://platform.claude.com/docs/en/api/terraform/beta/skills/versions", "status": "success", "path": "en/api/terraform/beta/skills/versions.md", - "sha256": "bf579ae16dedf73470e298c744e717dc4cca230e440ad9eb3a5bf9bac23f70a6", - "size": 92492 + "sha256": "39f3636aa80f73a8abd1b35edfce2c507d2f116ac12afd0866638d5ef3146dfb", + "size": 91214 }, { "url": "https://platform.claude.com/docs/en/api/terraform/beta/skills/versions/create", "status": "success", "path": "en/api/terraform/beta/skills/versions/create.md", - "sha256": "ded02a0b36811a5a9acf45932b25f9d3aadf05b6e7d5105cb822034921db1049", - "size": 92517 + "sha256": "d1c9c848de2c65c6b0f652143e8a4aea686e77b8773dae7983cab0d66075fcfc", + "size": 91239 }, { "url": "https://platform.claude.com/docs/en/api/terraform/beta/skills/versions/list", "status": "success", "path": "en/api/terraform/beta/skills/versions/list.md", - "sha256": "a0f9c75d8d59aa7cb76c15c8244b7c2a114a429b5b0d3d1a18db8752f4545f9f", - "size": 92511 + "sha256": "780d0abdbc9550a822fbee056576abd4ae133f337bd480ccb0f083396d0b7863", + "size": 91233 }, { "url": "https://platform.claude.com/docs/en/api/terraform/beta/skills/versions/retrieve", "status": "success", "path": "en/api/terraform/beta/skills/versions/retrieve.md", - "sha256": "96165a95afdeb1552f8c08e64ee45da8e177292f36ddf801c40c9aeed126dc40", - "size": 92523 + "sha256": "354db4f17ab1aedc9cabe1421766746bbadc8e02a8015692199564cd2ed741f5", + "size": 91245 }, { "url": "https://platform.claude.com/docs/en/api/terraform/beta/skills/versions/delete", "status": "success", "path": "en/api/terraform/beta/skills/versions/delete.md", - "sha256": "67cbc11b1f9094aa9b0b1337af0dba1340d1ade616dfb6a2338133370d70efb4", - "size": 92517 + "sha256": "b7798f49ba86dfad63e04085129ee7724be94da7d93d90d35c3f818a70cdbe34", + "size": 91239 + }, + { + "url": "https://platform.claude.com/docs/en/api/terraform/beta/user_profiles", + "status": "success", + "path": "en/api/terraform/beta/user_profiles.md", + "sha256": "2da529334ce13ada8a384922c1a6eb25c75cfd9f3ed95add0635533760f35e5f", + "size": 91204 + }, + { + "url": "https://platform.claude.com/docs/en/api/terraform/beta/user_profiles/create", + "status": "success", + "path": "en/api/terraform/beta/user_profiles/create.md", + "sha256": "1adc1ceac90ea6efedc53d277875dea46aa7bab7c72c9585f8171cc92e2f163c", + "size": 91229 + }, + { + "url": "https://platform.claude.com/docs/en/api/terraform/beta/user_profiles/list", + "status": "success", + "path": "en/api/terraform/beta/user_profiles/list.md", + "sha256": "335e57b44d95fdb66ade559723c1500698157c17e63004f34e2e947c90ca07e8", + "size": 91223 + }, + { + "url": "https://platform.claude.com/docs/en/api/terraform/beta/user_profiles/retrieve", + "status": "success", + "path": "en/api/terraform/beta/user_profiles/retrieve.md", + "sha256": "760c216c1c79abda66f24f1157f43166967557098b9a713e2c721c7167714521", + "size": 91235 + }, + { + "url": "https://platform.claude.com/docs/en/api/terraform/beta/user_profiles/update", + "status": "success", + "path": "en/api/terraform/beta/user_profiles/update.md", + "sha256": "134c2385b1da9135a1142beecfe863363a3abfccdd4aeb918742eb7016414102", + "size": 91229 + }, + { + "url": "https://platform.claude.com/docs/en/api/terraform/beta/user_profiles/create_enrollment_url", + "status": "success", + "path": "en/api/terraform/beta/user_profiles/create_enrollment_url.md", + "sha256": "bca4d94675e3dd94f1783734ebebb9b66c6c16650b6d721afa941a747c30ccfc", + "size": 91274 }, { "url": "https://platform.claude.com/docs/en/api/cli/completions", "status": "success", "path": "en/api/cli/completions.md", - "sha256": "7e1614f8e26057ce908ece5b73feff1d44b32fe8d78e2db4c6f3c012652f9e33", - "size": 92439 + "sha256": "c8d0825b0bd07a08575248bba5568dfc624c657eaa531d87f27b54c5ab354933", + "size": 91161 }, { "url": "https://platform.claude.com/docs/en/api/cli/completions/create", "status": "success", "path": "en/api/cli/completions/create.md", - "sha256": "1dca8f4c69d17b2bfdd45f281ade6871bfca76f21aecb3a5e808ed3e4492df9f", - "size": 92464 + "sha256": "7c42effbc990e1a7f3fc1a68e1c9af491642f741b84abd1d586e0fc1a923842d", + "size": 91186 }, { "url": "https://platform.claude.com/docs/en/api/cli/messages", "status": "success", "path": "en/api/cli/messages.md", - "sha256": "7e2a954770d575c0aac3c40a03780b7bb2ee54b717ce830e56e1ce69f501d00d", - "size": 92430 + "sha256": "e1ed202a207010b5e39376b4e3230ab8af873ea0e6601d70cdf2bddea55b60dd", + "size": 91152 }, { "url": "https://platform.claude.com/docs/en/api/cli/messages/create", "status": "success", "path": "en/api/cli/messages/create.md", - "sha256": "e5f31a1e64be55f721d715642dbe4194c4ed19e18ce2aaa9ed77c2649c9c4314", - "size": 92455 + "sha256": "fc8d57dcd0f61dcea55af0416555aa3eed0c0167cc34c9adbc86f8de6d33a1d2", + "size": 91177 }, { "url": "https://platform.claude.com/docs/en/api/cli/messages/count_tokens", "status": "success", "path": "en/api/cli/messages/count_tokens.md", - "sha256": "8417c2335a88e82f6ebcd83b75977e98c19e6f56c49dc80cd4d64c0863913078", - "size": 92473 + "sha256": "df60b371353b3df5882ed7dbc3f6d7d38417ba66f654bbccdb6b79e108efac46", + "size": 91195 }, { "url": "https://platform.claude.com/docs/en/api/cli/messages/batches", "status": "success", "path": "en/api/cli/messages/batches.md", - "sha256": "6ea4f12db182f9bacd85b75564f4215185ef355e357d2d2e087f2490b111df37", - "size": 92458 + "sha256": "69450338a613357f840029bb5134be0ce58e981db41e115c543e972dac73db99", + "size": 91180 }, { "url": "https://platform.claude.com/docs/en/api/cli/messages/batches/create", "status": "success", "path": "en/api/cli/messages/batches/create.md", - "sha256": "9d397972063e57c91bbf37c0dc28fa0e37da6dd616f2e398d52377d84f8048e3", - "size": 92483 + "sha256": "89340efb5976e3e5245ef14aac70ae60ca7103eee48851136864f9dc6203c8ad", + "size": 91205 }, { "url": "https://platform.claude.com/docs/en/api/cli/messages/batches/retrieve", "status": "success", "path": "en/api/cli/messages/batches/retrieve.md", - "sha256": "8d31259588898b36879580ac5203709b97cd71c93d6c6dd1aa038797b8f53c43", - "size": 92489 + "sha256": "2e76f84474b7597cacfb5423bab568117967cd22fcc75ce3a06a7f95960ec927", + "size": 91211 }, { "url": "https://platform.claude.com/docs/en/api/cli/messages/batches/list", "status": "success", "path": "en/api/cli/messages/batches/list.md", - "sha256": "3b2d897a337ada3b16b23e5de7185d83af26032d111b3b27026d5bb134bb6ecb", - "size": 92477 + "sha256": "178a758b95978d1a1d9e81d1244bbec03138a33c149eddce209166e3e7c0a7d0", + "size": 91199 }, { "url": "https://platform.claude.com/docs/en/api/cli/messages/batches/cancel", "status": "success", "path": "en/api/cli/messages/batches/cancel.md", - "sha256": "9d041b7a51cf3b8e07cb04ae5fb7d19a12b5c753b88885dac8b208eba6d4ce83", - "size": 92483 + "sha256": "b168447f0e5acd273a7abb97bd98c4a2ea0f3d645a578a7f1eaf7b46dbd19c9f", + "size": 91205 }, { "url": "https://platform.claude.com/docs/en/api/cli/messages/batches/delete", "status": "success", "path": "en/api/cli/messages/batches/delete.md", - "sha256": "3ddc3ddf3560d2567b86717f0739a387ac9956bbb69f2ee26bed95ab20c0d582", - "size": 92483 + "sha256": "9440746b111a0fa527de711ba34b9d415ecba65e5458efffeb97ddd2f0704c2d", + "size": 91205 }, { "url": "https://platform.claude.com/docs/en/api/cli/messages/batches/results", "status": "success", "path": "en/api/cli/messages/batches/results.md", - "sha256": "bda4a348c555e4258f86dedd16d2e816335ccc10e8698b98d18ad14193dff5a4", - "size": 92486 + "sha256": "128c7a672ac52bd2c63d431391cc05e5d97c6bbf7fa54bf33a8c1ac718b3c958", + "size": 91208 }, { "url": "https://platform.claude.com/docs/en/api/cli/models", "status": "success", "path": "en/api/cli/models.md", - "sha256": "d004f94a63d8ba623a6e1f955f35ac209baeea32f83c66dc1cdd83a85837e980", - "size": 92424 + "sha256": "3b2c6801c7979c37a89a67811782bee26f39747eae790e7f44ff368463098afa", + "size": 91146 }, { "url": "https://platform.claude.com/docs/en/api/cli/models/list", "status": "success", "path": "en/api/cli/models/list.md", - "sha256": "99c1816aeae4b4d3de2bde26e62b86ba42e21463d851fcada5269f73fef3e8c6", - "size": 92443 + "sha256": "74d16546b94974a13e25824a69c40353d5c0e8521db27f0ece17606de4ed6264", + "size": 91165 }, { "url": "https://platform.claude.com/docs/en/api/cli/models/retrieve", "status": "success", "path": "en/api/cli/models/retrieve.md", - "sha256": "2be4878cdc7c77f418b5d60e8b533744c9ac2a54c7151c973834da531cf47f95", - "size": 92455 + "sha256": "8c8f6e17a302f16a9135fc49e1786a8a9febcd95d40ce151b4934e2aa8bcad83", + "size": 91177 }, { "url": "https://platform.claude.com/docs/en/api/cli/beta", "status": "success", "path": "en/api/cli/beta.md", - "sha256": "a4cccad83ecc22ba5f3d83b381f9e2d8a058569f472ee9e1242a7537ed7b71f0", - "size": 92418 + "sha256": "115c7ae3fdc62876a7dc89e9b067f97964b96321c4f0c04abe363fda52a3f15e", + "size": 91140 }, { "url": "https://platform.claude.com/docs/en/api/cli/beta/models", "status": "success", "path": "en/api/cli/beta/models.md", - "sha256": "05325ec60cd5c7d607b1e92540490142df8c2b43e3a65e5815aef2d11dff735e", - "size": 92443 + "sha256": "7f05feb0987c08a9c1689ce5406afd670df0904eda5102b472f292510d7c8a95", + "size": 91165 }, { "url": "https://platform.claude.com/docs/en/api/cli/beta/models/list", "status": "success", "path": "en/api/cli/beta/models/list.md", - "sha256": "391e6cadacc6ad5612ed45bde7512a908c3bbbdac329319f2b07312c7b3635e0", - "size": 92462 + "sha256": "26cf5f3d92dc3f0c91988b49605faa95d241ebe7e30e73e5de4fe736bb61dba3", + "size": 91184 }, { "url": "https://platform.claude.com/docs/en/api/cli/beta/models/retrieve", "status": "success", "path": "en/api/cli/beta/models/retrieve.md", - "sha256": "c43b7d8d405bda46f1a5e7b21249ddbdeb36015f15b5c42bc6484086db4e7c92", - "size": 92474 + "sha256": "af220fd52b1fb2d01b052865e911bfdc49738a6ab1bb64cf7f4f62b3d291b8d6", + "size": 91196 }, { "url": "https://platform.claude.com/docs/en/api/cli/beta/messages", "status": "success", "path": "en/api/cli/beta/messages.md", - "sha256": "06c24612e24a89d25c5ee63e52fc41a608a9264661d4d757fb81801d0b51b5b8", - "size": 92449 + "sha256": "8985d61e9fafca70e2e7b25ea4082d0da301e70d65c11991b4e82485de2f8fbc", + "size": 91171 }, { "url": "https://platform.claude.com/docs/en/api/cli/beta/messages/create", "status": "success", "path": "en/api/cli/beta/messages/create.md", - "sha256": "9b58c5c7b7d4a933ae172152832504143d3174f415abf2209f0d3e6d13a6b671", - "size": 92474 + "sha256": "f3f2632472289cd2cf687a8ab9dc0b56dedeabcfe1ccd5b6b2ea2149bc5abcb6", + "size": 91196 }, { "url": "https://platform.claude.com/docs/en/api/cli/beta/messages/count_tokens", "status": "success", "path": "en/api/cli/beta/messages/count_tokens.md", - "sha256": "08d5ec03a6f109fa762bfb79bea126fc8f0913f7b8e950b5b564bcfdcbc2f295", - "size": 92492 + "sha256": "389d16b6afe8222c903543c20367f371dfea0ec491ef15f6f7661caa043b7c26", + "size": 91214 }, { "url": "https://platform.claude.com/docs/en/api/cli/beta/messages/batches", "status": "success", "path": "en/api/cli/beta/messages/batches.md", - "sha256": "9c5d2b151fee111a1e8c6df4b4427502d4c04dce7c2798b4fee2ff0607b2a541", - "size": 92477 + "sha256": "24bdda7d15a3c3053b03a4f86e06d376cdaa3cdd897c1f84e24c20a1b76fc758", + "size": 91199 }, { "url": "https://platform.claude.com/docs/en/api/cli/beta/messages/batches/create", "status": "success", "path": "en/api/cli/beta/messages/batches/create.md", - "sha256": "6589d4ff01eaa35e3461be637358cbc233c4b39330ddab798fefec01e3df98de", - "size": 92502 + "sha256": "da54ddbb4e7ab2e0ebfec5d502eb8e044665e010f69d6bf4b0bc139d2e70019d", + "size": 91224 }, { "url": "https://platform.claude.com/docs/en/api/cli/beta/messages/batches/retrieve", "status": "success", "path": "en/api/cli/beta/messages/batches/retrieve.md", - "sha256": "e5391ff7e14e2c678fb2e0a8cc89418283876576ca341773757e00e32511651f", - "size": 92508 + "sha256": "8f0c59778e09aec086f58cbfeb38dbcd1c0a6880b4c1ba718eae6282ff8046e1", + "size": 91230 }, { "url": "https://platform.claude.com/docs/en/api/cli/beta/messages/batches/list", "status": "success", "path": "en/api/cli/beta/messages/batches/list.md", - "sha256": "7fd3a40f7ff95409b9d1d010bc4f876acafbf4c144abaa20fb075b4570ccf73a", - "size": 92496 + "sha256": "db288c7b8e8c622480d6f67c39d2a33a9a2444e077a8c28a453aeca2f6a2a573", + "size": 91218 }, { "url": "https://platform.claude.com/docs/en/api/cli/beta/messages/batches/cancel", "status": "success", "path": "en/api/cli/beta/messages/batches/cancel.md", - "sha256": "795af383ea80a2d0a0f74efcfd5d2c27e7d9516f2eaa4ea54bfd2598e1a5d111", - "size": 92502 + "sha256": "d3b5ca7c9f7b50ef665f2922924839cceae940eaeb5500d69093ccf0f3c0c409", + "size": 91224 }, { "url": "https://platform.claude.com/docs/en/api/cli/beta/messages/batches/delete", "status": "success", "path": "en/api/cli/beta/messages/batches/delete.md", - "sha256": "d651370f41a035fbd04d18be7130bdec1e29527054923248e8a29c3c002b3a00", - "size": 92502 + "sha256": "c3c37601c563dc7b1962ce660fc857dedbe17f569d617bb530c4dcb04f192d27", + "size": 91224 }, { "url": "https://platform.claude.com/docs/en/api/cli/beta/messages/batches/results", "status": "success", "path": "en/api/cli/beta/messages/batches/results.md", - "sha256": "a989877591da9f4d50b650df534988e7c3aa22b8803afad1cd37b9ce0607466f", - "size": 92505 + "sha256": "e75bb81785e43c132bf7b1d2c154504ec97a725f18ad9ab6e994b88d0446b7d4", + "size": 91227 }, { "url": "https://platform.claude.com/docs/en/api/cli/beta/files", "status": "success", "path": "en/api/cli/beta/files.md", - "sha256": "d8782167e1d5aa2f2195e4cea1decc83b3fd56bad51561c121da0359d3c1cc63", - "size": 92440 + "sha256": "bb29b785076839f7e3ba3d2f6599e21dfc4eb2325173e7582f9ed4187367221e", + "size": 91162 }, { "url": "https://platform.claude.com/docs/en/api/cli/beta/files/upload", "status": "success", "path": "en/api/cli/beta/files/upload.md", - "sha256": "79fb4ee2f4e3cd69696e0ccdcc3083ec4e3cc6a1f8e6de0c7f86d41bcd85e2bb", - "size": 92465 + "sha256": "7cb3010ed52652b645b1526f826c9664c889f13843f5a1b7fde1242e8c4ea995", + "size": 91187 }, { "url": "https://platform.claude.com/docs/en/api/cli/beta/files/list", "status": "success", "path": "en/api/cli/beta/files/list.md", - "sha256": "d9363615c3de8d43c723da588d74353e35ec74ca36fc5b8ae177f5c9a9abb660", - "size": 92459 + "sha256": "cf7140d915c593444c32f8403579dbdf0bfd33a1eca65a3000bb2c5949be95b7", + "size": 91181 }, { "url": "https://platform.claude.com/docs/en/api/cli/beta/files/download", "status": "success", "path": "en/api/cli/beta/files/download.md", - "sha256": "888a104b96a4e2f26bfa3150b5514b05d9fc4bf84859b627c5d5bf615135ed67", - "size": 92471 + "sha256": "ccaf4b59ee968f0468567947003b49206166a4415ca24287e07c33667b6b7d16", + "size": 91193 }, { "url": "https://platform.claude.com/docs/en/api/cli/beta/files/retrieve_metadata", "status": "success", "path": "en/api/cli/beta/files/retrieve_metadata.md", - "sha256": "63b569345e85eecc0374365fb42af880e86f4127bc1512c7d1c0d8474c9f121f", - "size": 92498 + "sha256": "547bc03546010da113f0262215d852bfbe9817ac38621196515d0300d1af46ad", + "size": 91220 }, { "url": "https://platform.claude.com/docs/en/api/cli/beta/files/delete", "status": "success", "path": "en/api/cli/beta/files/delete.md", - "sha256": "c37773024ffa2f64694eefdb9b270b638d48cc69df224144208852e2d1bd80d0", - "size": 92465 + "sha256": "69afdeea5b6089f8e17b3f3672356f48bba9acb66b183374b23289eabf887d65", + "size": 91187 }, { "url": "https://platform.claude.com/docs/en/api/cli/beta/skills", "status": "success", "path": "en/api/cli/beta/skills.md", - "sha256": "b947a7637ad826419bcf62edb7b2483b5dd52e58ab3a8ff18bb39304da73e17b", - "size": 92443 + "sha256": "0db6e5cf8022bd4b23a9037d8b3ed195e474edb4496c705f80210f8a01b9cc28", + "size": 91165 }, { "url": "https://platform.claude.com/docs/en/api/cli/beta/skills/create", "status": "success", "path": "en/api/cli/beta/skills/create.md", - "sha256": "32e0d74b7993e4326e030503a623de2f3015000868fc74a312180b61937d5eeb", - "size": 92468 + "sha256": "9e1619862e0c066f32744494cdc7f244156509b36d0df7f143af0514b020ffc7", + "size": 91190 }, { "url": "https://platform.claude.com/docs/en/api/cli/beta/skills/list", "status": "success", "path": "en/api/cli/beta/skills/list.md", - "sha256": "7cd62897bb01257ebd7ec65d8e910fad46e4d32586aa106e33383feda83f1fd8", - "size": 92462 + "sha256": "7e049ef345d832692b7bc0ab1125b47566f87fc30747f66d952141721bf345d8", + "size": 91184 }, { "url": "https://platform.claude.com/docs/en/api/cli/beta/skills/retrieve", "status": "success", "path": "en/api/cli/beta/skills/retrieve.md", - "sha256": "2e908a79235a05ac488b4a7559e90cc0d9f9d9ad931c941e1c036f7957eb15db", - "size": 92474 + "sha256": "40a156112035d70358463e36efe5422d220840c29108176099d3585014af5867", + "size": 91196 }, { "url": "https://platform.claude.com/docs/en/api/cli/beta/skills/delete", "status": "success", "path": "en/api/cli/beta/skills/delete.md", - "sha256": "c7db40ac759b6886f64c3a4a3181af88068d4efa47c3fe2ab34ebd88f873cd8a", - "size": 92468 + "sha256": "07572b8c2bbf34fbcc135d26b2050995951a0618a1c2e2711a5dafeaa4fde6e4", + "size": 91190 }, { "url": "https://platform.claude.com/docs/en/api/cli/beta/skills/versions", "status": "success", "path": "en/api/cli/beta/skills/versions.md", - "sha256": "7bf69fe90a6a1f458799cbb9d5652896d02bb37cf19297b47c8751d3e2fdb871", - "size": 92474 + "sha256": "429ceb718d9db6b03c836e57ebdde5cec101fff4ef0344832757e4c2b1284dcb", + "size": 91196 }, { "url": "https://platform.claude.com/docs/en/api/cli/beta/skills/versions/create", "status": "success", "path": "en/api/cli/beta/skills/versions/create.md", - "sha256": "5bca7b34155e3fdecd53482c92b6d1181e55f4300f8afc14570e1878f7d89690", - "size": 92499 + "sha256": "68ec43bc39c3872c29c73fd9751c385a553bbbb02ee34ec48d3b5c135b7ecb72", + "size": 91221 }, { "url": "https://platform.claude.com/docs/en/api/cli/beta/skills/versions/list", "status": "success", "path": "en/api/cli/beta/skills/versions/list.md", - "sha256": "0de88036fdb49732e4b7f3eb85e3be04925c5530a093263a73b5de10c62b439f", - "size": 92493 + "sha256": "da8f4b2f5d7a41226b5db7088d85c481211129f2d12efae76f3da82fbf6005c3", + "size": 91215 }, { "url": "https://platform.claude.com/docs/en/api/cli/beta/skills/versions/retrieve", "status": "success", "path": "en/api/cli/beta/skills/versions/retrieve.md", - "sha256": "859ead0eada2580876a6e3d1ca2aa0a6d4580ac968ad3259d2c120117d2c88bb", - "size": 92505 + "sha256": "85349c21dd0734430e48e43ac5aa54db34ec4109feb294b0fa8f94e168492d73", + "size": 91227 }, { "url": "https://platform.claude.com/docs/en/api/cli/beta/skills/versions/delete", "status": "success", "path": "en/api/cli/beta/skills/versions/delete.md", - "sha256": "824c3475c82d2f596be9288c7d74c70cb447fff97063538851e9f8de085171d5", - "size": 92499 + "sha256": "5a84553158683ba14c324f119979034736624135e3699223f65885587908a429", + "size": 91221 + }, + { + "url": "https://platform.claude.com/docs/en/api/cli/beta/user_profiles", + "status": "success", + "path": "en/api/cli/beta/user_profiles.md", + "sha256": "8708690c4159aa07021ad6007146be19c7ede095477ada3f8da5e9056b02c6df", + "size": 91186 + }, + { + "url": "https://platform.claude.com/docs/en/api/cli/beta/user_profiles/create", + "status": "success", + "path": "en/api/cli/beta/user_profiles/create.md", + "sha256": "43ecba256a96b7f079441cd94fa223b8aa2866948b0340b98ba9b7a0ffb8be02", + "size": 91211 + }, + { + "url": "https://platform.claude.com/docs/en/api/cli/beta/user_profiles/list", + "status": "success", + "path": "en/api/cli/beta/user_profiles/list.md", + "sha256": "7a03c3595bab119d8b86ceb97cbbfb8896aabeb2df7e7f3bbcbc47fb53617d57", + "size": 91205 + }, + { + "url": "https://platform.claude.com/docs/en/api/cli/beta/user_profiles/retrieve", + "status": "success", + "path": "en/api/cli/beta/user_profiles/retrieve.md", + "sha256": "29fb867b949e638f7aa6e5255a84d3fd4bbb0b82b59315fb3ad25d5703cf9453", + "size": 91217 + }, + { + "url": "https://platform.claude.com/docs/en/api/cli/beta/user_profiles/update", + "status": "success", + "path": "en/api/cli/beta/user_profiles/update.md", + "sha256": "5b2fda9f9153b3ebe3ce1820bc5d88eba29ba8127cd1176a64b9febd96d9dfdf", + "size": 91211 + }, + { + "url": "https://platform.claude.com/docs/en/api/cli/beta/user_profiles/create_enrollment_url", + "status": "success", + "path": "en/api/cli/beta/user_profiles/create_enrollment_url.md", + "sha256": "fc691039ae10d0a2bee01edc65b7c402314369f3b36bab54c22175d61e8dd6a3", + "size": 91256 }, { "url": "https://platform.claude.com/docs/en/api/php/completions", "status": "success", "path": "en/api/php/completions.md", - "sha256": "6144f42aa40b63fba6a5bba1f5cc73ee0077a527b9958cce7e42359d12225166", - "size": 92439 + "sha256": "df97fed0b0c45534b2f9102c59aec226e501b6be48b54561c47346bc64b27581", + "size": 91161 }, { "url": "https://platform.claude.com/docs/en/api/php/completions/create", "status": "success", "path": "en/api/php/completions/create.md", - "sha256": "09b53584aa05f86cb9d9c4e976caad18dcb3bc74f8bdbb2247083bd816218caf", - "size": 92464 + "sha256": "33ac77e98c6ed73b23dcbd309be168b0fd8266b905ed721457836a9f23b1c90f", + "size": 91186 }, { "url": "https://platform.claude.com/docs/en/api/php/messages", "status": "success", "path": "en/api/php/messages.md", - "sha256": "14c1bc9c992dc70ff6f5cf2f14c5bf34cf24ce7c3215c263c8b976ed674f4444", - "size": 92430 + "sha256": "511975f8f90ac285f06c1b0e71f62370e81b3c18a190485b80ce32c9ab7d9f78", + "size": 91152 }, { "url": "https://platform.claude.com/docs/en/api/php/messages/create", "status": "success", "path": "en/api/php/messages/create.md", - "sha256": "b42cf2cebc85dd661694192ace33ec7f7c02ca026746dba3cb64c4751a173ba5", - "size": 92455 + "sha256": "e064df018b427fa0dd9df62fe5cc743b22ab09fde982abcb4b45382f93f1ae77", + "size": 91177 }, { "url": "https://platform.claude.com/docs/en/api/php/messages/count_tokens", "status": "success", "path": "en/api/php/messages/count_tokens.md", - "sha256": "0ebd67b032fdda8eadf86995f6aa8d08bbe2df344c9056a47e8781297b569d6c", - "size": 92473 + "sha256": "13ca11d9a5c6af5d344b4b4de79dd7682896439f46c4f0be70f4f1ae14fde5dd", + "size": 91195 }, { "url": "https://platform.claude.com/docs/en/api/php/messages/batches", "status": "success", "path": "en/api/php/messages/batches.md", - "sha256": "123c44b04b118637260b7ecb2f7d9dc18f839ebbc4a652218c97bffb83c4d355", - "size": 92458 + "sha256": "0633d6b63ce45f35d64f00d3d22d413869f49067c849b2b27d016352a083eaf4", + "size": 91180 }, { "url": "https://platform.claude.com/docs/en/api/php/messages/batches/create", "status": "success", "path": "en/api/php/messages/batches/create.md", - "sha256": "74ef2b92fe34a302a0f8b6c299ee6d798f6aa0160a25b09d4b99d9ad65a3fc36", - "size": 92483 + "sha256": "9f0af90b60d5b265bc64e4eb5c5bae4711f0571ee5360e0437054c0ebf7c4b1f", + "size": 91205 }, { "url": "https://platform.claude.com/docs/en/api/php/messages/batches/retrieve", "status": "success", "path": "en/api/php/messages/batches/retrieve.md", - "sha256": "770d9418889b1595aa04510d4e714305aa7a3e6005d65a503ae59c4623e4d503", - "size": 92489 + "sha256": "748492844892c433a6de5769837f6a670f24b2141df4b483f631e090d4fc28fb", + "size": 91211 }, { "url": "https://platform.claude.com/docs/en/api/php/messages/batches/list", "status": "success", "path": "en/api/php/messages/batches/list.md", - "sha256": "f18fef0f5df7a705e5007529b41a889f93f40a29c2f4085be46f3b6b2f188b11", - "size": 92477 + "sha256": "fad691848824f2a091b9201b06adbb45fc08c0fb2efb936f767903604189b7e5", + "size": 91199 }, { "url": "https://platform.claude.com/docs/en/api/php/messages/batches/cancel", "status": "success", "path": "en/api/php/messages/batches/cancel.md", - "sha256": "ece27f33f820b486b1791241a6b42eccf9d46821f1c8dbd577150d10f22228e4", - "size": 92483 + "sha256": "8e5c4f8830c94a8d392d252ecc5d17f8d405449f2e57b34556a1d80ad809af67", + "size": 91205 }, { "url": "https://platform.claude.com/docs/en/api/php/messages/batches/delete", "status": "success", "path": "en/api/php/messages/batches/delete.md", - "sha256": "810061d20dacb69dad93ed1931b2336a3bb624c68ccb069b01c57e51ef5b2b1c", - "size": 92483 + "sha256": "ac47313df81a3e2ac586c0ca3d99445a18cfc8221fb708d6f77ad312440814f7", + "size": 91205 }, { "url": "https://platform.claude.com/docs/en/api/php/messages/batches/results", "status": "success", "path": "en/api/php/messages/batches/results.md", - "sha256": "aba0dad070482ffc19c792b63ed03a4bb99dbea93e3298b8a11934adbccd24ce", - "size": 92486 + "sha256": "2a9676eb11a92ce6920890bdb98616a5511deafbdc04036fa75e7319cd682fd9", + "size": 91208 }, { "url": "https://platform.claude.com/docs/en/api/php/models", "status": "success", "path": "en/api/php/models.md", - "sha256": "04e1cc171db9d82b1c25761f3376dd0d9114103937fe3ca6bc665f3682f0878a", - "size": 92424 + "sha256": "2faf0b400126f056ca8c22e46da09819585097e56b7a90161d7b26e10f6db547", + "size": 91146 }, { "url": "https://platform.claude.com/docs/en/api/php/models/list", "status": "success", "path": "en/api/php/models/list.md", - "sha256": "55dc783c758dcdf25a532cf8bd3ee6ccef218de0d55a8b5b366c33338975a7fd", - "size": 92443 + "sha256": "15db9b6be2cb984256d3217fa18be3e3e9c8d4f80fd6fad68b27caba66d0b133", + "size": 91165 }, { "url": "https://platform.claude.com/docs/en/api/php/models/retrieve", "status": "success", "path": "en/api/php/models/retrieve.md", - "sha256": "6e67980fff2f6514e2729365a4d7aa7de2195594a8727eff873b88113fabd40d", - "size": 92455 + "sha256": "c2c0b2a3ea57389869dcac7b4960e818d7454894896ef242569e8d3ec7f3e286", + "size": 91177 }, { "url": "https://platform.claude.com/docs/en/api/php/beta", "status": "success", "path": "en/api/php/beta.md", - "sha256": "4a5d2f1866784513e8b24da57f3348ac1418b6e0b8a4a4c70d2197827fb200a0", - "size": 92418 + "sha256": "2a7a9177d71f806a889544a44d5620b2096a54f91c11f31f3a3e5dbf1f2c5f31", + "size": 91140 }, { "url": "https://platform.claude.com/docs/en/api/php/beta/models", "status": "success", "path": "en/api/php/beta/models.md", - "sha256": "ead90e0475809e42f3853b33dacc8966314754e4e682c475d11e357a5b6d439d", - "size": 92443 + "sha256": "ee2fed605dac6693decdc5cb7d9fa5dfdf369dea043cb970c756c7eed6cea9a8", + "size": 91165 }, { "url": "https://platform.claude.com/docs/en/api/php/beta/models/list", "status": "success", "path": "en/api/php/beta/models/list.md", - "sha256": "4b8967b6509124aec37b536d6f268a4298e68776f8059292fdf9977b3f6d53d6", - "size": 92462 + "sha256": "4940bb1b3fabe6840cab0ff0ee0c3baa3abea06992dc1a0f15af1bc933c468ec", + "size": 91184 }, { "url": "https://platform.claude.com/docs/en/api/php/beta/models/retrieve", "status": "success", "path": "en/api/php/beta/models/retrieve.md", - "sha256": "26958d710759c0f3a77d5c350fca8d4993ec6bface679283fc47376f1bee01b8", - "size": 92474 + "sha256": "f4b46ad21b939ea0a390b32ce888087effb968467fbee03fabc69fb3635bfc88", + "size": 91196 }, { "url": "https://platform.claude.com/docs/en/api/php/beta/messages", "status": "success", "path": "en/api/php/beta/messages.md", - "sha256": "ed872774141ec8c0df84d93fa7616a05faf7fbbe0d227caaf2e75aa0e4d3e3d0", - "size": 92449 + "sha256": "457003494209a066f57639cda69df910b9a1e8640c2b76886bcedeea7b9c7d18", + "size": 91171 }, { "url": "https://platform.claude.com/docs/en/api/php/beta/messages/create", "status": "success", "path": "en/api/php/beta/messages/create.md", - "sha256": "927b1da13a75aa78821165a140260846ebd31693810cff4a1a3506a528c31cbe", - "size": 92474 + "sha256": "6983cdc9990f60b39ba6cc8e6973eb5ecbc513316481f8d7889f95b0f1cf5a78", + "size": 91196 }, { "url": "https://platform.claude.com/docs/en/api/php/beta/messages/count_tokens", "status": "success", "path": "en/api/php/beta/messages/count_tokens.md", - "sha256": "41eec498fbe263467ae785dd9b76b70ddd289e7e22d8de898fb6ade25e3739c2", - "size": 92492 + "sha256": "612089effb4667c37438eeb3170e9da405579b863e5983e9f10a2e85cb329942", + "size": 91214 }, { "url": "https://platform.claude.com/docs/en/api/php/beta/messages/batches", "status": "success", "path": "en/api/php/beta/messages/batches.md", - "sha256": "ef4759454783b039052c6ed628aa4ad2ae0d18ec0551b5440ebecae179caf40d", - "size": 92477 + "sha256": "a2a06b70cd7cb2817d1d50db4db44bc8c88086a801e1bfef8995225e4d1a15ac", + "size": 91199 }, { "url": "https://platform.claude.com/docs/en/api/php/beta/messages/batches/create", "status": "success", "path": "en/api/php/beta/messages/batches/create.md", - "sha256": "322a3e2eadddb0ee80ad3cf23d460847b5444fa99989bad6148a628e78f7fad1", - "size": 92502 + "sha256": "84dbd30da69e2266d93b996124728a3ab6750d4203a2a644b9ea4e34137ae777", + "size": 91224 }, { "url": "https://platform.claude.com/docs/en/api/php/beta/messages/batches/retrieve", "status": "success", "path": "en/api/php/beta/messages/batches/retrieve.md", - "sha256": "34543e747d0150ed0fca7a6afbe27f627a28dab7107520a1ba39cddb5f0d4337", - "size": 92508 + "sha256": "66fef54b33f32a0fb450e775103f267680e114cd838e48eddaf37835405c6357", + "size": 91230 }, { "url": "https://platform.claude.com/docs/en/api/php/beta/messages/batches/list", "status": "success", "path": "en/api/php/beta/messages/batches/list.md", - "sha256": "8911b63211b3bdedc8b8f3c7ceb381ce3a5287411513525c5ac97fc8fd921567", - "size": 92496 + "sha256": "a881a45bc87fb4b6813b704388940bb6e60066a28d49840360f21f06b1355eba", + "size": 91218 }, { "url": "https://platform.claude.com/docs/en/api/php/beta/messages/batches/cancel", "status": "success", "path": "en/api/php/beta/messages/batches/cancel.md", - "sha256": "979491258487aaa9a629f67f44272efa2f37f12a0ff8c42dd0b2295e31a8ffb7", - "size": 92502 + "sha256": "03ec7283668f6a5ac936266cb2fe01bf05b7939941335c967531441d67a10777", + "size": 91224 }, { "url": "https://platform.claude.com/docs/en/api/php/beta/messages/batches/delete", "status": "success", "path": "en/api/php/beta/messages/batches/delete.md", - "sha256": "4e61fa1def9bdda24f17d2a4b58c90a90ed29db5c90174f4c4f028a6aa528187", - "size": 92502 + "sha256": "fc78f7826b6c43f1c76d1d37fabe091543a7d4d06c7773fa3b53728d861e2eb8", + "size": 91224 }, { "url": "https://platform.claude.com/docs/en/api/php/beta/messages/batches/results", "status": "success", "path": "en/api/php/beta/messages/batches/results.md", - "sha256": "92ecb5e9fe69aed5a8dc6ef4a824a30db7e7bcbc896ba39a5a1965bc3110ad69", - "size": 92505 + "sha256": "e17bf53a3ca21b87aa8021966bdf993e1a671178366e90830d8db7dfe3bb30c3", + "size": 91227 }, { "url": "https://platform.claude.com/docs/en/api/php/beta/files", "status": "success", "path": "en/api/php/beta/files.md", - "sha256": "2dbf77be37c114a096a032fe6a40d940504a56e9a3e90fd56ae9d9003f24d592", - "size": 92440 + "sha256": "a28a8e47532cb1b5751fcfd36881b59580f115507dcaf3284636f1494b07c177", + "size": 91162 }, { "url": "https://platform.claude.com/docs/en/api/php/beta/files/upload", "status": "success", "path": "en/api/php/beta/files/upload.md", - "sha256": "8dcd7e91aeca9a3469fd6f12ccc9a0d8b62c7f9e1d47eb16c0cf09559c021ba8", - "size": 92465 + "sha256": "99dff7aa59b2827872515f4fcedb133af53e01bf30f690d174f29f0a9219efbb", + "size": 91187 }, { "url": "https://platform.claude.com/docs/en/api/php/beta/files/list", "status": "success", "path": "en/api/php/beta/files/list.md", - "sha256": "d442f9a3582bc5e5f3ac2559079677126ff072a2f72da2255bce394f7ec881c0", - "size": 92459 + "sha256": "cbd9d30b4c434c297c6f6ea09da02c0c77abd286b3de8e79c357b81951066a6b", + "size": 91181 }, { "url": "https://platform.claude.com/docs/en/api/php/beta/files/download", "status": "success", "path": "en/api/php/beta/files/download.md", - "sha256": "9ef5c2165eaa45328ff80ec54a8a7163dcd602aad734c28b3efe71cb351eb6f0", - "size": 92471 + "sha256": "4fba87f4dbed49202b43f193027e6275f5a4219a2ef5189e3c741f7906714cec", + "size": 91193 }, { "url": "https://platform.claude.com/docs/en/api/php/beta/files/retrieve_metadata", "status": "success", "path": "en/api/php/beta/files/retrieve_metadata.md", - "sha256": "53dfe9c8aa5d5cce630b6964c0fcafc8115ebacd7dee0061869442012fb92f4c", - "size": 92498 + "sha256": "7e25761039e5e9777d28309de843f1eb044356aee20bb32b0c94b07e9968d150", + "size": 91220 }, { "url": "https://platform.claude.com/docs/en/api/php/beta/files/delete", "status": "success", "path": "en/api/php/beta/files/delete.md", - "sha256": "1fdedcda1b3265de178c9b3e4a6a4929ebcca719d69631a83a03f2d8a59b06e4", - "size": 92465 + "sha256": "8aff1a5d6e0656a15e9b0b6addfc9a39240c0197fbb7d6dc165e5bc6f01cae83", + "size": 91187 }, { "url": "https://platform.claude.com/docs/en/api/php/beta/skills", "status": "success", "path": "en/api/php/beta/skills.md", - "sha256": "7e075b4dd33bcae10020b7552ff4091cf7f3e90adb9de1d570509c2288cd8355", - "size": 92443 + "sha256": "4e547af445f489f6f980bf934ac025d88d066b1e7131efb47b0f14751a1684a6", + "size": 91165 }, { "url": "https://platform.claude.com/docs/en/api/php/beta/skills/create", "status": "success", "path": "en/api/php/beta/skills/create.md", - "sha256": "05117aa44dc860513bbdee53efc696803172f84261be5837a2447260b4a35c61", - "size": 92468 + "sha256": "905792a68e8ea49789b13735fa28f03971a9eb501b55752a18206bc1471abb21", + "size": 91190 }, { "url": "https://platform.claude.com/docs/en/api/php/beta/skills/list", "status": "success", "path": "en/api/php/beta/skills/list.md", - "sha256": "89d94ea4092337460f544548f4fc600686211d489af06978bf22a08010ceda46", - "size": 92462 + "sha256": "5d4441dc80d30778f8873ecf209404e71910d5c3af41b1bee2c21a5f7ae34268", + "size": 91184 }, { "url": "https://platform.claude.com/docs/en/api/php/beta/skills/retrieve", "status": "success", "path": "en/api/php/beta/skills/retrieve.md", - "sha256": "e9e962d67a36b1bfe47ace80f6ec246f35570101c15526edeaaa8a16db9d07ef", - "size": 92474 + "sha256": "03bd7e36e16776090acea4fdb865c5b7224cc57f7a3c324fe7825b2e8936fa64", + "size": 91196 }, { "url": "https://platform.claude.com/docs/en/api/php/beta/skills/delete", "status": "success", "path": "en/api/php/beta/skills/delete.md", - "sha256": "d81355ad9d01b24271b3d70d30f84b94f345d981e958cd8794ab7bf27441bddc", - "size": 92468 + "sha256": "bbe5f2b103a8abee4e5c20535d90ee7e784337a4d7b29d82fbb4807145fb24c6", + "size": 91190 }, { "url": "https://platform.claude.com/docs/en/api/php/beta/skills/versions", "status": "success", "path": "en/api/php/beta/skills/versions.md", - "sha256": "97c28e3548e0fe044a8a7e3af36a0fad22d33fd227f696d5353d801c9a952d44", - "size": 92474 + "sha256": "93e209997870345e2aa7eee40b46c27bdb27ae19d90d5718f53e29a3cefaa152", + "size": 91196 }, { "url": "https://platform.claude.com/docs/en/api/php/beta/skills/versions/create", "status": "success", "path": "en/api/php/beta/skills/versions/create.md", - "sha256": "e9620e4e3275cbc2e8556b36fae8fa136dc47d3e3c7926465fde5e727c2d1147", - "size": 92499 + "sha256": "a1218fdf8cbf43ce40016f12d2d7537ce0f1b3a2584bb4298a0c664cdd7ab9a5", + "size": 91221 }, { "url": "https://platform.claude.com/docs/en/api/php/beta/skills/versions/list", "status": "success", "path": "en/api/php/beta/skills/versions/list.md", - "sha256": "672beab2e53b7869e809fa66f12df85c542d19c502058efdc012142c2c38f1b5", - "size": 92493 + "sha256": "3ae450f08f6c9b63f207b9f673ad600d9f2145e0ffb74bc01c5ec7b347db487b", + "size": 91215 }, { "url": "https://platform.claude.com/docs/en/api/php/beta/skills/versions/retrieve", "status": "success", "path": "en/api/php/beta/skills/versions/retrieve.md", - "sha256": "44ac8b6d960347e9c3f563d57368965055543f157c444dd6aad13b4735b8984b", - "size": 92505 + "sha256": "aaec3c2ea39e410a8dd5e43ddd9137ec3d907d3d719454a50b06a602ce980670", + "size": 91227 }, { "url": "https://platform.claude.com/docs/en/api/php/beta/skills/versions/delete", "status": "success", "path": "en/api/php/beta/skills/versions/delete.md", - "sha256": "a55a5b0d4ca6b8cf636d4c64920f1fbdcb5660bdfc1e624e1eafb867edce5d7a", - "size": 92499 + "sha256": "d9e982919a294a37c065f305ffa3d6c0b7ae48ba42fe348e0539e74c8ff2c42a", + "size": 91221 + }, + { + "url": "https://platform.claude.com/docs/en/api/php/beta/user_profiles", + "status": "success", + "path": "en/api/php/beta/user_profiles.md", + "sha256": "564686b9d82f3116fffb6d007478a76a68eae6494994a57cc063329bcedf0a73", + "size": 91186 + }, + { + "url": "https://platform.claude.com/docs/en/api/php/beta/user_profiles/create", + "status": "success", + "path": "en/api/php/beta/user_profiles/create.md", + "sha256": "521536d848fceca52e4f91290e05a9256b9fc6333f44c0fef8a48ff27b69b3a1", + "size": 91211 + }, + { + "url": "https://platform.claude.com/docs/en/api/php/beta/user_profiles/list", + "status": "success", + "path": "en/api/php/beta/user_profiles/list.md", + "sha256": "7311558074872dd6e241bab998cc012dd47b1f64d971daaffd2f6bd817b28ac5", + "size": 91205 + }, + { + "url": "https://platform.claude.com/docs/en/api/php/beta/user_profiles/retrieve", + "status": "success", + "path": "en/api/php/beta/user_profiles/retrieve.md", + "sha256": "254f694162a7f7605c9ea9a7e3590afbeb0e20c02f2cb141d0fee3f63fa1abc9", + "size": 91217 + }, + { + "url": "https://platform.claude.com/docs/en/api/php/beta/user_profiles/update", + "status": "success", + "path": "en/api/php/beta/user_profiles/update.md", + "sha256": "95834e8d6d153702e86e1b88316885c6a8b78f7f51f3e92874f2dc0a7148e540", + "size": 91211 + }, + { + "url": "https://platform.claude.com/docs/en/api/php/beta/user_profiles/create_enrollment_url", + "status": "success", + "path": "en/api/php/beta/user_profiles/create_enrollment_url.md", + "sha256": "2efb1bba72f9747a8aa158d94e18d8184c8537118079227090537439f5e73301", + "size": 91256 }, { "url": "https://platform.claude.com/docs/en/api/csharp/completions", @@ -3809,15 +4194,15 @@ "url": "https://platform.claude.com/docs/en/api/csharp/messages", "status": "success", "path": "en/api/csharp/messages.md", - "sha256": "39b069d04dea78fa3b7c175a12f17d62e09a16af5ee437f29ba4fae02063a7c9", - "size": 808931 + "sha256": "474cb961c0b20f9623842001640399f7d4449e0cde1a72e8becaa1e38c9ddbd9", + "size": 815102 }, { "url": "https://platform.claude.com/docs/en/api/csharp/messages/create", "status": "success", "path": "en/api/csharp/messages/create.md", - "sha256": "011520ae3c70c440cd8707944bd180a335070f23780c03a64838af6c3c7f709e", - "size": 108043 + "sha256": "7cd054dc7608f748a94aa1079cc3d712f2d4ebfb5833ee361ed29aed7a554ec8", + "size": 108575 }, { "url": "https://platform.claude.com/docs/en/api/csharp/messages/count_tokens", @@ -3830,8 +4215,8 @@ "url": "https://platform.claude.com/docs/en/api/csharp/messages/batches", "status": "success", "path": "en/api/csharp/messages/batches.md", - "sha256": "f874fe68ec6792c963ac5f8508d489fc4458bfb60cc8a0b355c76df7d110fde1", - "size": 222361 + "sha256": "d858129969cf0e93c6b4274fa652005b2351872b7e0441eb0ace1586ae1c9f2f", + "size": 224687 }, { "url": "https://platform.claude.com/docs/en/api/csharp/messages/batches/create", @@ -3872,239 +4257,281 @@ "url": "https://platform.claude.com/docs/en/api/csharp/messages/batches/results", "status": "success", "path": "en/api/csharp/messages/batches/results.md", - "sha256": "0c8c135704e0bc66ddc113b16e0fa24634e5d507ce343e6d1967652ebfc0a9fb", - "size": 25988 + "sha256": "8bea0c495de570d8ea7c84881c5b73192958c471d96c7c28becf4429140c39e6", + "size": 26586 }, { "url": "https://platform.claude.com/docs/en/api/csharp/models", "status": "success", "path": "en/api/csharp/models.md", - "sha256": "2859101400765aed986949b91e024ce5006dca413ab92071dfcc9d47f550b254", - "size": 25464 + "sha256": "8aa979c54b70f3f42d9e28d7cd952c22ea5930f6e0265672a59365cca8abd3a3", + "size": 25688 }, { "url": "https://platform.claude.com/docs/en/api/csharp/models/list", "status": "success", "path": "en/api/csharp/models/list.md", - "sha256": "99dad79bbb951dca903eb05d9f389acc61b37331d32494ffa54db36f84657a06", - "size": 7479 + "sha256": "9f65afaf49bb102609a125b667c16d8d2527b721695e8b66632c412b2170f0e7", + "size": 7591 }, { "url": "https://platform.claude.com/docs/en/api/csharp/models/retrieve", "status": "success", "path": "en/api/csharp/models/retrieve.md", - "sha256": "65749f65adbeb941613be5722a0fb3b1de567d0d2ceb1ceddddbd6bd2b178b39", - "size": 6482 + "sha256": "96f8b613464e22c24acf1faac852cce1da5859c9f1332cce71cc343be390b6ae", + "size": 6594 }, { "url": "https://platform.claude.com/docs/en/api/csharp/beta", "status": "success", "path": "en/api/csharp/beta.md", - "sha256": "bc67100777c6b7bb2954bffddafeddfdf7876927c78503e2b997d18705696a94", - "size": 1065265 + "sha256": "43b12a9d30a6c26db2af11902d85049516fb44e2ae347846edc1840f6c2d8888", + "size": 1087810 }, { "url": "https://platform.claude.com/docs/en/api/csharp/beta/models", "status": "success", "path": "en/api/csharp/beta/models.md", - "sha256": "ece74e433e653facc669cefe9fedb9a3e1c82ae4b06de956101c3159524af2b7", - "size": 25931 + "sha256": "a368432005773f88d37046a62762c380af551f49c3d287b81a8621d9d744d44b", + "size": 26155 }, { "url": "https://platform.claude.com/docs/en/api/csharp/beta/models/list", "status": "success", "path": "en/api/csharp/beta/models/list.md", - "sha256": "0925180268e26a9f42110c3ccc2709d43ac928529c156a17a8f114c6c93d81de", - "size": 7573 + "sha256": "09adf26a995207dd6899bf6f15e5b8f2817277a8351bb0f7fec436daf222ee70", + "size": 7685 }, { "url": "https://platform.claude.com/docs/en/api/csharp/beta/models/retrieve", "status": "success", "path": "en/api/csharp/beta/models/retrieve.md", - "sha256": "6aaf5f07c68f3f7d3437f2197da10cc472d4f89700c233a3e085ba8b70553038", - "size": 6588 + "sha256": "9761e33b9ea22a7a951531e750e541646dc22594d1acb975ea5950969e1e8d1c", + "size": 6700 }, { "url": "https://platform.claude.com/docs/en/api/csharp/beta/messages", "status": "success", "path": "en/api/csharp/beta/messages.md", - "sha256": "feabc57fcd3dbbfddd20c50778604a4a13b60314b22b5af7970a6f48d318fbd8", - "size": 998925 + "sha256": "84d9ec776cd0d4354fa9e042fa09f85960ddc5551da5c8e22c48a0b69c6690e8", + "size": 1006414 }, { "url": "https://platform.claude.com/docs/en/api/csharp/beta/messages/create", "status": "success", "path": "en/api/csharp/beta/messages/create.md", - "sha256": "38f3e6382e70e9cd6b43504a01b80c231b7b9cda38043fc628de084a0e34dd31", - "size": 134589 + "sha256": "16a13400f4a02ac3547f0e33e4a5ed5f27f35f11d21b99e23da4ab96243ec722", + "size": 135400 }, { "url": "https://platform.claude.com/docs/en/api/csharp/beta/messages/count_tokens", "status": "success", "path": "en/api/csharp/beta/messages/count_tokens.md", - "sha256": "ab97907270984127aa41cca662860a7864787baf26bfe25aee5cf9504f88255c", - "size": 103781 + "sha256": "17873469efc1b5e51993d47aafe07b4167b809701f6f1d23b7f64bd99b6aef4e", + "size": 103893 }, { "url": "https://platform.claude.com/docs/en/api/csharp/beta/messages/batches", "status": "success", "path": "en/api/csharp/beta/messages/batches.md", - "sha256": "13881fe3b1d382ce0e02b29a462b8926fa7c02861877284ea5ef0084ce21bd18", - "size": 287261 + "sha256": "a87b4110e203a3258454d688be3d9b2a2c740fa9be4e24f672aec75eac6974cc", + "size": 290485 }, { "url": "https://platform.claude.com/docs/en/api/csharp/beta/messages/batches/create", "status": "success", "path": "en/api/csharp/beta/messages/batches/create.md", - "sha256": "52992f9a450e6d8424c1fd9b326d77bb7b699a689f8ffed0941718456b3ceb94", - "size": 132373 + "sha256": "820f03bfb2c8cf0f7413c1350918a5fc031826a61616d2ad7c48939304f4149f", + "size": 132695 }, { "url": "https://platform.claude.com/docs/en/api/csharp/beta/messages/batches/retrieve", "status": "success", "path": "en/api/csharp/beta/messages/batches/retrieve.md", - "sha256": "2f02a487d4098b5e1f7504cf4753e5506cb83ccf39242ea42489cf97077e3eac", - "size": 5049 + "sha256": "85ecd99515bd6b8dbed589d97b968c3e7b630f4859e49c666864c4050b5fca9f", + "size": 5161 }, { "url": "https://platform.claude.com/docs/en/api/csharp/beta/messages/batches/list", "status": "success", "path": "en/api/csharp/beta/messages/batches/list.md", - "sha256": "dd000172be62477b240aa911c38c9d8c58227b11caa05645ccb18edefd608872", - "size": 5794 + "sha256": "046ab85f7d76b416a7d8695fa7c4bafdb474a800186d5f5d7bac306ada10f405", + "size": 5906 }, { "url": "https://platform.claude.com/docs/en/api/csharp/beta/messages/batches/cancel", "status": "success", "path": "en/api/csharp/beta/messages/batches/cancel.md", - "sha256": "9be58fa1624c693ed3dd1b00e01e4e4789015dbabe0af425d5dd0678950487fc", - "size": 5355 + "sha256": "4bca1f8a36ed5948078524d9bd86ae0a6028d3b380ce51718c2821ba8d7b436a", + "size": 5467 }, { "url": "https://platform.claude.com/docs/en/api/csharp/beta/messages/batches/delete", "status": "success", "path": "en/api/csharp/beta/messages/batches/delete.md", - "sha256": "9bc87017a76dc06279f394d39192bd8de689cc023d9737dab6a80a9c62094404", - "size": 2397 + "sha256": "c0dc7724f62d1845aa08660dca15383bcbc0cfbdcf730c0dafd70fa57d81dfa9", + "size": 2509 }, { "url": "https://platform.claude.com/docs/en/api/csharp/beta/messages/batches/results", "status": "success", "path": "en/api/csharp/beta/messages/batches/results.md", - "sha256": "6de1fdd0f47f502a00980426727fdf790b8296c6334536ec023031c5ffd6d024", - "size": 35879 + "sha256": "0f4074b8d782af5be1b5c2a653fabe38fdbd00e01469d1f14a6561430a5d3a20", + "size": 36593 }, { "url": "https://platform.claude.com/docs/en/api/csharp/beta/files", "status": "success", "path": "en/api/csharp/beta/files.md", - "sha256": "2c5a9f257bb37b9e303217a02047c93ed7108fe3890a3864ff9a082b7bf4d668", - "size": 12609 + "sha256": "05aafb6177333279ce32d8d84b7d224f05a53ee08fa48cc0fcf93076e42b989b", + "size": 13169 }, { "url": "https://platform.claude.com/docs/en/api/csharp/beta/files/upload", "status": "success", "path": "en/api/csharp/beta/files/upload.md", - "sha256": "9d59e4068fc4e7cdbd6406591c61b7073bc683efc9407ffec6b0f519402ccd3c", - "size": 2420 + "sha256": "3d54d6fa3e86565ed338c5619bbfad31c0d017fd6075baf397a4c762edd9a77d", + "size": 2532 }, { "url": "https://platform.claude.com/docs/en/api/csharp/beta/files/list", "status": "success", "path": "en/api/csharp/beta/files/list.md", - "sha256": "8a25bfcae0462fe33aa272ea932d9a7289dd043a4b30ddc90ee4e7f151574187", - "size": 3129 + "sha256": "689751458ecc43515da14f80a29ebaeb4755bf54b7e02e6c1f91975a850adef0", + "size": 3241 }, { "url": "https://platform.claude.com/docs/en/api/csharp/beta/files/download", "status": "success", "path": "en/api/csharp/beta/files/download.md", - "sha256": "93c6972387481aaf3817a2bb12f53665dfe6eecb05dc561efd1b8e7f26a7f076", - "size": 1756 + "sha256": "bfbe6336a3835b971dc0d91fa3bcf65eca9c46df9e4a586847f6c5ccdfa8e6af", + "size": 1868 }, { "url": "https://platform.claude.com/docs/en/api/csharp/beta/files/retrieve_metadata", "status": "success", "path": "en/api/csharp/beta/files/retrieve_metadata.md", - "sha256": "02ade2e4c4f3138b62fb65b9c1f53918fcb940bda29571f05814f75f4fe4f69c", - "size": 2438 + "sha256": "20ba7ae753a68d3e63a9491326894293a88093d21534fa5b6e0b006c7aa52640", + "size": 2550 }, { "url": "https://platform.claude.com/docs/en/api/csharp/beta/files/delete", "status": "success", "path": "en/api/csharp/beta/files/delete.md", - "sha256": "4aff8b3867f991d4ccc6d8d3996b28ece228dee1a7a12d995e4fd65cac1ac132", - "size": 1969 + "sha256": "cb85cf7451f1b21b7dfaa6ec661a733118a033de2e38c014e6aead45ec7fec55", + "size": 2081 }, { "url": "https://platform.claude.com/docs/en/api/csharp/beta/skills", "status": "success", "path": "en/api/csharp/beta/skills.md", - "sha256": "ab11ae485ceb79ee354b8f2ad15eb39e0150ccf5c01fc42483001a6d535811fe", - "size": 24055 + "sha256": "32613d07137229cf038d1760256eb1683796f351e56c2b759cca6ff0becdbbe4", + "size": 24951 }, { "url": "https://platform.claude.com/docs/en/api/csharp/beta/skills/create", "status": "success", "path": "en/api/csharp/beta/skills/create.md", - "sha256": "4a666c02626b531e94f1c578e06ba99c915dd8e5c0ce34504c32e80d05173b8b", - "size": 3015 + "sha256": "8572536b9983748d12dd0102f7964e6001f7b2815b6066b90a443f72dc292b00", + "size": 3127 }, { "url": "https://platform.claude.com/docs/en/api/csharp/beta/skills/list", "status": "success", "path": "en/api/csharp/beta/skills/list.md", - "sha256": "1dc7b6e0e457a83bba16ad6d1940d3f06e8645bdbaefbe6f53da40595e6e5816", - "size": 3760 + "sha256": "a329a4245fba162aaee2f390a1de6c8592d30d34b03d97e0f17ea3fd4a33eaad", + "size": 3872 }, { "url": "https://platform.claude.com/docs/en/api/csharp/beta/skills/retrieve", "status": "success", "path": "en/api/csharp/beta/skills/retrieve.md", - "sha256": "10bcf4146586a612c4462ffd5913cdf2f2a4871466d866f08dde66c1268f81e4", - "size": 2806 + "sha256": "71a4361189bcc8504b414505aabd8c579ac08ee25acf0a9224b0eaabf74ed028", + "size": 2918 }, { "url": "https://platform.claude.com/docs/en/api/csharp/beta/skills/delete", "status": "success", "path": "en/api/csharp/beta/skills/delete.md", - "sha256": "1637ce8517abd8e39fc498de4d5da8f6f395ce0fac19824e9d5316c996092074", - "size": 2092 + "sha256": "efc4412139778e69fde63929953cfc3f0694d290074541c242fac94cf4c8e8af", + "size": 2204 }, { "url": "https://platform.claude.com/docs/en/api/csharp/beta/skills/versions", "status": "success", "path": "en/api/csharp/beta/skills/versions.md", - "sha256": "51f6eac052116ff9057ec9cae879578d8a98414e0ac873d8157c5db7439a8662", - "size": 12368 + "sha256": "c26f396ae8b12082ec1c4f0410b7d115f5d8d45c5cbbe5884422485f484781b8", + "size": 12816 }, { "url": "https://platform.claude.com/docs/en/api/csharp/beta/skills/versions/create", "status": "success", "path": "en/api/csharp/beta/skills/versions/create.md", - "sha256": "35e8c3f6a7cb29605a739b07ce6a18894c70fadfb11dca76ced8cb7a3bed9462", - "size": 3163 + "sha256": "9b618f96a3b4c3eb6b0e8b89e6507b2b254c4cbb20c9129ae27669c748b6d57d", + "size": 3275 }, { "url": "https://platform.claude.com/docs/en/api/csharp/beta/skills/versions/list", "status": "success", "path": "en/api/csharp/beta/skills/versions/list.md", - "sha256": "ab08c153302e1300a76198cbd07373ad4f82f4dfe26c1001697bc61aa6d58e41", - "size": 3588 + "sha256": "b4280740d1810b8fed0b56ac0519e423c7e9af20dbca41111b47478caf5eed5b", + "size": 3700 }, { "url": "https://platform.claude.com/docs/en/api/csharp/beta/skills/versions/retrieve", "status": "success", "path": "en/api/csharp/beta/skills/versions/retrieve.md", - "sha256": "8f39412b366868d34d858df261f3555f4d0ab05484ff54e8801db1021ac5d8a7", - "size": 3180 + "sha256": "c05655ef2d7c1effbfccc354cc6ba9e50867663318d947d19962ca2e15dc5b47", + "size": 3292 }, { "url": "https://platform.claude.com/docs/en/api/csharp/beta/skills/versions/delete", "status": "success", "path": "en/api/csharp/beta/skills/versions/delete.md", - "sha256": "2bb49e0849e801a666adbf7f67c41174bfbec5fb0030342d283430454df3cfc5", - "size": 2422 + "sha256": "71c52bbc8a11e7577cec64d95823a4a7052038662e541aaad8da038ed59a73fd", + "size": 2534 + }, + { + "url": "https://platform.claude.com/docs/en/api/csharp/beta/user_profiles", + "status": "success", + "path": "en/api/csharp/beta/user_profiles.md", + "sha256": "72dacb634f3e0044ea3a93d66a3a1e2ab9904823d165be3d18d44b6025cdd3c7", + "size": 13375 + }, + { + "url": "https://platform.claude.com/docs/en/api/csharp/beta/user_profiles/create", + "status": "success", + "path": "en/api/csharp/beta/user_profiles/create.md", + "sha256": "c6dbeff57b6d7548e3ba88b8593ed6093afc7066dca2dabff1aed1e1df22d3ec", + "size": 2579 + }, + { + "url": "https://platform.claude.com/docs/en/api/csharp/beta/user_profiles/list", + "status": "success", + "path": "en/api/csharp/beta/user_profiles/list.md", + "sha256": "2ddef90904f6cacc8f3ea146e85502fc1c9b34f3c7da639038978480db70d515", + "size": 2656 + }, + { + "url": "https://platform.claude.com/docs/en/api/csharp/beta/user_profiles/retrieve", + "status": "success", + "path": "en/api/csharp/beta/user_profiles/retrieve.md", + "sha256": "5d8c226a262846f84e136bb13b2ec90128e05dc5ba1abe13b15891617e2d7b8b", + "size": 2358 + }, + { + "url": "https://platform.claude.com/docs/en/api/csharp/beta/user_profiles/update", + "status": "success", + "path": "en/api/csharp/beta/user_profiles/update.md", + "sha256": "ed78d701de73b5f7559d2e2ca8d3392d294b38cb535fd9c1b507f055d25f0a06", + "size": 2748 + }, + { + "url": "https://platform.claude.com/docs/en/api/csharp/beta/user_profiles/create_enrollment_url", + "status": "success", + "path": "en/api/csharp/beta/user_profiles/create_enrollment_url.md", + "sha256": "8f8c3a95cadf263ae4af32e882455bf9dc0fa176ce48d5930a90575fad7a7286", + "size": 2221 }, { "url": "https://platform.claude.com/docs/en/api/admin", @@ -4355,8 +4782,8 @@ "url": "https://code.claude.com/docs/en/amazon-bedrock", "status": "success", "path": "en/docs/claude-code/amazon-bedrock.md", - "sha256": "a8a18c76e787924ceac4b47622734026230f0cff255d808c4412a1faf75c54f0", - "size": 13619 + "sha256": "2aad2700aacfe71fc8e731d1a539f3f343fbc33f0c1ae33eec8d8af5849fcc51", + "size": 18181 }, { "url": "https://code.claude.com/docs/en/analytics", @@ -4383,8 +4810,8 @@ "url": "https://code.claude.com/docs/en/changelog", "status": "success", "path": "en/docs/claude-code/changelog.md", - "sha256": "d365ee1da91db3f90ac42c5cd475786dbd0cdde3613d121964d6584b10ae2b5a", - "size": 216493 + "sha256": "934d2c7d2867699dd232bb0f2a846743d5ca32474c2ef5fcd8bfa306d0ab28df", + "size": 219591 }, { "url": "https://code.claude.com/docs/en/channels", @@ -4425,8 +4852,8 @@ "url": "https://code.claude.com/docs/en/claude-directory", "status": "success", "path": "en/docs/claude-code/claude-directory.md", - "sha256": "2785a9cb898aaad2389f3ed4b8e7ea9af3d826998a5923dfb0c1f60c3e5f6093", - "size": 69005 + "sha256": "8ae71b7164b213ab92238bb9238878a6f70c030fcd7ce2fd190aa5081495452b", + "size": 74366 }, { "url": "https://code.claude.com/docs/en/cli-reference", @@ -4439,8 +4866,8 @@ "url": "https://code.claude.com/docs/en/code-review", "status": "success", "path": "en/docs/claude-code/code-review.md", - "sha256": "f824fdd65066ad237747b14581af5efbe2866aaea94f976a2a6bca3f270c4efd", - "size": 17029 + "sha256": "62c6d019e364f80aba9435f1f29e0085955796c88a0081fcf49965111e69c962", + "size": 17794 }, { "url": "https://code.claude.com/docs/en/commands", @@ -4453,8 +4880,8 @@ "url": "https://code.claude.com/docs/en/common-workflows", "status": "success", "path": "en/docs/claude-code/common-workflows.md", - "sha256": "a45511aaddecc8589d1e60b355a7706c86c52e947eab13b48f9e5abbc77b1643", - "size": 39024 + "sha256": "7d3f1797eeda7b186b8e2b503157088cb6652251a8d74d9fd85110ce90f1f6be", + "size": 39179 }, { "url": "https://code.claude.com/docs/en/computer-use", @@ -4467,8 +4894,8 @@ "url": "https://code.claude.com/docs/en/context-window", "status": "success", "path": "en/docs/claude-code/context-window.md", - "sha256": "daec285fc4a260422c86adde169e17fa2fff32e28fdaa969fe8193df308879b3", - "size": 53721 + "sha256": "cce723acfdf5d8c4ebdef81c05dfdff5df6f148d6b2621e4b32dfbd112272b46", + "size": 53739 }, { "url": "https://code.claude.com/docs/en/costs", @@ -4481,8 +4908,8 @@ "url": "https://code.claude.com/docs/en/data-usage", "status": "success", "path": "en/docs/claude-code/data-usage.md", - "sha256": "f4dd0559138e65b8f5c8662e5b240b263824da22d3c8f60eba25398bf6b06be9", - "size": 10671 + "sha256": "9c87929fa542877df182e31f47a54f096bb8d95c651137969d891f921d18f106", + "size": 10850 }, { "url": "https://code.claude.com/docs/en/desktop", @@ -4523,8 +4950,8 @@ "url": "https://code.claude.com/docs/en/env-vars", "status": "success", "path": "en/docs/claude-code/env-vars.md", - "sha256": "bcdb2d5ff64c35c5c010d42e01e2e8ec5491df480c1fee636d2300b11e24e5e5", - "size": 121773 + "sha256": "27f9cb40c0deb24f7a9a040416cf6bf2b0ecbcaef1c6786b94e998245132a2f4", + "size": 123738 }, { "url": "https://code.claude.com/docs/en/fast-mode", @@ -4586,28 +5013,28 @@ "url": "https://code.claude.com/docs/en/hooks", "status": "success", "path": "en/docs/claude-code/hooks.md", - "sha256": "5022f2ae821a5ac377fe78ce4ebcb6e0dbf4a65c7f433cb883eb9acf04ce457f", - "size": 138782 + "sha256": "b16405a51cb4fb5dd8df2502cac257113d89f417e77c1d8173cfc3d8d60af4f9", + "size": 139680 }, { "url": "https://code.claude.com/docs/en/hooks-guide", "status": "success", "path": "en/docs/claude-code/hooks-guide.md", - "sha256": "5dd79ebceb86cafaf77438af4ca8ee737658683d409e082a770a5400948ad458", - "size": 45902 + "sha256": "5ea26444e0f09f14f3c58bb8ccbb44f86d18b8f2c76a4144e6dc941e77b02ba9", + "size": 46340 }, { "url": "https://code.claude.com/docs/en/how-claude-code-works", "status": "success", "path": "en/docs/claude-code/how-claude-code-works.md", - "sha256": "5606dd66e78709fae9d3ea4d07151c9827aff3b33cfedfb09eb8f0700f370099", - "size": 18773 + "sha256": "2014a550fffb07f12680e50d0201c05a3fb8f469638f0a1dc572a627cbdfdc62", + "size": 18956 }, { "url": "https://code.claude.com/docs/en/interactive-mode", "status": "success", "path": "en/docs/claude-code/interactive-mode.md", - "sha256": "34c35f5a18a5605513bae4715047055d63bbad76c7cc26fcff9ddc819c942114", + "sha256": "0b2292d10c66406fa841f82bf4ce7a12a1bef596eb6f401e28c2fd1426b9c37c", "size": 22702 }, { @@ -4621,8 +5048,8 @@ "url": "https://code.claude.com/docs/en/keybindings", "status": "success", "path": "en/docs/claude-code/keybindings.md", - "sha256": "754e1e75d0816e9af130d5c5ecfc1403087228aa4cc291f038e69fa3b25fb1f7", - "size": 17218 + "sha256": "a4b738530691abccde830fe05cbd7e7c44cabe9b335b33b36a4441088ce4067a", + "size": 17324 }, { "url": "https://code.claude.com/docs/en/legal-and-compliance", @@ -4663,8 +5090,8 @@ "url": "https://code.claude.com/docs/en/model-config", "status": "success", "path": "en/docs/claude-code/model-config.md", - "sha256": "bb25f4cfe12d51431d56b1faf106a4ea99139dccf00d49d60b9dc5c3cf70f67b", - "size": 23685 + "sha256": "6937c1172767b4fb1d09699295e41316148180b388d39a6981b2800e925f6805", + "size": 24283 }, { "url": "https://code.claude.com/docs/en/monitoring-usage", @@ -4684,8 +5111,8 @@ "url": "https://code.claude.com/docs/en/output-styles", "status": "success", "path": "en/docs/claude-code/output-styles.md", - "sha256": "1d16f362e7097a01fb09d3f9b0aa828faebbf58393cbbfa4b09663b911afe606", - "size": 5148 + "sha256": "c9caf108261168717520e21b7e937402c713181d977db8873ef3a03ebe21eecd", + "size": 5243 }, { "url": "https://code.claude.com/docs/en/overview", @@ -4726,15 +5153,15 @@ "url": "https://code.claude.com/docs/en/plugins", "status": "success", "path": "en/docs/claude-code/plugins.md", - "sha256": "1f7ab125ec2fa96e97fe96e24b56b3305ef6b703b91c5347b9180e25569693d3", - "size": 18673 + "sha256": "5efa5fb47f1e4d1a204ef8676b5d5c9def5798889c297ed23f6c13a5131aa23b", + "size": 18687 }, { "url": "https://code.claude.com/docs/en/plugins-reference", "status": "success", "path": "en/docs/claude-code/plugins-reference.md", - "sha256": "b8a565234b7a03f9193eb034844921c331efa6108e2d51112d74ad43e3a7e3d9", - "size": 43284 + "sha256": "78fdcc33b99b542f652dee29a4079930f8e79d1699f77e91666623c35241bfa9", + "size": 43968 }, { "url": "https://code.claude.com/docs/en/quickstart", @@ -4845,15 +5272,15 @@ "url": "https://code.claude.com/docs/en/troubleshooting", "status": "success", "path": "en/docs/claude-code/troubleshooting.md", - "sha256": "083d42b5f693a0ea5db315464e1066a743a4bd5b998b1313d8a0e47e919b3ad8", - "size": 37436 + "sha256": "f7ef007ec48e33218701c1300a7cf54b732fd9b77872ff7a60d6066adde99fce", + "size": 39022 }, { "url": "https://code.claude.com/docs/en/ultraplan", "status": "success", "path": "en/docs/claude-code/ultraplan.md", - "sha256": "4d7bc882881c214a8219b1550b4d3d2bfcf664641fe8c6d814453da89e5f0b2d", - "size": 5810 + "sha256": "5c8508b004e8e8b0b734a4f8fb4e6eb946926c6f313dfec6cd9d26d60387c5ba", + "size": 5998 }, { "url": "https://code.claude.com/docs/en/voice-dictation", @@ -4866,8 +5293,8 @@ "url": "https://code.claude.com/docs/en/vs-code", "status": "success", "path": "en/docs/claude-code/vs-code.md", - "sha256": "abf2466e75ff8f12428d7134ce4b7c41cc50af5197fcdd8b0922298587a00a13", - "size": 37839 + "sha256": "073dbe9429a3d8d29e878390f030b6723adc19c818bf112ceacd828b27f351cb", + "size": 37867 }, { "url": "https://code.claude.com/docs/en/web-scheduled-tasks", @@ -4915,14 +5342,14 @@ "url": "https://www.anthropic.com/engineering/claude-code-best-practices", "status": "success", "path": "blog/engineering/claude-code-best-practices.md", - "sha256": "f7132623e5da71c6f87dab930ce05f3c0f1478938518a8d64dd5a421a5ed6f3a", - "size": 18747 + "sha256": "876799d698588cb1a619231d985430633e66823e6bb77dd6f55d6e48fe28a4b3", + "size": 43860 }, { "url": "https://www.anthropic.com/engineering/claude-code-sandboxing", "status": "success", "path": "blog/engineering/claude-code-sandboxing.md", - "sha256": "65cdb3faa09a3cba3e0887610aaa07e80307fb09fd5a98c54a8919cf95ee4716", + "sha256": "ec74dc9ac2caa00489c33665c1ab3ea238127a79361e371fb0a294a81d8f088f", "size": 8687 }, { @@ -4962,8 +5389,8 @@ } ], "summary": { - "total": 708, - "downloaded": 708, + "total": 769, + "downloaded": 769, "skipped": 0, "failed": 0, "success_rate": 100.0 diff --git a/content/CHANGELOG.md b/content/CHANGELOG.md index 81f60c190..b60430972 100644 --- a/content/CHANGELOG.md +++ b/content/CHANGELOG.md @@ -1,5 +1,37 @@ # Changelog +## 2.1.96 + +- Fixed Bedrock requests failing with `403 "Authorization header is missing"` when using `AWS_BEARER_TOKEN_BEDROCK` or `CLAUDE_CODE_SKIP_BEDROCK_AUTH` (regression in 2.1.94) + +## 2.1.94 + +- Added support for Amazon Bedrock powered by Mantle, set `CLAUDE_CODE_USE_MANTLE=1` +- Changed default effort level from medium to high for API-key, Bedrock/Vertex/Foundry, Team, and Enterprise users (control this with `/effort`) +- Added compact `Slacked #channel` header with a clickable channel link for Slack MCP send-message tool calls +- Added `keep-coding-instructions` frontmatter field support for plugin output styles +- Added `hookSpecificOutput.sessionTitle` to `UserPromptSubmit` hooks for setting the session title +- Plugin skills declared via `"skills": ["./"]` now use the skill's frontmatter `name` for the invocation name instead of the directory basename, giving a stable name across install methods +- Fixed agents appearing stuck after a 429 rate-limit response with a long Retry-After header — the error now surfaces immediately instead of silently waiting +- Fixed Console login on macOS silently failing with "Not logged in" when the login keychain is locked or its password is out of sync — the error is now surfaced and `claude doctor` diagnoses the fix +- Fixed plugin skill hooks defined in YAML frontmatter being silently ignored +- Fixed plugin hooks failing with "No such file or directory" when `CLAUDE_PLUGIN_ROOT` was not set +- Fixed `${CLAUDE_PLUGIN_ROOT}` resolving to the marketplace source directory instead of the installed cache for local-marketplace plugins on startup +- Fixed scrollback showing the same diff repeated and blank pages in long-running sessions +- Fixed multiline user prompts in the transcript indenting wrapped lines under the `❯` caret instead of under the text +- Fixed Shift+Space inserting the literal word "space" instead of a space character in search inputs +- Fixed hyperlinks opening two browser tabs when clicked inside tmux running in an xterm.js-based terminal (VS Code, Hyper, Tabby) +- Fixed an alt-screen rendering bug where content height changes mid-scroll could leave compounding ghost lines +- Fixed `FORCE_HYPERLINK` environment variable being ignored when set via `settings.json` `env` +- Fixed native terminal cursor not tracking the selected tab in dialogs, so screen readers and magnifiers can follow tab navigation +- Fixed Bedrock invocation of Sonnet 3.5 v2 by using the `us.` inference profile ID +- Fixed SDK/print mode not preserving the partial assistant response in conversation history when interrupted mid-stream +- Improved `--resume` to resume sessions from other worktrees of the same repo directly instead of printing a `cd` command +- Fixed CJK and other multibyte text being corrupted with U+FFFD in stream-json input/output when chunk boundaries split a UTF-8 sequence +- [VSCode] Reduced cold-open subprocess work on starting a session +- [VSCode] Fixed dropdown menus selecting the wrong item when the mouse was over the list while typing or using arrow keys +- [VSCode] Added a warning banner when `settings.json` files fail to parse, so users know their permission rules are not being applied + ## 2.1.92 - Added `forceRemoteSettingsRefresh` policy setting: when set, the CLI blocks startup until remote managed settings are freshly fetched, and exits if the fetch fails (fail-closed) diff --git a/content/blog/engineering/claude-code-best-practices.md b/content/blog/engineering/claude-code-best-practices.md index ca1ab93d8..97d5308c6 100644 --- a/content/blog/engineering/claude-code-best-practices.md +++ b/content/blog/engineering/claude-code-best-practices.md @@ -1,9 +1,9 @@ -Title: Claude Code overview - Claude Code Docs +Title: Best Practices for Claude Code - Claude Code Docs URL Source: https://www.anthropic.com/engineering/claude-code-best-practices Markdown Content: -# Claude Code overview - Claude Code Docs +# Best Practices for Claude Code - Claude Code Docs [Skip to main content](https://www.anthropic.com/engineering/claude-code-best-practices#content-area) @@ -25,9 +25,9 @@ Search... Navigation -Getting started +Use Claude Code -Claude Code overview +Best Practices for Claude Code [Getting started](https://www.anthropic.com/docs/en/overview)[Build with Claude Code](https://www.anthropic.com/docs/en/sub-agents)[Deployment](https://www.anthropic.com/docs/en/third-party-integrations)[Administration](https://www.anthropic.com/docs/en/setup)[Configuration](https://www.anthropic.com/docs/en/settings)[Reference](https://www.anthropic.com/docs/en/cli-reference)[What's New](https://www.anthropic.com/docs/en/whats-new)[Resources](https://www.anthropic.com/docs/en/legal-and-compliance) @@ -66,210 +66,608 @@ Claude Code overview On this page -* [Get started](https://www.anthropic.com/engineering/claude-code-best-practices#get-started) -* [What you can do](https://www.anthropic.com/engineering/claude-code-best-practices#what-you-can-do) -* [Use Claude Code everywhere](https://www.anthropic.com/engineering/claude-code-best-practices#use-claude-code-everywhere) -* [Next steps](https://www.anthropic.com/engineering/claude-code-best-practices#next-steps) +* [Give Claude a way to verify its work](https://www.anthropic.com/engineering/claude-code-best-practices#give-claude-a-way-to-verify-its-work) +* [Explore first, then plan, then code](https://www.anthropic.com/engineering/claude-code-best-practices#explore-first-then-plan-then-code) +* [Provide specific context in your prompts](https://www.anthropic.com/engineering/claude-code-best-practices#provide-specific-context-in-your-prompts) +* [Provide rich content](https://www.anthropic.com/engineering/claude-code-best-practices#provide-rich-content) +* [Configure your environment](https://www.anthropic.com/engineering/claude-code-best-practices#configure-your-environment) +* [Write an effective CLAUDE.md](https://www.anthropic.com/engineering/claude-code-best-practices#write-an-effective-claude-md) +* [Configure permissions](https://www.anthropic.com/engineering/claude-code-best-practices#configure-permissions) +* [Use CLI tools](https://www.anthropic.com/engineering/claude-code-best-practices#use-cli-tools) +* [Connect MCP servers](https://www.anthropic.com/engineering/claude-code-best-practices#connect-mcp-servers) +* [Set up hooks](https://www.anthropic.com/engineering/claude-code-best-practices#set-up-hooks) +* [Create skills](https://www.anthropic.com/engineering/claude-code-best-practices#create-skills) +* [Create custom subagents](https://www.anthropic.com/engineering/claude-code-best-practices#create-custom-subagents) +* [Install plugins](https://www.anthropic.com/engineering/claude-code-best-practices#install-plugins) +* [Communicate effectively](https://www.anthropic.com/engineering/claude-code-best-practices#communicate-effectively) +* [Ask codebase questions](https://www.anthropic.com/engineering/claude-code-best-practices#ask-codebase-questions) +* [Let Claude interview you](https://www.anthropic.com/engineering/claude-code-best-practices#let-claude-interview-you) +* [Manage your session](https://www.anthropic.com/engineering/claude-code-best-practices#manage-your-session) +* [Course-correct early and often](https://www.anthropic.com/engineering/claude-code-best-practices#course-correct-early-and-often) +* [Manage context aggressively](https://www.anthropic.com/engineering/claude-code-best-practices#manage-context-aggressively) +* [Use subagents for investigation](https://www.anthropic.com/engineering/claude-code-best-practices#use-subagents-for-investigation) +* [Rewind with checkpoints](https://www.anthropic.com/engineering/claude-code-best-practices#rewind-with-checkpoints) +* [Resume conversations](https://www.anthropic.com/engineering/claude-code-best-practices#resume-conversations) +* [Automate and scale](https://www.anthropic.com/engineering/claude-code-best-practices#automate-and-scale) +* [Run non-interactive mode](https://www.anthropic.com/engineering/claude-code-best-practices#run-non-interactive-mode) +* [Run multiple Claude sessions](https://www.anthropic.com/engineering/claude-code-best-practices#run-multiple-claude-sessions) +* [Fan out across files](https://www.anthropic.com/engineering/claude-code-best-practices#fan-out-across-files) +* [Run autonomously with auto mode](https://www.anthropic.com/engineering/claude-code-best-practices#run-autonomously-with-auto-mode) +* [Avoid common failure patterns](https://www.anthropic.com/engineering/claude-code-best-practices#avoid-common-failure-patterns) +* [Develop your intuition](https://www.anthropic.com/engineering/claude-code-best-practices#develop-your-intuition) +* [Related resources](https://www.anthropic.com/engineering/claude-code-best-practices#related-resources) + +Use Claude Code + +# Best Practices for Claude Code -Getting started +Copy page -# Claude Code overview +Tips and patterns for getting the most out of Claude Code, from configuring your environment to scaling across parallel sessions. Copy page -Claude Code is an agentic coding tool that reads your codebase, edits files, runs commands, and integrates with your development tools. Available in your terminal, IDE, desktop app, and browser. +Claude Code is an agentic coding environment. Unlike a chatbot that answers questions and waits, Claude Code can read your files, run commands, make changes, and autonomously work through problems while you watch, redirect, or step away entirely.This changes how you work. Instead of writing code yourself and asking Claude to review it, you describe what you want and Claude figures out how to build it. Claude explores, plans, and implements.But this autonomy still comes with a learning curve. Claude works within certain constraints you need to understand.This guide covers patterns that have proven effective across Anthropic’s internal teams and for engineers using Claude Code across various codebases, languages, and environments. For how the agentic loop works under the hood, see [How Claude Code works](https://www.anthropic.com/docs/en/how-claude-code-works). -Copy page +* * * + +Most best practices are based on one constraint: Claude’s context window fills up fast, and performance degrades as it fills.Claude’s context window holds your entire conversation, including every message, every file Claude reads, and every command output. However, this can fill up fast. A single debugging session or codebase exploration might generate and consume tens of thousands of tokens.This matters since LLM performance degrades as context fills. When the context window is getting full, Claude may start “forgetting” earlier instructions or making more mistakes. The context window is the most important resource to manage. To see how a session fills up in practice, [watch an interactive walkthrough](https://www.anthropic.com/docs/en/context-window) of what loads at startup and what each file read costs. Track context usage continuously with a [custom status line](https://www.anthropic.com/docs/en/statusline), and see [Reduce token usage](https://www.anthropic.com/docs/en/costs#reduce-token-usage) for strategies on reducing token usage. + +* * * + +## [​](https://www.anthropic.com/engineering/claude-code-best-practices#give-claude-a-way-to-verify-its-work) + +Give Claude a way to verify its work + +Include tests, screenshots, or expected outputs so Claude can check itself. This is the single highest-leverage thing you can do. + +Claude performs dramatically better when it can verify its own work, like run tests, compare screenshots, and validate outputs.Without clear success criteria, it might produce something that looks right but actually doesn’t work. You become the only feedback loop, and every mistake requires your attention. + +| Strategy | Before | After | +| --- | --- | --- | +| **Provide verification criteria** | _”implement a function that validates email addresses"_ | _"write a validateEmail function. example test cases: [[email protected]](https://www.anthropic.com/cdn-cgi/l/email-protection#7005031502301508111d001c155e131f1d) is true, invalid is false, [[email protected]](https://www.anthropic.com/cdn-cgi/l/email-protection#b8cdcbddcaf896dbd7d5) is false. run the tests after implementing”_ | +| **Verify UI changes visually** | _”make the dashboard look better"_ | _"[paste screenshot] implement this design. take a screenshot of the result and compare it to the original. list differences and fix them”_ | +| **Address root causes, not symptoms** | _”the build is failing"_ | _"the build fails with this error: [paste error]. fix it and verify the build succeeds. address the root cause, don’t suppress the error”_ | + +UI changes can be verified using the [Claude in Chrome extension](https://www.anthropic.com/docs/en/chrome). It opens new tabs in your browser, tests the UI, and iterates until the code works.Your verification can also be a test suite, a linter, or a Bash command that checks output. Invest in making your verification rock-solid. -Claude Code is an AI-powered coding assistant that helps you build features, fix bugs, and automate development tasks. It understands your entire codebase and can work across multiple files and tools to get things done. -## [​](https://www.anthropic.com/engineering/claude-code-best-practices#get-started) +* * * -Get started +## [​](https://www.anthropic.com/engineering/claude-code-best-practices#explore-first-then-plan-then-code) -Choose your environment to get started. Most surfaces require a [Claude subscription](https://claude.com/pricing?utm_source=claude_code&utm_medium=docs&utm_content=overview_pricing) or [Anthropic Console](https://console.anthropic.com/) account. The Terminal CLI and VS Code also support [third-party providers](https://www.anthropic.com/docs/en/third-party-integrations). +Explore first, then plan, then code -* Terminal -* VS Code -* Desktop app -* Web -* JetBrains +Separate research and planning from implementation to avoid solving the wrong problem. -The full-featured CLI for working with Claude Code directly in your terminal. Edit files, run commands, and manage your entire project from the command line.To install Claude Code, use one of the following methods: +Letting Claude jump straight to coding can produce code that solves the wrong problem. Use [Plan Mode](https://www.anthropic.com/docs/en/common-workflows#use-plan-mode-for-safe-code-analysis) to separate exploration from execution.The recommended workflow has four phases: -* Native Install (Recommended) -* Homebrew -* WinGet +1 -**macOS, Linux, WSL:** +[](https://www.anthropic.com/engineering/claude-code-best-practices#) + +Explore + +Enter Plan Mode. Claude reads files and answers questions without making changes. + +claude (Plan Mode) ``` -curl -fsSL https://claude.ai/install.sh | bash +read /src/auth and understand how we handle sessions and login. +also look at how we manage environment variables for secrets. ``` -**Windows PowerShell:** +2 + +[](https://www.anthropic.com/engineering/claude-code-best-practices#) + +Plan + +Ask Claude to create a detailed implementation plan. + +claude (Plan Mode) ``` -irm https://claude.ai/install.ps1 | iex +I want to add Google OAuth. What files need to change? +What's the session flow? Create a plan. ``` -**Windows CMD:** +Press `Ctrl+G` to open the plan in your text editor for direct editing before Claude proceeds. + +3 + +[](https://www.anthropic.com/engineering/claude-code-best-practices#) + +Implement + +Switch back to Normal Mode and let Claude code, verifying against its plan. + +claude (Normal Mode) ``` -curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd +implement the OAuth flow from your plan. write tests for the +callback handler, run the test suite and fix any failures. ``` -If you see `The token '&&' is not a valid statement separator`, you’re in PowerShell, not CMD. Use the PowerShell command above instead. Your prompt shows `PS C:\` when you’re in PowerShell.**Windows requires [Git for Windows](https://git-scm.com/downloads/win).** Install it first if you don’t have it. +4 + +[](https://www.anthropic.com/engineering/claude-code-best-practices#) + +Commit + +Ask Claude to commit with a descriptive message and create a PR. -Native installations automatically update in the background to keep you on the latest version. +claude (Normal Mode) ``` -brew install --cask claude-code +commit with a descriptive message and open a PR ``` -Homebrew installations do not auto-update. Run `brew upgrade claude-code` periodically to get the latest features and security fixes. +Plan Mode is useful, but also adds overhead.For tasks where the scope is clear and the fix is small (like fixing a typo, adding a log line, or renaming a variable) ask Claude to do it directly.Planning is most useful when you’re uncertain about the approach, when the change modifies multiple files, or when you’re unfamiliar with the code being modified. If you could describe the diff in one sentence, skip the plan. + +* * * + +## [​](https://www.anthropic.com/engineering/claude-code-best-practices#provide-specific-context-in-your-prompts) + +Provide specific context in your prompts + +The more precise your instructions, the fewer corrections you’ll need. + +Claude can infer intent, but it can’t read your mind. Reference specific files, mention constraints, and point to example patterns. + +| Strategy | Before | After | +| --- | --- | --- | +| **Scope the task.** Specify which file, what scenario, and testing preferences. | _”add tests for foo.py"_ | _"write a test for foo.py covering the edge case where the user is logged out. avoid mocks.”_ | +| **Point to sources.** Direct Claude to the source that can answer a question. | _”why does ExecutionFactory have such a weird api?"_ | _"look through ExecutionFactory’s git history and summarize how its api came to be”_ | +| **Reference existing patterns.** Point Claude to patterns in your codebase. | _”add a calendar widget"_ | _"look at how existing widgets are implemented on the home page to understand the patterns. HotDogWidget.php is a good example. follow the pattern to implement a new calendar widget that lets the user select a month and paginate forwards/backwards to pick a year. build from scratch without libraries other than the ones already used in the codebase.”_ | +| **Describe the symptom.** Provide the symptom, the likely location, and what “fixed” looks like. | _”fix the login bug"_ | _"users report that login fails after session timeout. check the auth flow in src/auth/, especially token refresh. write a failing test that reproduces the issue, then fix it”_ | + +Vague prompts can be useful when you’re exploring and can afford to course-correct. A prompt like `"what would you improve in this file?"` can surface things you wouldn’t have thought to ask about. +### [​](https://www.anthropic.com/engineering/claude-code-best-practices#provide-rich-content) + +Provide rich content + +Use `@` to reference files, paste screenshots/images, or pipe data directly. + +You can provide rich data to Claude in several ways: +* **Reference files with `@`** instead of describing where code lives. Claude reads the file before responding. +* **Paste images directly**. Copy/paste or drag and drop images into the prompt. +* **Give URLs** for documentation and API references. Use `/permissions` to allowlist frequently-used domains. +* **Pipe in data** by running `cat error.log | claude` to send file contents directly. +* **Let Claude fetch what it needs**. Tell Claude to pull context itself using Bash commands, MCP tools, or by reading files. + +* * * + +## [​](https://www.anthropic.com/engineering/claude-code-best-practices#configure-your-environment) + +Configure your environment + +A few setup steps make Claude Code significantly more effective across all your sessions. For a full overview of extension features and when to use each one, see [Extend Claude Code](https://www.anthropic.com/docs/en/features-overview). +### [​](https://www.anthropic.com/engineering/claude-code-best-practices#write-an-effective-claude-md) + +Write an effective CLAUDE.md + +Run `/init` to generate a starter CLAUDE.md file based on your current project structure, then refine over time. + +CLAUDE.md is a special file that Claude reads at the start of every conversation. Include Bash commands, code style, and workflow rules. This gives Claude persistent context it can’t infer from code alone.The `/init` command analyzes your codebase to detect build systems, test frameworks, and code patterns, giving you a solid foundation to refine.There’s no required format for CLAUDE.md files, but keep it short and human-readable. For example: + +CLAUDE.md ``` -winget install Anthropic.ClaudeCode +# Code style +- Use ES modules (import/export) syntax, not CommonJS (require) +- Destructure imports when possible (eg. import { foo } from 'bar') + +# Workflow +- Be sure to typecheck when you're done making a series of code changes +- Prefer running single tests, and not the whole test suite, for performance ``` -WinGet installations do not auto-update. Run `winget upgrade Anthropic.ClaudeCode` periodically to get the latest features and security fixes. +CLAUDE.md is loaded every session, so only include things that apply broadly. For domain knowledge or workflows that are only relevant sometimes, use [skills](https://www.anthropic.com/docs/en/skills) instead. Claude loads them on demand without bloating every conversation.Keep it concise. For each line, ask: _“Would removing this cause Claude to make mistakes?”_ If not, cut it. Bloated CLAUDE.md files cause Claude to ignore your actual instructions! -Then start Claude Code in any project: +| ✅ Include | ❌ Exclude | +| --- | --- | +| Bash commands Claude can’t guess | Anything Claude can figure out by reading code | +| Code style rules that differ from defaults | Standard language conventions Claude already knows | +| Testing instructions and preferred test runners | Detailed API documentation (link to docs instead) | +| Repository etiquette (branch naming, PR conventions) | Information that changes frequently | +| Architectural decisions specific to your project | Long explanations or tutorials | +| Developer environment quirks (required env vars) | File-by-file descriptions of the codebase | +| Common gotchas or non-obvious behaviors | Self-evident practices like “write clean code” | + +If Claude keeps doing something you don’t want despite having a rule against it, the file is probably too long and the rule is getting lost. If Claude asks you questions that are answered in CLAUDE.md, the phrasing might be ambiguous. Treat CLAUDE.md like code: review it when things go wrong, prune it regularly, and test changes by observing whether Claude’s behavior actually shifts.You can tune instructions by adding emphasis (e.g., “IMPORTANT” or “YOU MUST”) to improve adherence. Check CLAUDE.md into git so your team can contribute. The file compounds in value over time.CLAUDE.md files can import additional files using `@path/to/import` syntax: + +CLAUDE.md ``` -cd your-project -claude +See @README.md for project overview and @package.json for available npm commands. + +# Additional Instructions +- Git workflow: @docs/git-instructions.md +- Personal overrides: @~/.claude/my-project-instructions.md ``` -You’ll be prompted to log in on first use. That’s it! [Continue with the Quickstart →](https://www.anthropic.com/docs/en/quickstart) +You can place CLAUDE.md files in several locations: +* **Home folder (`~/.claude/CLAUDE.md`)**: applies to all Claude sessions +* **Project root (`./CLAUDE.md`)**: check into git to share with your team +* **Project root (`./CLAUDE.local.md`)**: personal project-specific notes; add this file to your `.gitignore` so it isn’t shared with your team +* **Parent directories**: useful for monorepos where both `root/CLAUDE.md` and `root/foo/CLAUDE.md` are pulled in automatically +* **Child directories**: Claude pulls in child CLAUDE.md files on demand when working with files in those directories + +### [​](https://www.anthropic.com/engineering/claude-code-best-practices#configure-permissions) + +Configure permissions + +Use [auto mode](https://www.anthropic.com/docs/en/permission-modes#eliminate-prompts-with-auto-mode) to let a classifier handle approvals, `/permissions` to allowlist specific commands, or `/sandbox` for OS-level isolation. Each reduces interruptions while keeping you in control. + +By default, Claude Code requests permission for actions that might modify your system: file writes, Bash commands, MCP tools, etc. This is safe but tedious. After the tenth approval you’re not really reviewing anymore, you’re just clicking through. There are three ways to reduce these interruptions: +* **Auto mode**: a separate classifier model reviews commands and blocks only what looks risky: scope escalation, unknown infrastructure, or hostile-content-driven actions. Best when you trust the general direction of a task but don’t want to click through every step +* **Permission allowlists**: permit specific tools you know are safe, like `npm run lint` or `git commit` +* **Sandboxing**: enable OS-level isolation that restricts filesystem and network access, allowing Claude to work more freely within defined boundaries + +Read more about [permission modes](https://www.anthropic.com/docs/en/permission-modes), [permission rules](https://www.anthropic.com/docs/en/permissions), and [sandboxing](https://www.anthropic.com/docs/en/sandboxing). +### [​](https://www.anthropic.com/engineering/claude-code-best-practices#use-cli-tools) + +Use CLI tools + +Tell Claude Code to use CLI tools like `gh`, `aws`, `gcloud`, and `sentry-cli` when interacting with external services. + +CLI tools are the most context-efficient way to interact with external services. If you use GitHub, install the `gh` CLI. Claude knows how to use it for creating issues, opening pull requests, and reading comments. Without `gh`, Claude can still use the GitHub API, but unauthenticated requests often hit rate limits.Claude is also effective at learning CLI tools it doesn’t already know. Try prompts like `Use 'foo-cli-tool --help' to learn about foo tool, then use it to solve A, B, C.` +### [​](https://www.anthropic.com/engineering/claude-code-best-practices#connect-mcp-servers) + +Connect MCP servers + +Run `claude mcp add` to connect external tools like Notion, Figma, or your database. -See [advanced setup](https://www.anthropic.com/docs/en/setup) for installation options, manual updates, or uninstallation instructions. Visit [troubleshooting](https://www.anthropic.com/docs/en/troubleshooting) if you hit issues. +With [MCP servers](https://www.anthropic.com/docs/en/mcp), you can ask Claude to implement features from issue trackers, query databases, analyze monitoring data, integrate designs from Figma, and automate workflows. +### [​](https://www.anthropic.com/engineering/claude-code-best-practices#set-up-hooks) -The VS Code extension provides inline diffs, @-mentions, plan review, and conversation history directly in your editor. -* [Install for VS Code](vscode:extension/anthropic.claude-code) -* [Install for Cursor](cursor:extension/anthropic.claude-code) +Set up hooks -Or search for “Claude Code” in the Extensions view (`Cmd+Shift+X` on Mac, `Ctrl+Shift+X` on Windows/Linux). After installing, open the Command Palette (`Cmd+Shift+P` / `Ctrl+Shift+P`), type “Claude Code”, and select **Open in New Tab**.[Get started with VS Code →](https://www.anthropic.com/docs/en/vs-code#get-started) +Use hooks for actions that must happen every time with zero exceptions. -A standalone app for running Claude Code outside your IDE or terminal. Review diffs visually, run multiple sessions side by side, schedule recurring tasks, and kick off cloud sessions.Download and install: -* [macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code&utm_medium=docs) (Intel and Apple Silicon) -* [Windows](https://claude.ai/api/desktop/win32/x64/setup/latest/redirect?utm_source=claude_code&utm_medium=docs) (x64) -* [Windows ARM64](https://claude.ai/api/desktop/win32/arm64/setup/latest/redirect?utm_source=claude_code&utm_medium=docs) (remote sessions only) +[Hooks](https://www.anthropic.com/docs/en/hooks-guide) run scripts automatically at specific points in Claude’s workflow. Unlike CLAUDE.md instructions which are advisory, hooks are deterministic and guarantee the action happens.Claude can write hooks for you. Try prompts like _“Write a hook that runs eslint after every file edit”_ or _“Write a hook that blocks writes to the migrations folder.”_ Edit `.claude/settings.json` directly to configure hooks by hand, and run `/hooks` to browse what’s configured. +### [​](https://www.anthropic.com/engineering/claude-code-best-practices#create-skills) -After installing, launch Claude, sign in, and click the **Code** tab to start coding. A [paid subscription](https://claude.com/pricing?utm_source=claude_code&utm_medium=docs&utm_content=overview_desktop_pricing) is required.[Learn more about the desktop app →](https://www.anthropic.com/docs/en/desktop-quickstart) +Create skills -Run Claude Code in your browser with no local setup. Kick off long-running tasks and check back when they’re done, work on repos you don’t have locally, or run multiple tasks in parallel. Available on desktop browsers and the Claude iOS app.Start coding at [claude.ai/code](https://claude.ai/code).[Get started on the web →](https://www.anthropic.com/docs/en/claude-code-on-the-web#getting-started) +Create `SKILL.md` files in `.claude/skills/` to give Claude domain knowledge and reusable workflows. -A plugin for IntelliJ IDEA, PyCharm, WebStorm, and other JetBrains IDEs with interactive diff viewing and selection context sharing.Install the [Claude Code plugin](https://plugins.jetbrains.com/plugin/27310-claude-code-beta-) from the JetBrains Marketplace and restart your IDE.[Get started with JetBrains →](https://www.anthropic.com/docs/en/jetbrains) +[Skills](https://www.anthropic.com/docs/en/skills) extend Claude’s knowledge with information specific to your project, team, or domain. Claude applies them automatically when relevant, or you can invoke them directly with `/skill-name`.Create a skill by adding a directory with a `SKILL.md` to `.claude/skills/`: -## [​](https://www.anthropic.com/engineering/claude-code-best-practices#what-you-can-do) +.claude/skills/api-conventions/SKILL.md -What you can do +``` +--- +name: api-conventions +description: REST API design conventions for our services +--- +# API Conventions +- Use kebab-case for URL paths +- Use camelCase for JSON properties +- Always include pagination for list endpoints +- Version APIs in the URL path (/v1/, /v2/) +``` + +Skills can also define repeatable workflows you invoke directly: + +.claude/skills/fix-issue/SKILL.md + +``` +--- +name: fix-issue +description: Fix a GitHub issue +disable-model-invocation: true +--- +Analyze and fix the GitHub issue: $ARGUMENTS. + +1. Use `gh issue view` to get the issue details +2. Understand the problem described in the issue +3. Search the codebase for relevant files +4. Implement the necessary changes to fix the issue +5. Write and run tests to verify the fix +6. Ensure code passes linting and type checking +7. Create a descriptive commit message +8. Push and create a PR +``` + +Run `/fix-issue 1234` to invoke it. Use `disable-model-invocation: true` for workflows with side effects that you want to trigger manually. +### [​](https://www.anthropic.com/engineering/claude-code-best-practices#create-custom-subagents) -Here are some of the ways you can use Claude Code: +Create custom subagents -Automate the work you keep putting off +Define specialized assistants in `.claude/agents/` that Claude can delegate to for isolated tasks. -Claude Code handles the tedious tasks that eat up your day: writing tests for untested code, fixing lint errors across a project, resolving merge conflicts, updating dependencies, and writing release notes. +[Subagents](https://www.anthropic.com/docs/en/sub-agents) run in their own context with their own set of allowed tools. They’re useful for tasks that read many files or need specialized focus without cluttering your main conversation. + +.claude/agents/security-reviewer.md ``` -claude "write tests for the auth module, run them, and fix any failures" +--- +name: security-reviewer +description: Reviews code for security vulnerabilities +tools: Read, Grep, Glob, Bash +model: opus +--- +You are a senior security engineer. Review code for: +- Injection vulnerabilities (SQL, XSS, command injection) +- Authentication and authorization flaws +- Secrets or credentials in code +- Insecure data handling + +Provide specific line references and suggested fixes. ``` -Build features and fix bugs +Tell Claude to use subagents explicitly: _“Use a subagent to review this code for security issues.”_ +### [​](https://www.anthropic.com/engineering/claude-code-best-practices#install-plugins) + +Install plugins + +Run `/plugin` to browse the marketplace. Plugins add skills, tools, and integrations without configuration. + +[Plugins](https://www.anthropic.com/docs/en/plugins) bundle skills, hooks, subagents, and MCP servers into a single installable unit from the community and Anthropic. If you work with a typed language, install a [code intelligence plugin](https://www.anthropic.com/docs/en/discover-plugins#code-intelligence) to give Claude precise symbol navigation and automatic error detection after edits.For guidance on choosing between skills, subagents, hooks, and MCP, see [Extend Claude Code](https://www.anthropic.com/docs/en/features-overview#match-features-to-your-goal). + +* * * + +## [​](https://www.anthropic.com/engineering/claude-code-best-practices#communicate-effectively) + +Communicate effectively + +The way you communicate with Claude Code significantly impacts the quality of results. +### [​](https://www.anthropic.com/engineering/claude-code-best-practices#ask-codebase-questions) + +Ask codebase questions + +Ask Claude questions you’d ask a senior engineer. + +When onboarding to a new codebase, use Claude Code for learning and exploration. You can ask Claude the same sorts of questions you would ask another engineer: +* How does logging work? +* How do I make a new API endpoint? +* What does `async move { ... }` do on line 134 of `foo.rs`? +* What edge cases does `CustomerOnboardingFlowImpl` handle? +* Why does this code call `foo()` instead of `bar()` on line 333? -Describe what you want in plain language. Claude Code plans the approach, writes the code across multiple files, and verifies it works.For bugs, paste an error message or describe the symptom. Claude Code traces the issue through your codebase, identifies the root cause, and implements a fix. See [common workflows](https://www.anthropic.com/docs/en/common-workflows) for more examples. +Using Claude Code this way is an effective onboarding workflow, improving ramp-up time and reducing load on other engineers. No special prompting required: ask questions directly. +### [​](https://www.anthropic.com/engineering/claude-code-best-practices#let-claude-interview-you) -Create commits and pull requests +Let Claude interview you -Claude Code works directly with git. It stages changes, writes commit messages, creates branches, and opens pull requests. +For larger features, have Claude interview you first. Start with a minimal prompt and ask Claude to interview you using the `AskUserQuestion` tool. + +Claude asks about things you might not have considered yet, including technical implementation, UI/UX, edge cases, and tradeoffs. ``` -claude "commit my changes with a descriptive message" +I want to build [brief description]. Interview me in detail using the AskUserQuestion tool. + +Ask about technical implementation, UI/UX, edge cases, concerns, and tradeoffs. Don't ask obvious questions, dig into the hard parts I might not have considered. + +Keep interviewing until we've covered everything, then write a complete spec to SPEC.md. ``` -In CI, you can automate code review and issue triage with [GitHub Actions](https://www.anthropic.com/docs/en/github-actions) or [GitLab CI/CD](https://www.anthropic.com/docs/en/gitlab-ci-cd). +Once the spec is complete, start a fresh session to execute it. The new session has clean context focused entirely on implementation, and you have a written spec to reference. + +* * * + +## [​](https://www.anthropic.com/engineering/claude-code-best-practices#manage-your-session) + +Manage your session + +Conversations are persistent and reversible. Use this to your advantage! +### [​](https://www.anthropic.com/engineering/claude-code-best-practices#course-correct-early-and-often) + +Course-correct early and often + +Correct Claude as soon as you notice it going off track. + +The best results come from tight feedback loops. Though Claude occasionally solves problems perfectly on the first attempt, correcting it quickly generally produces better solutions faster. +* **`Esc`**: stop Claude mid-action with the `Esc` key. Context is preserved, so you can redirect. +* **`Esc + Esc` or `/rewind`**: press `Esc` twice or run `/rewind` to open the rewind menu and restore previous conversation and code state, or summarize from a selected message. +* **`"Undo that"`**: have Claude revert its changes. +* **`/clear`**: reset context between unrelated tasks. Long sessions with irrelevant context can reduce performance. -Connect your tools with MCP +If you’ve corrected Claude more than twice on the same issue in one session, the context is cluttered with failed approaches. Run `/clear` and start fresh with a more specific prompt that incorporates what you learned. A clean session with a better prompt almost always outperforms a long session with accumulated corrections. +### [​](https://www.anthropic.com/engineering/claude-code-best-practices#manage-context-aggressively) -The [Model Context Protocol (MCP)](https://www.anthropic.com/docs/en/mcp) is an open standard for connecting AI tools to external data sources. With MCP, Claude Code can read your design docs in Google Drive, update tickets in Jira, pull data from Slack, or use your own custom tooling. +Manage context aggressively -Customize with instructions, skills, and hooks +Run `/clear` between unrelated tasks to reset context. -[`CLAUDE.md`](https://www.anthropic.com/docs/en/memory) is a markdown file you add to your project root that Claude Code reads at the start of every session. Use it to set coding standards, architecture decisions, preferred libraries, and review checklists. Claude also builds [auto memory](https://www.anthropic.com/docs/en/memory#auto-memory) as it works, saving learnings like build commands and debugging insights across sessions without you writing anything.Create [custom commands](https://www.anthropic.com/docs/en/skills) to package repeatable workflows your team can share, like `/review-pr` or `/deploy-staging`.[Hooks](https://www.anthropic.com/docs/en/hooks) let you run shell commands before or after Claude Code actions, like auto-formatting after every file edit or running lint before a commit. +Claude Code automatically compacts conversation history when you approach context limits, which preserves important code and decisions while freeing space.During long sessions, Claude’s context window can fill with irrelevant conversation, file contents, and commands. This can reduce performance and sometimes distract Claude. +* Use `/clear` frequently between tasks to reset the context window entirely +* When auto compaction triggers, Claude summarizes what matters most, including code patterns, file states, and key decisions +* For more control, run `/compact `, like `/compact Focus on the API changes` +* To compact only part of the conversation, use `Esc + Esc` or `/rewind`, select a message checkpoint, and choose **Summarize from here**. This condenses messages from that point forward while keeping earlier context intact. +* Customize compaction behavior in CLAUDE.md with instructions like `"When compacting, always preserve the full list of modified files and any test commands"` to ensure critical context survives summarization +* For quick questions that don’t need to stay in context, use [`/btw`](https://www.anthropic.com/docs/en/interactive-mode#side-questions-with-btw). The answer appears in a dismissible overlay and never enters conversation history, so you can check a detail without growing context. -Run agent teams and build custom agents +### [​](https://www.anthropic.com/engineering/claude-code-best-practices#use-subagents-for-investigation) -Spawn [multiple Claude Code agents](https://www.anthropic.com/docs/en/sub-agents) that work on different parts of a task simultaneously. A lead agent coordinates the work, assigns subtasks, and merges results.For fully custom workflows, the [Agent SDK](https://platform.claude.com/docs/en/agent-sdk/overview) lets you build your own agents powered by Claude Code’s tools and capabilities, with full control over orchestration, tool access, and permissions. +Use subagents for investigation -Pipe, script, and automate with the CLI +Delegate research with `"use subagents to investigate X"`. They explore in a separate context, keeping your main conversation clean for implementation. -Claude Code is composable and follows the Unix philosophy. Pipe logs into it, run it in CI, or chain it with other tools: +Since context is your fundamental constraint, subagents are one of the most powerful tools available. When Claude researches a codebase it reads lots of files, all of which consume your context. Subagents run in separate context windows and report back summaries: ``` -# Analyze recent log output -tail -200 app.log | claude -p "Slack me if you see any anomalies" +Use subagents to investigate how our authentication system handles token +refresh, and whether we have any existing OAuth utilities I should reuse. +``` -# Automate translations in CI -claude -p "translate new strings into French and raise a PR for review" +The subagent explores the codebase, reads relevant files, and reports back with findings, all without cluttering your main conversation.You can also use subagents for verification after Claude implements something: -# Bulk operations across files -git diff main --name-only | claude -p "review these changed files for security issues" ``` +use a subagent to review this code for edge cases +``` + +### [​](https://www.anthropic.com/engineering/claude-code-best-practices#rewind-with-checkpoints) + +Rewind with checkpoints + +Every action Claude makes creates a checkpoint. You can restore conversation, code, or both to any previous checkpoint. -See the [CLI reference](https://www.anthropic.com/docs/en/cli-reference) for the full set of commands and flags. +Claude automatically checkpoints before changes. Double-tap `Escape` or run `/rewind` to open the rewind menu. You can restore conversation only, restore code only, restore both, or summarize from a selected message. See [Checkpointing](https://www.anthropic.com/docs/en/checkpointing) for details.Instead of carefully planning every move, you can tell Claude to try something risky. If it doesn’t work, rewind and try a different approach. Checkpoints persist across sessions, so you can close your terminal and still rewind later. -Schedule recurring tasks +Checkpoints only track changes made _by Claude_, not external processes. This isn’t a replacement for git. -Run Claude on a schedule to automate work that repeats: morning PR reviews, overnight CI failure analysis, weekly dependency audits, or syncing docs after PRs merge. -* [Cloud scheduled tasks](https://www.anthropic.com/docs/en/web-scheduled-tasks) run on Anthropic-managed infrastructure, so they keep running even when your computer is off. Create them from the web, the Desktop app, or by running `/schedule` in the CLI. -* [Desktop scheduled tasks](https://www.anthropic.com/docs/en/desktop-scheduled-tasks) run on your machine, with direct access to your local files and tools -* [`/loop`](https://www.anthropic.com/docs/en/scheduled-tasks) repeats a prompt within a CLI session for quick polling +### [​](https://www.anthropic.com/engineering/claude-code-best-practices#resume-conversations) -Work from anywhere +Resume conversations + +Run `claude --continue` to pick up where you left off, or `--resume` to choose from recent sessions. + +Claude Code saves conversations locally. When a task spans multiple sessions, you don’t have to re-explain the context: + +``` +claude --continue # Resume the most recent conversation +claude --resume # Select from recent conversations +``` -Sessions aren’t tied to a single surface. Move work between environments as your context changes: -* Step away from your desk and keep working from your phone or any browser with [Remote Control](https://www.anthropic.com/docs/en/remote-control) -* Message [Dispatch](https://www.anthropic.com/docs/en/desktop#sessions-from-dispatch) a task from your phone and open the Desktop session it creates -* Kick off a long-running task on the [web](https://www.anthropic.com/docs/en/claude-code-on-the-web) or [iOS app](https://apps.apple.com/app/claude-by-anthropic/id6473753684), then pull it into your terminal with `claude --teleport` -* Hand off a terminal session to the [Desktop app](https://www.anthropic.com/docs/en/desktop) with `/desktop` for visual diff review -* Route tasks from team chat: mention `@Claude` in [Slack](https://www.anthropic.com/docs/en/slack) with a bug report and get a pull request back +Use `/rename` to give sessions descriptive names like `"oauth-migration"` or `"debugging-memory-leak"` so you can find them later. Treat sessions like branches: different workstreams can have separate, persistent contexts. -## [​](https://www.anthropic.com/engineering/claude-code-best-practices#use-claude-code-everywhere) +* * * -Use Claude Code everywhere +## [​](https://www.anthropic.com/engineering/claude-code-best-practices#automate-and-scale) -Each surface connects to the same underlying Claude Code engine, so your CLAUDE.md files, settings, and MCP servers work across all of them.Beyond the [Terminal](https://www.anthropic.com/docs/en/quickstart), [VS Code](https://www.anthropic.com/docs/en/vs-code), [JetBrains](https://www.anthropic.com/docs/en/jetbrains), [Desktop](https://www.anthropic.com/docs/en/desktop), and [Web](https://www.anthropic.com/docs/en/claude-code-on-the-web) environments above, Claude Code integrates with CI/CD, chat, and browser workflows: +Automate and scale -| I want to… | Best option | +Once you’re effective with one Claude, multiply your output with parallel sessions, non-interactive mode, and fan-out patterns.Everything so far assumes one human, one Claude, and one conversation. But Claude Code scales horizontally. The techniques in this section show how you can get more done. +### [​](https://www.anthropic.com/engineering/claude-code-best-practices#run-non-interactive-mode) + +Run non-interactive mode + +Use `claude -p "prompt"` in CI, pre-commit hooks, or scripts. Add `--output-format stream-json` for streaming JSON output. + +With `claude -p "your prompt"`, you can run Claude non-interactively, without a session. Non-interactive mode is how you integrate Claude into CI pipelines, pre-commit hooks, or any automated workflow. The output formats let you parse results programmatically: plain text, JSON, or streaming JSON. + +``` +# One-off queries +claude -p "Explain what this project does" + +# Structured output for scripts +claude -p "List all API endpoints" --output-format json + +# Streaming for real-time processing +claude -p "Analyze this log file" --output-format stream-json +``` + +### [​](https://www.anthropic.com/engineering/claude-code-best-practices#run-multiple-claude-sessions) + +Run multiple Claude sessions + +Run multiple Claude sessions in parallel to speed up development, run isolated experiments, or start complex workflows. + +There are three main ways to run parallel sessions: +* [Claude Code desktop app](https://www.anthropic.com/docs/en/desktop#work-in-parallel-with-sessions): Manage multiple local sessions visually. Each session gets its own isolated worktree. +* [Claude Code on the web](https://www.anthropic.com/docs/en/claude-code-on-the-web): Run on Anthropic’s secure cloud infrastructure in isolated VMs. +* [Agent teams](https://www.anthropic.com/docs/en/agent-teams): Automated coordination of multiple sessions with shared tasks, messaging, and a team lead. + +Beyond parallelizing work, multiple sessions enable quality-focused workflows. A fresh context improves code review since Claude won’t be biased toward code it just wrote.For example, use a Writer/Reviewer pattern: + +| Session A (Writer) | Session B (Reviewer) | | --- | --- | -| Continue a local session from my phone or another device | [Remote Control](https://www.anthropic.com/docs/en/remote-control) | -| Push events from Telegram, Discord, iMessage, or my own webhooks into a session | [Channels](https://www.anthropic.com/docs/en/channels) | -| Start a task locally, continue on mobile | [Web](https://www.anthropic.com/docs/en/claude-code-on-the-web) or [Claude iOS app](https://apps.apple.com/app/claude-by-anthropic/id6473753684) | -| Run Claude on a recurring schedule | [Cloud scheduled tasks](https://www.anthropic.com/docs/en/web-scheduled-tasks) or [Desktop scheduled tasks](https://www.anthropic.com/docs/en/desktop-scheduled-tasks) | -| Automate PR reviews and issue triage | [GitHub Actions](https://www.anthropic.com/docs/en/github-actions) or [GitLab CI/CD](https://www.anthropic.com/docs/en/gitlab-ci-cd) | -| Get automatic code review on every PR | [GitHub Code Review](https://www.anthropic.com/docs/en/code-review) | -| Route bug reports from Slack to pull requests | [Slack](https://www.anthropic.com/docs/en/slack) | -| Debug live web applications | [Chrome](https://www.anthropic.com/docs/en/chrome) | -| Build custom agents for your own workflows | [Agent SDK](https://platform.claude.com/docs/en/agent-sdk/overview) | - -## [​](https://www.anthropic.com/engineering/claude-code-best-practices#next-steps) - -Next steps - -Once you’ve installed Claude Code, these guides help you go deeper. -* [Quickstart](https://www.anthropic.com/docs/en/quickstart): walk through your first real task, from exploring a codebase to committing a fix -* [Store instructions and memories](https://www.anthropic.com/docs/en/memory): give Claude persistent instructions with CLAUDE.md files and auto memory -* [Common workflows](https://www.anthropic.com/docs/en/common-workflows) and [best practices](https://www.anthropic.com/docs/en/best-practices): patterns for getting the most out of Claude Code -* [Settings](https://www.anthropic.com/docs/en/settings): customize Claude Code for your workflow -* [Troubleshooting](https://www.anthropic.com/docs/en/troubleshooting): solutions for common issues -* [code.claude.com](https://code.claude.com/): demos, pricing, and product details +| `Implement a rate limiter for our API endpoints` | | +| | `Review the rate limiter implementation in @src/middleware/rateLimiter.ts. Look for edge cases, race conditions, and consistency with our existing middleware patterns.` | +| `Here's the review feedback: [Session B output]. Address these issues.` | | + +You can do something similar with tests: have one Claude write tests, then another write code to pass them. +### [​](https://www.anthropic.com/engineering/claude-code-best-practices#fan-out-across-files) + +Fan out across files + +Loop through tasks calling `claude -p` for each. Use `--allowedTools` to scope permissions for batch operations. + +For large migrations or analyses, you can distribute work across many parallel Claude invocations: + +1 + +[](https://www.anthropic.com/engineering/claude-code-best-practices#) + +Generate a task list + +Have Claude list all files that need migrating (e.g., `list all 2,000 Python files that need migrating`) + +2 + +[](https://www.anthropic.com/engineering/claude-code-best-practices#) + +Write a script to loop through the list + +``` +for file in $(cat files.txt); do + claude -p "Migrate $file from React to Vue. Return OK or FAIL." \ + --allowedTools "Edit,Bash(git commit *)" +done +``` + +3 + +[](https://www.anthropic.com/engineering/claude-code-best-practices#) + +Test on a few files, then run at scale + +Refine your prompt based on what goes wrong with the first 2-3 files, then run on the full set. The `--allowedTools` flag restricts what Claude can do, which matters when you’re running unattended. + +You can also integrate Claude into existing data/processing pipelines: + +``` +claude -p "" --output-format json | your_command +``` + +Use `--verbose` for debugging during development, and turn it off in production. +### [​](https://www.anthropic.com/engineering/claude-code-best-practices#run-autonomously-with-auto-mode) + +Run autonomously with auto mode + +For uninterrupted execution with background safety checks, use [auto mode](https://www.anthropic.com/docs/en/permission-modes#eliminate-prompts-with-auto-mode). A classifier model reviews commands before they run, blocking scope escalation, unknown infrastructure, and hostile-content-driven actions while letting routine work proceed without prompts. + +``` +claude --permission-mode auto -p "fix all lint errors" +``` + +For non-interactive runs with the `-p` flag, auto mode aborts if the classifier repeatedly blocks actions, since there is no user to fall back to. See [when auto mode falls back](https://www.anthropic.com/docs/en/permission-modes#when-auto-mode-falls-back) for thresholds. + +* * * + +## [​](https://www.anthropic.com/engineering/claude-code-best-practices#avoid-common-failure-patterns) + +Avoid common failure patterns + +These are common mistakes. Recognizing them early saves time: +* **The kitchen sink session.** You start with one task, then ask Claude something unrelated, then go back to the first task. Context is full of irrelevant information. +> **Fix**: `/clear` between unrelated tasks. + +* **Correcting over and over.** Claude does something wrong, you correct it, it’s still wrong, you correct again. Context is polluted with failed approaches. +> **Fix**: After two failed corrections, `/clear` and write a better initial prompt incorporating what you learned. + +* **The over-specified CLAUDE.md.** If your CLAUDE.md is too long, Claude ignores half of it because important rules get lost in the noise. +> **Fix**: Ruthlessly prune. If Claude already does something correctly without the instruction, delete it or convert it to a hook. + +* **The trust-then-verify gap.** Claude produces a plausible-looking implementation that doesn’t handle edge cases. +> **Fix**: Always provide verification (tests, scripts, screenshots). If you can’t verify it, don’t ship it. + +* **The infinite exploration.** You ask Claude to “investigate” something without scoping it. Claude reads hundreds of files, filling the context. +> **Fix**: Scope investigations narrowly or use subagents so the exploration doesn’t consume your main context. + +* * * + +## [​](https://www.anthropic.com/engineering/claude-code-best-practices#develop-your-intuition) + +Develop your intuition + +The patterns in this guide aren’t set in stone. They’re starting points that work well in general, but might not be optimal for every situation.Sometimes you _should_ let context accumulate because you’re deep in one complex problem and the history is valuable. Sometimes you should skip planning and let Claude figure it out because the task is exploratory. Sometimes a vague prompt is exactly right because you want to see how Claude interprets the problem before constraining it.Pay attention to what works. When Claude produces great output, notice what you did: the prompt structure, the context you provided, the mode you were in. When Claude struggles, ask why. Was the context too noisy? The prompt too vague? The task too big for one pass?Over time, you’ll develop intuition that no guide can capture. You’ll know when to be specific and when to be open-ended, when to plan and when to explore, when to clear context and when to let it accumulate. +## [​](https://www.anthropic.com/engineering/claude-code-best-practices#related-resources) + +Related resources + +* [How Claude Code works](https://www.anthropic.com/docs/en/how-claude-code-works): the agentic loop, tools, and context management +* [Extend Claude Code](https://www.anthropic.com/docs/en/features-overview): skills, hooks, MCP, subagents, and plugins +* [Common workflows](https://www.anthropic.com/docs/en/common-workflows): step-by-step recipes for debugging, testing, PRs, and more +* [CLAUDE.md](https://www.anthropic.com/docs/en/memory): store project conventions and persistent context Was this page helpful? Yes No -[Quickstart](https://www.anthropic.com/docs/en/quickstart) +[Common workflows](https://www.anthropic.com/docs/en/common-workflows)[Overview](https://www.anthropic.com/docs/en/platforms) ⌘I diff --git a/content/blog/engineering/claude-code-sandboxing.md b/content/blog/engineering/claude-code-sandboxing.md index b4444b1bf..9543db71a 100644 --- a/content/blog/engineering/claude-code-sandboxing.md +++ b/content/blog/engineering/claude-code-sandboxing.md @@ -68,7 +68,7 @@ Our new sandboxed bash tool and Claude Code on the web offer substantial improve To get started with these tools: 1. Run `/sandbox` in Claude and check out [our docs](https://docs.claude.com/en/docs/claude-code/sandboxing) on how to configure this sandbox. -2. Go to [claude.com/code](http://claude.ai/redirect/website.v1.b0157fd3-99db-436f-a42e-5cef466be6b0/code) to try out Claude Code on the web. +2. Go to [claude.com/code](http://claude.ai/redirect/website.v1.91b9b576-38af-40d7-8b65-118a3bfcad75/code) to try out Claude Code on the web. Or, if you're building your own agents, check out our [open-sourced sandboxing code](https://github.com/anthropic-experimental/sandbox-runtime), and consider integrating it into your work. We look forward to seeing what you build. diff --git a/content/claude-code-manifest.json b/content/claude-code-manifest.json index f953371be..d9ff28bd5 100644 --- a/content/claude-code-manifest.json +++ b/content/claude-code-manifest.json @@ -1,12 +1,12 @@ { "name": "@anthropic-ai/claude-code", - "version": "2.1.92", + "version": "2.1.96", "author": { "name": "Anthropic", "email": "support@anthropic.com" }, "license": "SEE LICENSE IN README.md", - "_id": "@anthropic-ai/claude-code@2.1.92", + "_id": "@anthropic-ai/claude-code@2.1.96", "maintainers": [ { "name": "zak-anthropic", @@ -73,20 +73,20 @@ "claude": "cli.js" }, "dist": { - "shasum": "536b5c573ae5d3ba85ace514e2e72d37c3d5e464", - "tarball": "https://registry.npmjs.org/@anthropic-ai/claude-code/-/claude-code-2.1.92.tgz", + "shasum": "d528e9638292c7b275c896b283e4a8e6959ef0ef", + "tarball": "https://registry.npmjs.org/@anthropic-ai/claude-code/-/claude-code-2.1.96.tgz", "fileCount": 20, - "integrity": "sha512-mNGw/IK3+1yHsQBeKaNtdTPCrQDkUEuNTJtm3OBTXs4bBkUVdIgRme/34ZnbZkl2VMMYPoNaTvqX2qJZ9EdSxQ==", + "integrity": "sha512-ETrc0+1qWHaqtKi+ixbsAecZyM+H52VIJj+zWIvw3jBU/JZ9v5vnE2kHShM1lcpr+Gji7GXk23l0CMGLA7hC0g==", "signatures": [ { - "sig": "MEUCIA9Pbrb5aRJaP0BIUvY7wPnYuXxf1bmtO2STf8s5CFUrAiEA5Ls/eijn2heuQIP7Mft2b0HcFrhaQgUt61c78t2tvYM=", + "sig": "MEUCIDfVFVFY0qtDRV8JGrx0/QKyh70/hWuV+lO0LSTt2zz6AiEA20JmCcoQACXgZOSLdrLxZ8I2356j3KvBbianSlhxu0A=", "keyid": "SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U" } ], - "unpackedSize": 44517413 + "unpackedSize": 48924836 }, "type": "module", - "_from": "file:/home/runner/work/claude-cli-internal/claude-cli-internal/build-external/anthropic-ai-claude-code-2.1.92.tgz", + "_from": "file:/home/runner/work/claude-cli-internal/claude-cli-internal/build-external/anthropic-ai-claude-code-2.1.96.tgz", "engines": { "node": ">=18.0.0" }, @@ -97,8 +97,8 @@ "name": "wolffiex", "email": "wolffiex@anthropic.com" }, - "_resolved": "/home/runner/work/claude-cli-internal/claude-cli-internal/build-external/anthropic-ai-claude-code-2.1.92.tgz", - "_integrity": "sha512-mNGw/IK3+1yHsQBeKaNtdTPCrQDkUEuNTJtm3OBTXs4bBkUVdIgRme/34ZnbZkl2VMMYPoNaTvqX2qJZ9EdSxQ==", + "_resolved": "/home/runner/work/claude-cli-internal/claude-cli-internal/build-external/anthropic-ai-claude-code-2.1.96.tgz", + "_integrity": "sha512-ETrc0+1qWHaqtKi+ixbsAecZyM+H52VIJj+zWIvw3jBU/JZ9v5vnE2kHShM1lcpr+Gji7GXk23l0CMGLA7hC0g==", "_npmVersion": "10.8.2", "description": "Use Claude, Anthropic's AI assistant, right from your terminal. Claude can understand your codebase, edit files, run terminal commands, and handle entire workflows for you.", "directories": {}, @@ -118,7 +118,7 @@ "@img/sharp-linuxmusl-arm64": "^0.34.2" }, "_npmOperationalInternal": { - "tmp": "tmp/claude-code_2.1.92_1775261159015_0.18519671794064396", + "tmp": "tmp/claude-code_2.1.96_1775622763975_0.7218051294969574", "host": "s3://npm-registry-packages-npm-production" } } \ No newline at end of file diff --git a/content/en/about-claude/models/overview.md b/content/en/about-claude/models/overview.md index 2ce50e3ca..dafff5524 100644 --- a/content/en/about-claude/models/overview.md +++ b/content/en/about-claude/models/overview.md @@ -6,7 +6,7 @@ Claude is a family of state-of-the-art large language models developed by Anthro ## Choosing a model -If you're unsure which model to use, consider starting with **Claude Opus 4.6** for the most complex tasks. It is the latest generation model with exceptional performance in coding and reasoning. +If you're unsure which model to use, consider starting with **Claude Opus 4.6** for the most complex tasks. It is the most intelligent broadly available model with exceptional performance in coding and reasoning. All current Claude models support text and image input, text output, multilingual capabilities, and vision. Models are available via the Claude API, AWS Bedrock, and Google Vertex AI. @@ -16,7 +16,7 @@ Once you've picked a model, [learn how to make your first API call](/docs/en/get | Feature | Claude Opus 4.6 | Claude Sonnet 4.6 | Claude Haiku 4.5 | |:--------|:----------------|:------------------|:-----------------| -| **Description** | The most intelligent model for building agents and coding | The best combination of speed and intelligence | The fastest model with near-frontier intelligence | +| **Description** | The most intelligent broadly available model for agents and coding | The best combination of speed and intelligence | The fastest model with near-frontier intelligence | | **Claude API ID** | claude-opus-4-6 | claude-sonnet-4-6 | claude-haiku-4-5-20251001 | | **Claude API alias** | claude-opus-4-6 | claude-sonnet-4-6 | claude-haiku-4-5 | | **AWS Bedrock ID** | anthropic.claude-opus-4-6-v1 | anthropic.claude-sonnet-4-6 | anthropic.claude-haiku-4-5-20251001-v1:0 | @@ -35,9 +35,13 @@ _1 - See the [pricing page](/docs/en/about-claude/pricing) for complete pri _2 - **Reliable knowledge cutoff** indicates the date through which a model's knowledge is most extensive and reliable. **Training data cutoff** is the broader date range of training data used. For more information, see [Anthropic's Transparency Hub](https://www.anthropic.com/transparency)._ + +[Claude Mythos Preview](https://anthropic.com/glasswing) is offered separately as a research preview model for defensive cybersecurity workflows as part of [Project Glasswing](https://anthropic.com/glasswing). Access is invitation-only and there is no self-serve sign-up. + + Models with the same snapshot date (e.g., 20240620) are identical across all platforms and do not change. The snapshot date in the model name ensures consistency and allows developers to rely on stable performance across different environments. -Starting with **Claude Sonnet 4.5 and all subsequent models** (including Claude Sonnet 4.6), AWS Bedrock and Google Vertex AI offer two endpoint types: **global endpoints** (dynamic routing for maximum availability) and **regional endpoints** (guaranteed data routing through specific geographic regions). For more information, see the [third-party platform pricing section](/docs/en/about-claude/pricing#third-party-platform-pricing). +Starting with **Claude Sonnet 4.5 and all subsequent models** (including Claude Sonnet 4.6), AWS Bedrock offers two endpoint types: **global endpoints** (dynamic routing for maximum availability) and **regional endpoints** (guaranteed data routing through specific geographic regions). Google Vertex AI offers three endpoint types: global endpoints, **multi-region endpoints** (dynamic routing within a geographic area), and regional endpoints. For more information, see the [third-party platform pricing section](/docs/en/about-claude/pricing#third-party-platform-pricing). You can query model capabilities and token limits programmatically with the [Models API](/docs/en/api/models/list). The response includes `max_input_tokens`, `max_tokens`, and a `capabilities` object for every available model. diff --git a/content/en/about-claude/pricing.md b/content/en/about-claude/pricing.md index 0db54fe61..97345912c 100644 --- a/content/en/about-claude/pricing.md +++ b/content/en/about-claude/pricing.md @@ -33,25 +33,25 @@ MTok = Million tokens. The "Base Input Tokens" column shows standard input prici ## Third-party platform pricing -Claude models are available on [AWS Bedrock](/docs/en/build-with-claude/claude-on-amazon-bedrock), [Google Vertex AI](/docs/en/build-with-claude/claude-on-vertex-ai), and [Microsoft Foundry](/docs/en/build-with-claude/claude-in-microsoft-foundry). For official pricing, visit: +Claude models are available on [AWS Bedrock](/docs/en/build-with-claude/claude-in-amazon-bedrock), [Google Vertex AI](/docs/en/build-with-claude/claude-on-vertex-ai), and [Microsoft Foundry](/docs/en/build-with-claude/claude-in-microsoft-foundry). For official pricing, visit: - [AWS Bedrock pricing](https://aws.amazon.com/bedrock/pricing/) - [Google Vertex AI pricing](https://cloud.google.com/vertex-ai/generative-ai/pricing) - [Microsoft Foundry pricing](https://azure.microsoft.com/en-us/pricing/details/ai-foundry/#pricing) -**Regional endpoint pricing for Claude 4.5 models and beyond** +**Regional and multi-region endpoint pricing for Claude 4.5 models and beyond** -Starting with Claude Sonnet 4.5 and Haiku 4.5, AWS Bedrock and Google Vertex AI offer two endpoint types: -- **Global endpoints:** Dynamic routing across regions for maximum availability -- **Regional endpoints:** Data routing guaranteed within specific geographic regions +Starting with Claude Sonnet 4.5 and Haiku 4.5: +- **AWS Bedrock** offers two endpoint types: global endpoints (dynamic routing for maximum availability) and regional endpoints (guaranteed data routing through specific geographic regions). +- **Google Vertex AI** offers three endpoint types: global endpoints, multi-region endpoints (dynamic routing within a geographic area), and regional endpoints. -Regional endpoints include a 10% premium over global endpoints. The Claude API (1P) is global by default; for 1P data residency options and pricing, see [Data residency pricing](#data-residency-pricing) below. +Regional and multi-region endpoints include a 10% premium over global endpoints. The Claude API (1P) is global by default; for 1P data residency options and pricing, see [Data residency pricing](#data-residency-pricing) below. **Scope:** This pricing structure applies to Claude Sonnet 4.5, Haiku 4.5, and all future models. Earlier models (Claude Sonnet 4, Opus 4, and prior releases) retain their existing pricing. For implementation details and code examples: - [AWS Bedrock global vs regional endpoints](/docs/en/build-with-claude/claude-on-amazon-bedrock#global-vs-regional-endpoints) -- [Google Vertex AI global vs regional endpoints](/docs/en/build-with-claude/claude-on-vertex-ai#global-vs-regional-endpoints) +- [Google Vertex AI global, multi-region, and regional endpoints](/docs/en/build-with-claude/claude-on-vertex-ai#global-multi-region-and-regional-endpoints) ## Feature-specific pricing @@ -126,7 +126,7 @@ For more information about batch processing, see the [batch processing documenta ### Long context pricing -Claude Opus 4.6 and Sonnet 4.6 include the full [1M token context window](/docs/en/build-with-claude/context-windows) at standard pricing. (A 900k-token request is billed at the same per-token rate as a 9k-token request.) Prompt caching and batch processing discounts apply at standard rates across the full context window. +[Claude Mythos Preview](https://anthropic.com/glasswing), Opus 4.6 and Sonnet 4.6 include the full [1M token context window](/docs/en/build-with-claude/context-windows) at standard pricing. (A 900k-token request is billed at the same per-token rate as a 9k-token request.) Prompt caching and batch processing discounts apply at standard rates across the full context window. ### Tool use pricing diff --git a/content/en/agent-sdk/agent-loop.md b/content/en/agent-sdk/agent-loop.md index 4193b82f4..e04d8e177 100644 --- a/content/en/agent-sdk/agent-loop.md +++ b/content/en/agent-sdk/agent-loop.md @@ -169,7 +169,7 @@ The `effort` option controls how much reasoning Claude applies. Lower effort lev | `"high"` | Thorough analysis | Refactors, debugging | | `"max"` | Maximum reasoning depth | Multi-step problems requiring deep analysis | -If you don't set `effort`, the Python SDK leaves the parameter unset and defers to the model's default behavior. The TypeScript SDK defaults to `"high"`. +If you don't set `effort`, both SDKs leave the parameter unset and the underlying engine resolves a model-dependent default. `effort` trades latency and token cost for reasoning depth within each response. [Extended thinking](/docs/en/build-with-claude/extended-thinking) is a separate feature that produces visible chain-of-thought blocks in the output. They are independent: you can set `effort: "low"` with extended thinking enabled, or `effort: "max"` without it. @@ -185,7 +185,7 @@ The permission mode option (`permission_mode` in Python, `permissionMode` in Typ |:-----|:---------| | `"default"` | Tools not covered by allow rules trigger your approval callback; no callback means deny | | `"acceptEdits"` | Auto-approves file edits, other tools follow default rules | -| `"plan"` | No tool execution; Claude produces a plan for review | +| `"plan"` | Read-only tools run; tools that make changes are blocked while Claude produces a plan for review | | `"dontAsk"` | Never prompts. Tools pre-approved by [permission rules](https://code.claude.com/docs/en/settings#permission-settings) run, everything else is denied | | `"auto"` (TypeScript only) | Uses a model classifier to approve or deny each tool call. See [Auto mode](https://code.claude.com/docs/en/permission-modes#eliminate-prompts-with-auto-mode) for availability and behavior | | `"bypassPermissions"` | Runs all allowed tools without asking. Cannot be used when running as root on Unix. Use only in isolated environments where the agent's actions cannot affect systems you care about | diff --git a/content/en/agent-sdk/custom-tools.md b/content/en/agent-sdk/custom-tools.md index fc04cc903..1317b45fc 100644 --- a/content/en/agent-sdk/custom-tools.md +++ b/content/en/agent-sdk/custom-tools.md @@ -17,7 +17,7 @@ This guide covers how to define tools with input schemas and handlers, bundle th | Pre-approve a tool | Add to your allowed tools. See [Configure allowed tools](#configure-allowed-tools). | | Remove a built-in tool from Claude's context | Pass a `tools` array listing only the built-ins you want. See [Configure allowed tools](#configure-allowed-tools). | | Let Claude call tools in parallel | Set `readOnlyHint: true` on tools with no side effects. See [Add tool annotations](#add-tool-annotations). | -| Handle errors without stopping the loop | Return `isError: true` instead of throwing. See [Handle errors](#handle-errors). | +| Control the error message Claude sees | Return `isError: true` instead of throwing. See [Handle errors](#handle-errors). | | Return images or files | Use `image` or `resource` blocks in the content array. See [Return images and resources](#return-images-and-resources). | | Scale to many tools | Use [tool search](/docs/en/agent-sdk/tool-search) to load tools on demand. | @@ -339,12 +339,12 @@ To limit which built-ins Claude can use, prefer `tools` over disallowed tools. O ## Handle errors -How your handler reports errors determines whether the agent loop continues or stops: +In both cases the agent loop continues. An uncaught exception is wrapped by the MCP server and surfaces to Claude as a tool error result, so the loop does not stop. Returning `isError: true` (TypeScript) or `"is_error": True` (Python) is preferred because it lets you control the error message Claude sees: | What happens | Result | |:-------------|:-------| -| Handler throws an uncaught exception | Agent loop stops. Claude never sees the error, and the `query` call fails. | -| Handler catches the error and returns `isError: true` (TS) / `"is_error": True` (Python) | Agent loop continues. Claude sees the error as data and can retry, try a different tool, or explain the failure. | +| Handler throws an uncaught exception | Agent loop continues. Claude sees the exception's stringified message as the tool result. | +| Handler catches the error and returns `isError: true` (TS) / `"is_error": True` (Python) | Agent loop continues. Claude sees your formatted error message as data and can retry, try a different tool, or explain the failure. | The example below catches two kinds of failures inside the handler instead of letting them throw. A non-200 HTTP status is caught from the response and returned as an error result. A network error or invalid JSON is caught by the surrounding `try/except` (Python) or `try/catch` (TypeScript) and also returned as an error result. In both cases the handler returns normally and the agent loop continues. @@ -381,8 +381,8 @@ async def fetch_data(args: dict[str, Any]) -> dict[str, Any]: data = response.json() return {"content": [{"type": "text", "text": json.dumps(data, indent=2)}]} except Exception as e: - # Catching here keeps the agent loop alive. An uncaught exception - # would end the whole query() call. + # Catching here lets you control the error message Claude sees instead + # of surfacing the raw exception string. return { "content": [{"type": "text", "text": f"Failed to fetch data: {str(e)}"}], "is_error": True, @@ -424,8 +424,8 @@ tool( ] }; } catch (error) { - // Catching here keeps the agent loop alive. An uncaught throw - // would end the whole query() call. + // Catching here lets you control the error message Claude sees instead + // of surfacing the raw exception string. return { content: [ { diff --git a/content/en/agent-sdk/permissions.md b/content/en/agent-sdk/permissions.md index cf14cf196..c5f615741 100644 --- a/content/en/agent-sdk/permissions.md +++ b/content/en/agent-sdk/permissions.md @@ -22,7 +22,7 @@ When Claude requests a tool, the SDK checks permissions in this order: Check `deny` rules (from `disallowed_tools` and [settings.json](https://code.claude.com/docs/en/settings#permission-settings)). If a deny rule matches, the tool is blocked, even in `bypassPermissions` mode. - Apply the active [permission mode](#permission-modes). `bypassPermissions` approves everything that reaches this step. `acceptEdits` approves file operations. Other modes fall through. + Apply the active [permission mode](#permission-modes). `bypassPermissions` approves everything that reaches this step. `acceptEdits` approves file operations. `plan` approves read-only tools and blocks tools that make changes. Other modes fall through. Check `allow` rules (from `allowed_tools` and settings.json). If a rule matches, the tool is approved. @@ -77,7 +77,7 @@ The SDK supports these permission modes: | `dontAsk` | Deny instead of prompting | Anything not pre-approved by `allowed_tools` or rules is denied; `canUseTool` is never called | | `acceptEdits` | Auto-accept file edits | File edits and [filesystem operations](#accept-edits-mode-acceptedits) (`mkdir`, `rm`, `mv`, etc.) are automatically approved | | `bypassPermissions` | Bypass all permission checks | All tools run without permission prompts (use with caution) | -| `plan` | Planning mode | No tool execution; Claude plans without making changes | +| `plan` | Planning mode | Read-only tools run; tools that make changes are blocked while Claude produces a plan | | `auto` (TypeScript only) | Model-classified approvals | A model classifier approves or denies each tool call. See [Auto mode](https://code.claude.com/docs/en/permission-modes#eliminate-prompts-with-auto-mode) for availability | @@ -223,7 +223,7 @@ Use with extreme caution. Claude has full system access in this mode. Only use i #### Plan mode (`plan`) -Prevents tool execution entirely. Claude can analyze code and create plans but cannot make changes. Claude may use `AskUserQuestion` to clarify requirements before finalizing the plan. See [Handle approvals and user input](/docs/en/agent-sdk/user-input#handle-clarifying-questions) for handling these prompts. +Blocks tools that make changes. Read-only tools like `Read`, `Grep`, `Glob`, and `WebFetch` still run so Claude can analyze code and create plans, but file edits, Bash commands, and other tools that modify state are denied. Claude may use `AskUserQuestion` to clarify requirements before finalizing the plan. See [Handle approvals and user input](/docs/en/agent-sdk/user-input#handle-clarifying-questions) for handling these prompts. **Use when:** you want Claude to propose changes without executing them, such as during code review or when you need to approve changes before they're made. diff --git a/content/en/agent-sdk/python.md b/content/en/agent-sdk/python.md index 65c9be479..c7d2597d8 100644 --- a/content/en/agent-sdk/python.md +++ b/content/en/agent-sdk/python.md @@ -1005,7 +1005,7 @@ Permission modes for controlling tool execution. PermissionMode = Literal[ "default", # Standard permission behavior "acceptEdits", # Auto-accept file edits - "plan", # Planning mode - no execution + "plan", # Planning mode - read-only tools only "dontAsk", # Deny anything not pre-approved instead of prompting "bypassPermissions", # Bypass all permission checks (use with caution) ] diff --git a/content/en/agent-sdk/skills.md b/content/en/agent-sdk/skills.md index 126477ba6..e3f75b785 100644 --- a/content/en/agent-sdk/skills.md +++ b/content/en/agent-sdk/skills.md @@ -105,7 +105,7 @@ The `allowed-tools` frontmatter field in SKILL.md is only supported when using C When using the SDK, control tool access through the main `allowedTools` option in your query configuration. -To control tool access for Skills in SDK applications, use `allowedTools` to pre-approve specific tools. Without a `canUseTool` callback, anything not in the list is denied: +To control tool access for Skills in SDK applications, use `allowedTools` to pre-approve specific tools, and pair it with `permissionMode: "dontAsk"` so anything not in the list is denied. `allowedTools` alone only pre-approves the listed tools; unlisted tools fall through to the active permission mode rather than being blocked: Import statements from the first example are assumed in the following code snippets. @@ -117,6 +117,7 @@ Import statements from the first example are assumed in the following code snipp options = ClaudeAgentOptions( setting_sources=["user", "project"], # Load Skills from filesystem allowed_tools=["Skill", "Read", "Grep", "Glob"], + permission_mode="dontAsk", # Deny anything not in allowed_tools ) async for message in query(prompt="Analyze the codebase structure", options=options): diff --git a/content/en/agent-sdk/streaming-vs-single-mode.md b/content/en/agent-sdk/streaming-vs-single-mode.md index 88a99315e..d223865b6 100644 --- a/content/en/agent-sdk/streaming-vs-single-mode.md +++ b/content/en/agent-sdk/streaming-vs-single-mode.md @@ -214,7 +214,7 @@ Single message input is simpler but more limited. Use single message input when: - You need a one-shot response -- You do not need image attachments, hooks, etc. +- You do not need image attachments - You need to operate in a stateless environment, such as a lambda function ### Limitations @@ -224,7 +224,6 @@ Single message input mode does **not** support: - Direct image attachments in messages - Dynamic message queueing - Real-time interruption -- Hook integration - Natural multi-turn conversations diff --git a/content/en/agent-sdk/subagents.md b/content/en/agent-sdk/subagents.md index 46a542ee7..584bc2cf4 100644 --- a/content/en/agent-sdk/subagents.md +++ b/content/en/agent-sdk/subagents.md @@ -579,10 +579,6 @@ If Claude completes tasks directly instead of delegating to your subagent: Agents defined in `.claude/agents/` are loaded at startup only. If you create a new agent file while Claude Code is running, restart the session to load it. -### Windows: long prompt failures - -On Windows, subagents with very long prompts may fail due to command line length limits (8191 chars). Keep prompts concise or use filesystem-based agents for complex instructions. - ## Related documentation - [Claude Code subagents](https://code.claude.com/docs/en/sub-agents): comprehensive subagent documentation including filesystem-based definitions diff --git a/content/en/agent-sdk/tool-search.md b/content/en/agent-sdk/tool-search.md index a3f5f4a61..40061d41d 100644 --- a/content/en/agent-sdk/tool-search.md +++ b/content/en/agent-sdk/tool-search.md @@ -22,7 +22,7 @@ Tool search adds one extra round-trip the first time Claude discovers a tool (th For details on the underlying API mechanism, see [Tool search in the API](/docs/en/agents-and-tools/tool-use/tool-search-tool). -Tool search requires Claude Sonnet 4 or later, or Claude Opus 4 or later. Haiku models do not support tool search. +Haiku models do not support tool search. ## Configure tool search @@ -118,7 +118,7 @@ You can search for tools to interact with Slack, GitHub, and Jira. - **Maximum tools:** 10,000 tools in your catalog - **Search results:** Returns 3-5 most relevant tools per search -- **Model support:** Claude Sonnet 4 and later, Claude Opus 4 and later (no Haiku) +- **Model support:** Haiku models do not support tool search ## Related documentation diff --git a/content/en/agent-sdk/typescript.md b/content/en/agent-sdk/typescript.md index 021a4e37f..18c873494 100644 --- a/content/en/agent-sdk/typescript.md +++ b/content/en/agent-sdk/typescript.md @@ -289,7 +289,7 @@ Configuration object for the `query()` function. | `debug` | `boolean` | `false` | Enable debug mode for the Claude Code process | | `debugFile` | `string` | `undefined` | Write debug logs to a specific file path. Implicitly enables debug mode | | `disallowedTools` | `string[]` | `[]` | Tools to always deny. Deny rules are checked first and override `allowedTools` and `permissionMode` (including `bypassPermissions`) | -| `effort` | `'low' \| 'medium' \| 'high' \| 'max'` | `'high'` | Controls how much effort Claude puts into its response. Works with adaptive thinking to guide thinking depth | +| `effort` | `'low' \| 'medium' \| 'high' \| 'max'` | `undefined` | Controls how much effort Claude puts into its response. When unset, the engine resolves a model-dependent default. Works with adaptive thinking to guide thinking depth | | `enableFileCheckpointing` | `boolean` | `false` | Enable file change tracking for rewinding. See [File checkpointing](/docs/en/agent-sdk/file-checkpointing) | | `env` | `Record` | `process.env` | Environment variables. Set `CLAUDE_AGENT_SDK_CLIENT_APP` to identify your app in the User-Agent header | | `executable` | `'bun' \| 'deno' \| 'node'` | Auto-detected | JavaScript runtime to use | @@ -536,7 +536,7 @@ type PermissionMode = | "default" // Standard permission behavior | "acceptEdits" // Auto-accept file edits | "bypassPermissions" // Bypass all permission checks - | "plan" // Planning mode - no execution + | "plan" // Planning mode - read-only tools only | "dontAsk" // Don't prompt for permissions, deny if not pre-approved | "auto"; // Use a model classifier to approve or deny each tool call ``` diff --git a/content/en/agents-and-tools/tool-use/code-execution-tool.md b/content/en/agents-and-tools/tool-use/code-execution-tool.md index 6e302e8fa..7e3120685 100644 --- a/content/en/agents-and-tools/tool-use/code-execution-tool.md +++ b/content/en/agents-and-tools/tool-use/code-execution-tool.md @@ -20,20 +20,7 @@ This feature is **not** eligible for [Zero Data Retention (ZDR)](/docs/en/build- ## Model compatibility -The code execution tool is available on the following models: - -| Model | Tool Version | -|-------|--------------| -| Claude Opus 4.6 (`claude-opus-4-6`) | `code_execution_20250825` | -| Claude Sonnet 4.6 (`claude-sonnet-4-6`) | `code_execution_20250825` | -| Claude Sonnet 4.5 (`claude-sonnet-4-5-20250929`) | `code_execution_20250825` | -| Claude Opus 4.5 (`claude-opus-4-5-20251101`) | `code_execution_20250825` | -| Claude Opus 4.1 (`claude-opus-4-1-20250805`) | `code_execution_20250825` | -| Claude Opus 4 (`claude-opus-4-20250514`) | `code_execution_20250825` | -| Claude Sonnet 4 (`claude-sonnet-4-20250514`) | `code_execution_20250825` | -| Claude Sonnet 3.7 (`claude-3-7-sonnet-20250219`) ([deprecated](/docs/en/about-claude/model-deprecations)) | `code_execution_20250825` | -| Claude Haiku 4.5 (`claude-haiku-4-5-20251001`) | `code_execution_20250825` | -| Claude Haiku 3.5 (`claude-3-5-haiku-latest`) ([deprecated](/docs/en/about-claude/model-deprecations)) | `code_execution_20250825` | +The code execution tool is available on all supported Claude models using tool version `code_execution_20250825`. The `code_execution_20250825` version supports Bash commands and file operations. For models that support [programmatic tool calling](/docs/en/agents-and-tools/tool-use/programmatic-tool-calling), `code_execution_20260120` adds REPL state persistence and the ability to call tools from within the sandbox. A legacy version `code_execution_20250522` (Python only) is also available; see [Upgrade to latest tool version](#upgrade-to-latest-tool-version) to migrate from it. @@ -51,6 +38,10 @@ Code execution is available on: Code execution is not currently available on Amazon Bedrock or Google Vertex AI. + +For [Claude Mythos Preview](https://anthropic.com/glasswing), code execution is supported on the Claude API and Microsoft Foundry only. It is not available for Mythos Preview on Amazon Bedrock or Google Vertex AI. + + ## Quick start Here's a simple example that asks Claude to perform a calculation: @@ -1214,6 +1205,7 @@ Each tool type can return specific errors: | All tools | `container_expired` | Container expired and is no longer available | | All tools | `invalid_tool_input` | Invalid parameters provided to the tool | | All tools | `too_many_requests` | Rate limit exceeded for tool usage | +| bash | `output_file_too_large` | Command output exceeded the maximum size | | text_editor | `file_not_found` | File doesn't exist (for view/edit operations) | | text_editor | `string_not_found` | The `old_str` not found in file (for str_replace) | diff --git a/content/en/agents-and-tools/tool-use/define-tools.md b/content/en/agents-and-tools/tool-use/define-tools.md index 18dada364..0173fb48b 100644 --- a/content/en/agents-and-tools/tool-use/define-tools.md +++ b/content/en/agents-and-tools/tool-use/define-tools.md @@ -546,6 +546,10 @@ Note that when you have `tool_choice` as `any` or `tool`, the API prefills the a When using [extended thinking](/docs/en/build-with-claude/extended-thinking) with tool use, `tool_choice: {"type": "any"}` and `tool_choice: {"type": "tool", "name": "..."}` are not supported and will result in an error. Only `tool_choice: {"type": "auto"}` (the default) and `tool_choice: {"type": "none"}` are compatible with extended thinking. + +[Claude Mythos Preview](https://anthropic.com/glasswing) does not support forced tool use. Requests with `tool_choice: {"type": "any"}` or `tool_choice: {"type": "tool", "name": "..."}` return a 400 error on this model. Use `tool_choice: {"type": "auto"}` (the default) or `tool_choice: {"type": "none"}` and rely on prompting to influence tool selection. + + Testing has shown that this should not reduce performance. If you would like the model to provide natural language context or explanations while still requesting that the model use a specific tool, you can use `{"type": "auto"}` for `tool_choice` (the default) and add explicit instructions in a `user` message. For example: `What's the weather like in London? Use the get_weather tool in your response.` diff --git a/content/en/agents-and-tools/tool-use/parallel-tool-use.md b/content/en/agents-and-tools/tool-use/parallel-tool-use.md index 9ba63ea10..8ade6209a 100644 --- a/content/en/agents-and-tools/tool-use/parallel-tool-use.md +++ b/content/en/agents-and-tools/tool-use/parallel-tool-use.md @@ -925,12 +925,6 @@ print(f"Average tools per message: {avg_tools_per_message}") # Should be > 1.0 if parallel calls are working ``` -**4. Model-specific behavior** - -- Claude Opus 4.6, Sonnet 4.6, Sonnet 4.5, Opus 4.5, Opus 4.1, and Sonnet 4: Excel at parallel tool use with minimal prompting -- Claude Sonnet 3.7: May need stronger prompting or the `token-efficient-tools-2025-02-19` [beta header](/docs/en/api/beta-headers). Consider [upgrading to Claude 4](/docs/en/about-claude/models/migration-guide). -- Claude Haiku: Less likely to use parallel tools without explicit prompting - ## Next steps - For the single-tool-call flow and `tool_result` formatting rules, see [Handle tool calls](/docs/en/agents-and-tools/tool-use/handle-tool-calls). diff --git a/content/en/agents-and-tools/tool-use/tool-search-tool.md b/content/en/agents-and-tools/tool-use/tool-search-tool.md index c58a8c61c..6c1c3aa7d 100644 --- a/content/en/agents-and-tools/tool-use/tool-search-tool.md +++ b/content/en/agents-and-tools/tool-use/tool-search-tool.md @@ -819,7 +819,7 @@ For ZDR eligibility across all features, see [API and data retention](/docs/en/b - **Maximum tools:** 10,000 tools in your catalog - **Search results:** Returns 3-5 most relevant tools per search - **Pattern length:** Maximum 200 characters for regex patterns -- **Model support:** Sonnet 4.0+, Opus 4.0+ only (no Haiku) +- **Model support:** [Claude Mythos Preview](https://anthropic.com/glasswing), Sonnet 4.0+, Opus 4.0+ only (no Haiku) ### When to use tool search diff --git a/content/en/agents-and-tools/tool-use/web-fetch-tool.md b/content/en/agents-and-tools/tool-use/web-fetch-tool.md index e8162a311..1f90db152 100644 --- a/content/en/agents-and-tools/tool-use/web-fetch-tool.md +++ b/content/en/agents-and-tools/tool-use/web-fetch-tool.md @@ -6,7 +6,11 @@ Fetch and read content from specific URLs to augment Claude's context with live The web fetch tool allows Claude to retrieve full content from specified web pages and PDF documents. -The latest web fetch tool version (`web_fetch_20260209`) supports **dynamic filtering** with Claude Opus 4.6 and Sonnet 4.6. Claude can write and execute code to filter fetched content before it reaches the context window, keeping only relevant information and discarding the rest. This reduces token consumption while maintaining response quality. The previous tool version (`web_fetch_20250910`) remains available without dynamic filtering. +The latest web fetch tool version (`web_fetch_20260209`) supports **dynamic filtering** with [Claude Mythos Preview](https://anthropic.com/glasswing), Claude Opus 4.6, and Claude Sonnet 4.6. Claude can write and execute code to filter fetched content before it reaches the context window, keeping only relevant information and discarding the rest. This reduces token consumption while maintaining response quality. The previous tool version (`web_fetch_20250910`) remains available without dynamic filtering. + + +For [Claude Mythos Preview](https://anthropic.com/glasswing), web fetch is supported on the Claude API and Microsoft Foundry only. It is not available for Mythos Preview on Amazon Bedrock or Google Vertex AI. + Use the [feedback form](https://forms.gle/NhWcgmkcvPCMmPE86) to provide feedback on the quality of the model responses, the API itself, or the quality of the documentation. @@ -40,7 +44,7 @@ When you add the web fetch tool to your API request: The web fetch tool currently does not support websites dynamically rendered via JavaScript. -### Dynamic filtering with Opus 4.6 and Sonnet 4.6 +### Dynamic filtering Fetching full web pages and PDFs can quickly consume tokens, especially when only specific information is needed from large documents. With the `web_fetch_20260209` tool version, Claude can write and execute code to filter the fetched content before loading it into context. diff --git a/content/en/agents-and-tools/tool-use/web-search-tool.md b/content/en/agents-and-tools/tool-use/web-search-tool.md index d5d3eb75d..a70737131 100644 --- a/content/en/agents-and-tools/tool-use/web-search-tool.md +++ b/content/en/agents-and-tools/tool-use/web-search-tool.md @@ -4,7 +4,11 @@ The web search tool gives Claude direct access to real-time web content, allowing it to answer questions with up-to-date information beyond its knowledge cutoff. The response includes citations for sources drawn from search results. -The latest web search tool version (`web_search_20260209`) supports **dynamic filtering** with Claude Opus 4.6 and Sonnet 4.6. Claude can write and execute code to filter search results before they reach the context window, keeping only relevant information and discarding the rest. This leads to more accurate responses while reducing token consumption. The previous tool version (`web_search_20250305`) remains available without dynamic filtering. +The latest web search tool version (`web_search_20260209`) supports **dynamic filtering** with [Claude Mythos Preview](https://anthropic.com/glasswing), Claude Opus 4.6, and Claude Sonnet 4.6. Claude can write and execute code to filter search results before they reach the context window, keeping only relevant information and discarding the rest. This leads to more accurate responses while reducing token consumption. The previous tool version (`web_search_20250305`) remains available without dynamic filtering. + + +For [Claude Mythos Preview](https://anthropic.com/glasswing), web search is supported on the Claude API, Microsoft Foundry, and Google Vertex AI. Web search is not available for Mythos Preview on Amazon Bedrock. + For Zero Data Retention eligibility and the `allowed_callers` workaround, see [Server tools](/docs/en/agents-and-tools/tool-use/server-tools#zdr-and-allowed-callers). @@ -18,7 +22,7 @@ When you add the web search tool to your API request: 2. The API executes the searches and provides Claude with the results. This process may repeat multiple times throughout a single request. 3. At the end of its turn, Claude provides a final response with cited sources. -### Dynamic filtering with Opus 4.6 and Sonnet 4.6 +### Dynamic filtering Web search is a token-intensive task. With basic web search, Claude needs to pull search results into context, fetch full HTML from multiple websites, and reason over all of it before arriving at an answer. Often, much of this content is irrelevant, which can degrade response quality. diff --git a/content/en/api/beta.md b/content/en/api/beta.md index 7304155f9..10d283c01 100644 --- a/content/en/api/beta.md +++ b/content/en/api/beta.md @@ -4,11 +4,11 @@ ### Anthropic Beta -- `AnthropicBeta = string or "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` +- `AnthropicBeta = string or "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -50,6 +50,10 @@ - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Beta API Error - `BetaAPIError = object { message, type }` @@ -334,7 +338,7 @@ The Models API response can be used to determine which models are available for - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -376,6 +380,10 @@ The Models API response can be used to determine which models are available for - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `data: array of BetaModelInfo` @@ -575,7 +583,7 @@ The Models API response can be used to determine which models are available for ### Example ```http -curl https://api.anthropic.com/v1/models?beta=true \ +curl https://api.anthropic.com/v1/models \ -H 'anthropic-version: 2023-06-01' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" ``` @@ -602,7 +610,7 @@ The Models API response can be used to determine information about a specific mo - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -644,6 +652,10 @@ The Models API response can be used to determine information about a specific mo - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaModelInfo = object { id, capabilities, created_at, 4 more }` @@ -831,7 +843,7 @@ The Models API response can be used to determine information about a specific mo ### Example ```http -curl https://api.anthropic.com/v1/models/$MODEL_ID?beta=true \ +curl https://api.anthropic.com/v1/models/$MODEL_ID \ -H 'anthropic-version: 2023-06-01' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" ``` @@ -1334,7 +1346,7 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -1376,6 +1388,10 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Body Parameters - `max_tokens: number` @@ -6040,9 +6056,13 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en Recommended for advanced use cases only. You usually only need to use `temperature`. +- `user_profile_id: optional string` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + ### Returns -- `BetaMessage = object { id, container, content, 7 more }` +- `BetaMessage = object { id, container, content, 8 more }` - `id: string` @@ -7039,6 +7059,30 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `"assistant"` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -7247,7 +7291,7 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en ### Example ```http -curl https://api.anthropic.com/v1/messages?beta=true \ +curl https://api.anthropic.com/v1/messages \ -H 'Content-Type: application/json' \ -H 'anthropic-version: 2023-06-01' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" \ @@ -7282,7 +7326,7 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -7324,6 +7368,10 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Body Parameters - `messages: array of BetaMessageParam` @@ -11903,7 +11951,7 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d ### Example ```http -curl https://api.anthropic.com/v1/messages/count_tokens?beta=true \ +curl https://api.anthropic.com/v1/messages/count_tokens \ -H 'Content-Type: application/json' \ -H 'anthropic-version: 2023-06-01' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" \ @@ -18182,7 +18230,7 @@ curl https://api.anthropic.com/v1/messages/count_tokens?beta=true \ ### Beta Message -- `BetaMessage = object { id, container, content, 7 more }` +- `BetaMessage = object { id, container, content, 8 more }` - `id: string` @@ -19179,6 +19227,30 @@ curl https://api.anthropic.com/v1/messages/count_tokens?beta=true \ - `"assistant"` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -23290,7 +23362,7 @@ curl https://api.anthropic.com/v1/messages/count_tokens?beta=true \ - `"clear_thinking_20251015"` - - `delta: object { container, stop_reason, stop_sequence }` + - `delta: object { container, stop_details, stop_reason, stop_sequence }` - `container: BetaContainer` @@ -23324,6 +23396,30 @@ curl https://api.anthropic.com/v1/messages/count_tokens?beta=true \ Skill version or 'latest' for most recent version + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason` - `"end_turn"` @@ -24475,6 +24571,30 @@ curl https://api.anthropic.com/v1/messages/count_tokens?beta=true \ - `"assistant"` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -25695,6 +25815,30 @@ curl https://api.anthropic.com/v1/messages/count_tokens?beta=true \ - `"assistant"` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -25946,7 +26090,7 @@ curl https://api.anthropic.com/v1/messages/count_tokens?beta=true \ - `"clear_thinking_20251015"` - - `delta: object { container, stop_reason, stop_sequence }` + - `delta: object { container, stop_details, stop_reason, stop_sequence }` - `container: BetaContainer` @@ -25980,6 +26124,30 @@ curl https://api.anthropic.com/v1/messages/count_tokens?beta=true \ Skill version or 'latest' for most recent version + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason` - `"end_turn"` @@ -27124,6 +27292,32 @@ curl https://api.anthropic.com/v1/messages/count_tokens?beta=true \ - `"redacted_thinking"` +### Beta Refusal Stop Details + +- `BetaRefusalStopDetails = object { category, explanation, type }` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + ### Beta Request Document Block - `BetaRequestDocumentBlock = object { source, type, cache_control, 3 more }` @@ -34088,7 +34282,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -34130,6 +34324,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Body Parameters - `requests: array of object { custom_id, params }` @@ -34142,7 +34340,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Must be unique for each request within the Message Batch. - - `params: object { max_tokens, messages, model, 19 more }` + - `params: object { max_tokens, messages, model, 20 more }` Messages API creation parameters for the individual request. @@ -38810,6 +39008,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Recommended for advanced use cases only. You usually only need to use `temperature`. + - `user_profile_id: optional string` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + ### Returns - `BetaMessageBatch = object { id, archived_at, cancel_initiated_at, 7 more }` @@ -38903,7 +39105,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude ### Example ```http -curl https://api.anthropic.com/v1/messages/batches?beta=true \ +curl https://api.anthropic.com/v1/messages/batches \ -H 'Content-Type: application/json' \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: message-batches-2024-09-24' \ @@ -38949,7 +39151,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -38991,182 +39193,190 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` -### Returns - -- `BetaMessageBatch = object { id, archived_at, cancel_initiated_at, 7 more }` - - - `id: string` - - Unique object identifier. - - The format and length of IDs may change over time. - - - `archived_at: string` - - RFC 3339 datetime string representing the time at which the Message Batch was archived and its results became unavailable. - - - `cancel_initiated_at: string` + - `"output-300k-2026-03-24"` - RFC 3339 datetime string representing the time at which cancellation was initiated for the Message Batch. Specified only if cancellation was initiated. - - - `created_at: string` - - RFC 3339 datetime string representing the time at which the Message Batch was created. - - - `ended_at: string` - - RFC 3339 datetime string representing the time at which processing for the Message Batch ended. Specified only once processing ends. - - Processing ends when every request in a Message Batch has either succeeded, errored, canceled, or expired. - - - `expires_at: string` - - RFC 3339 datetime string representing the time at which the Message Batch will expire and end processing, which is 24 hours after creation. - - - `processing_status: "in_progress" or "canceling" or "ended"` - - Processing status of the Message Batch. - - - `"in_progress"` - - - `"canceling"` - - - `"ended"` - - - `request_counts: BetaMessageBatchRequestCounts` - - Tallies requests within the Message Batch, categorized by their status. - - Requests start as `processing` and move to one of the other statuses only once processing of the entire batch ends. The sum of all values always matches the total number of requests in the batch. - - - `canceled: number` - - Number of requests in the Message Batch that have been canceled. - - This is zero until processing of the entire Message Batch has ended. - - - `errored: number` - - Number of requests in the Message Batch that encountered an error. - - This is zero until processing of the entire Message Batch has ended. - - - `expired: number` - - Number of requests in the Message Batch that have expired. - - This is zero until processing of the entire Message Batch has ended. - - - `processing: number` - - Number of requests in the Message Batch that are processing. - - - `succeeded: number` - - Number of requests in the Message Batch that have completed successfully. - - This is zero until processing of the entire Message Batch has ended. - - - `results_url: string` - - URL to a `.jsonl` file containing the results of the Message Batch requests. Specified only once processing ends. - - Results in the file are not guaranteed to be in the same order as requests. Use the `custom_id` field to match results to requests. - - - `type: "message_batch"` - - Object type. - - For Message Batches, this is always `"message_batch"`. - - - `"message_batch"` - -### Example - -```http -curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID?beta=true \ - -H 'anthropic-version: 2023-06-01' \ - -H 'anthropic-beta: message-batches-2024-09-24' \ - -H "X-Api-Key: $ANTHROPIC_API_KEY" -``` - -## List - -**get** `/v1/messages/batches` - -List all Message Batches within a Workspace. Most recently created batches are returned first. - -Learn more about the Message Batches API in our [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing) - -### Query Parameters - -- `after_id: optional string` - - ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object. - -- `before_id: optional string` - - ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object. - -- `limit: optional number` - - Number of items to return per page. - - Defaults to `20`. Ranges from `1` to `1000`. - -### Header Parameters - -- `"anthropic-beta": optional array of AnthropicBeta` - - Optional header to specify the beta version(s) you want to use. - - - `UnionMember0 = string` - - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` - - - `"message-batches-2024-09-24"` - - - `"prompt-caching-2024-07-31"` - - - `"computer-use-2024-10-22"` - - - `"computer-use-2025-01-24"` - - - `"pdfs-2024-09-25"` - - - `"token-counting-2024-11-01"` - - - `"token-efficient-tools-2025-02-19"` - - - `"output-128k-2025-02-19"` - - - `"files-api-2025-04-14"` - - - `"mcp-client-2025-04-04"` - - - `"mcp-client-2025-11-20"` - - - `"dev-full-thinking-2025-05-14"` - - - `"interleaved-thinking-2025-05-14"` - - - `"code-execution-2025-05-22"` - - - `"extended-cache-ttl-2025-04-11"` - - - `"context-1m-2025-08-07"` - - - `"context-management-2025-06-27"` - - - `"model-context-window-exceeded-2025-08-26"` - - - `"skills-2025-10-02"` - - - `"fast-mode-2026-02-01"` + - `"user-profiles-2026-03-24"` ### Returns -- `data: array of BetaMessageBatch` +- `BetaMessageBatch = object { id, archived_at, cancel_initiated_at, 7 more }` + + - `id: string` + + Unique object identifier. + + The format and length of IDs may change over time. + + - `archived_at: string` + + RFC 3339 datetime string representing the time at which the Message Batch was archived and its results became unavailable. + + - `cancel_initiated_at: string` + + RFC 3339 datetime string representing the time at which cancellation was initiated for the Message Batch. Specified only if cancellation was initiated. + + - `created_at: string` + + RFC 3339 datetime string representing the time at which the Message Batch was created. + + - `ended_at: string` + + RFC 3339 datetime string representing the time at which processing for the Message Batch ended. Specified only once processing ends. + + Processing ends when every request in a Message Batch has either succeeded, errored, canceled, or expired. + + - `expires_at: string` + + RFC 3339 datetime string representing the time at which the Message Batch will expire and end processing, which is 24 hours after creation. + + - `processing_status: "in_progress" or "canceling" or "ended"` + + Processing status of the Message Batch. + + - `"in_progress"` + + - `"canceling"` + + - `"ended"` + + - `request_counts: BetaMessageBatchRequestCounts` + + Tallies requests within the Message Batch, categorized by their status. + + Requests start as `processing` and move to one of the other statuses only once processing of the entire batch ends. The sum of all values always matches the total number of requests in the batch. + + - `canceled: number` + + Number of requests in the Message Batch that have been canceled. + + This is zero until processing of the entire Message Batch has ended. + + - `errored: number` + + Number of requests in the Message Batch that encountered an error. + + This is zero until processing of the entire Message Batch has ended. + + - `expired: number` + + Number of requests in the Message Batch that have expired. + + This is zero until processing of the entire Message Batch has ended. + + - `processing: number` + + Number of requests in the Message Batch that are processing. + + - `succeeded: number` + + Number of requests in the Message Batch that have completed successfully. + + This is zero until processing of the entire Message Batch has ended. + + - `results_url: string` + + URL to a `.jsonl` file containing the results of the Message Batch requests. Specified only once processing ends. + + Results in the file are not guaranteed to be in the same order as requests. Use the `custom_id` field to match results to requests. + + - `type: "message_batch"` + + Object type. + + For Message Batches, this is always `"message_batch"`. + + - `"message_batch"` + +### Example + +```http +curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID \ + -H 'anthropic-version: 2023-06-01' \ + -H 'anthropic-beta: message-batches-2024-09-24' \ + -H "X-Api-Key: $ANTHROPIC_API_KEY" +``` + +## List + +**get** `/v1/messages/batches` + +List all Message Batches within a Workspace. Most recently created batches are returned first. + +Learn more about the Message Batches API in our [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing) + +### Query Parameters + +- `after_id: optional string` + + ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object. + +- `before_id: optional string` + + ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object. + +- `limit: optional number` + + Number of items to return per page. + + Defaults to `20`. Ranges from `1` to `1000`. + +### Header Parameters + +- `"anthropic-beta": optional array of AnthropicBeta` + + Optional header to specify the beta version(s) you want to use. + + - `UnionMember0 = string` + + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `data: array of BetaMessageBatch` - `id: string` @@ -39269,7 +39479,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude ### Example ```http -curl https://api.anthropic.com/v1/messages/batches?beta=true \ +curl https://api.anthropic.com/v1/messages/batches \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: message-batches-2024-09-24' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" @@ -39299,7 +39509,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -39341,6 +39551,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaMessageBatch = object { id, archived_at, cancel_initiated_at, 7 more }` @@ -39434,7 +39648,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude ### Example ```http -curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID/cancel?beta=true \ +curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID/cancel \ -X POST \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: message-batches-2024-09-24' \ @@ -39465,7 +39679,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -39507,6 +39721,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaDeletedMessageBatch = object { id, type }` @@ -39526,7 +39744,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude ### Example ```http -curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID?beta=true \ +curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID \ -X DELETE \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: message-batches-2024-09-24' \ @@ -39557,7 +39775,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -39599,6 +39817,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaMessageBatchIndividualResponse = object { custom_id, result }` @@ -40616,6 +40838,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"assistant"` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -40928,7 +41174,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude ### Example ```http -curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID/results?beta=true \ +curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID/results \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: message-batches-2024-09-24' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" @@ -42165,6 +42411,30 @@ curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID/results?bet - `"assistant"` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -43513,6 +43783,30 @@ curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID/results?bet - `"assistant"` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -44823,6 +45117,30 @@ curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID/results?bet - `"assistant"` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -45048,7 +45366,7 @@ Upload File - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -45090,132 +45408,140 @@ Upload File - `"fast-mode-2026-02-01"` -### Returns - -- `FileMetadata = object { id, created_at, filename, 4 more }` - - - `id: string` - - Unique object identifier. - - The format and length of IDs may change over time. - - - `created_at: string` - - RFC 3339 datetime string representing when the file was created. - - - `filename: string` - - Original filename of the uploaded file. - - - `mime_type: string` - - MIME type of the file. - - - `size_bytes: number` + - `"output-300k-2026-03-24"` - Size of the file in bytes. - - - `type: "file"` - - Object type. - - For files, this is always `"file"`. - - - `"file"` - - - `downloadable: optional boolean` - - Whether the file can be downloaded. - -### Example - -```http -curl https://api.anthropic.com/v1/files?beta=true \ - -H 'Content-Type: multipart/form-data' \ - -H 'anthropic-version: 2023-06-01' \ - -H 'anthropic-beta: files-api-2025-04-14' \ - -H "X-Api-Key: $ANTHROPIC_API_KEY" \ - -F 'file=@/path/to/file' -``` - -## List - -**get** `/v1/files` - -List Files - -### Query Parameters - -- `after_id: optional string` - - ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object. - -- `before_id: optional string` - - ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object. - -- `limit: optional number` - - Number of items to return per page. - - Defaults to `20`. Ranges from `1` to `1000`. - -### Header Parameters - -- `"anthropic-beta": optional array of AnthropicBeta` - - Optional header to specify the beta version(s) you want to use. - - - `UnionMember0 = string` - - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` - - - `"message-batches-2024-09-24"` - - - `"prompt-caching-2024-07-31"` - - - `"computer-use-2024-10-22"` - - - `"computer-use-2025-01-24"` - - - `"pdfs-2024-09-25"` - - - `"token-counting-2024-11-01"` - - - `"token-efficient-tools-2025-02-19"` - - - `"output-128k-2025-02-19"` - - - `"files-api-2025-04-14"` - - - `"mcp-client-2025-04-04"` - - - `"mcp-client-2025-11-20"` - - - `"dev-full-thinking-2025-05-14"` - - - `"interleaved-thinking-2025-05-14"` - - - `"code-execution-2025-05-22"` - - - `"extended-cache-ttl-2025-04-11"` - - - `"context-1m-2025-08-07"` - - - `"context-management-2025-06-27"` - - - `"model-context-window-exceeded-2025-08-26"` - - - `"skills-2025-10-02"` - - - `"fast-mode-2026-02-01"` + - `"user-profiles-2026-03-24"` ### Returns -- `data: array of FileMetadata` - - List of file metadata objects. +- `FileMetadata = object { id, created_at, filename, 4 more }` + + - `id: string` + + Unique object identifier. + + The format and length of IDs may change over time. + + - `created_at: string` + + RFC 3339 datetime string representing when the file was created. + + - `filename: string` + + Original filename of the uploaded file. + + - `mime_type: string` + + MIME type of the file. + + - `size_bytes: number` + + Size of the file in bytes. + + - `type: "file"` + + Object type. + + For files, this is always `"file"`. + + - `"file"` + + - `downloadable: optional boolean` + + Whether the file can be downloaded. + +### Example + +```http +curl https://api.anthropic.com/v1/files \ + -H 'Content-Type: multipart/form-data' \ + -H 'anthropic-version: 2023-06-01' \ + -H 'anthropic-beta: files-api-2025-04-14' \ + -H "X-Api-Key: $ANTHROPIC_API_KEY" \ + -F 'file=@/path/to/file' +``` + +## List + +**get** `/v1/files` + +List Files + +### Query Parameters + +- `after_id: optional string` + + ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object. + +- `before_id: optional string` + + ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object. + +- `limit: optional number` + + Number of items to return per page. + + Defaults to `20`. Ranges from `1` to `1000`. + +### Header Parameters + +- `"anthropic-beta": optional array of AnthropicBeta` + + Optional header to specify the beta version(s) you want to use. + + - `UnionMember0 = string` + + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `data: array of FileMetadata` + + List of file metadata objects. - `id: string` @@ -45266,7 +45592,7 @@ List Files ### Example ```http -curl https://api.anthropic.com/v1/files?beta=true \ +curl https://api.anthropic.com/v1/files \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: files-api-2025-04-14' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" @@ -45292,7 +45618,7 @@ Download File - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -45334,10 +45660,14 @@ Download File - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Example ```http -curl https://api.anthropic.com/v1/files/$FILE_ID/content?beta=true \ +curl https://api.anthropic.com/v1/files/$FILE_ID/content \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: files-api-2025-04-14' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" @@ -45363,7 +45693,7 @@ Get File Metadata - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -45405,6 +45735,10 @@ Get File Metadata - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `FileMetadata = object { id, created_at, filename, 4 more }` @@ -45446,7 +45780,7 @@ Get File Metadata ### Example ```http -curl https://api.anthropic.com/v1/files/$FILE_ID?beta=true \ +curl https://api.anthropic.com/v1/files/$FILE_ID \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: files-api-2025-04-14' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" @@ -45472,7 +45806,7 @@ Delete File - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -45514,6 +45848,10 @@ Delete File - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `DeletedFile = object { id, type }` @@ -45533,7 +45871,7 @@ Delete File ### Example ```http -curl https://api.anthropic.com/v1/files/$FILE_ID?beta=true \ +curl https://api.anthropic.com/v1/files/$FILE_ID \ -X DELETE \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: files-api-2025-04-14' \ @@ -45612,7 +45950,7 @@ Create Skill - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -45654,6 +45992,10 @@ Create Skill - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `id: string` @@ -45700,7 +46042,7 @@ Create Skill ### Example ```http -curl https://api.anthropic.com/v1/skills?beta=true \ +curl https://api.anthropic.com/v1/skills \ -X POST \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ @@ -45744,7 +46086,7 @@ List Skills - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -45786,6 +46128,10 @@ List Skills - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `data: array of object { id, created_at, display_title, 4 more }` @@ -45848,7 +46194,7 @@ List Skills ### Example ```http -curl https://api.anthropic.com/v1/skills?beta=true \ +curl https://api.anthropic.com/v1/skills \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" @@ -45876,7 +46222,7 @@ Get Skill - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -45918,6 +46264,10 @@ Get Skill - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `id: string` @@ -45964,7 +46314,7 @@ Get Skill ### Example ```http -curl https://api.anthropic.com/v1/skills/$SKILL_ID?beta=true \ +curl https://api.anthropic.com/v1/skills/$SKILL_ID \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" @@ -45992,7 +46342,7 @@ Delete Skill - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -46034,6 +46384,10 @@ Delete Skill - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `id: string` @@ -46051,13 +46405,166 @@ Delete Skill ### Example ```http -curl https://api.anthropic.com/v1/skills/$SKILL_ID?beta=true \ +curl https://api.anthropic.com/v1/skills/$SKILL_ID \ -X DELETE \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" ``` +## Domain Types + +### Skill Create Response + +- `SkillCreateResponse = object { id, created_at, display_title, 4 more }` + + - `id: string` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + + - `created_at: string` + + ISO 8601 timestamp of when the skill was created. + + - `display_title: string` + + Display title for the skill. + + This is a human-readable label that is not included in the prompt sent to the model. + + - `latest_version: string` + + The latest version identifier for the skill. + + This represents the most recent version of the skill that has been created. + + - `source: string` + + Source of the skill. + + This may be one of the following values: + + * `"custom"`: the skill was created by a user + * `"anthropic"`: the skill was created by Anthropic + + - `type: string` + + Object type. + + For Skills, this is always `"skill"`. + + - `updated_at: string` + + ISO 8601 timestamp of when the skill was last updated. + +### Skill List Response + +- `SkillListResponse = object { id, created_at, display_title, 4 more }` + + - `id: string` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + + - `created_at: string` + + ISO 8601 timestamp of when the skill was created. + + - `display_title: string` + + Display title for the skill. + + This is a human-readable label that is not included in the prompt sent to the model. + + - `latest_version: string` + + The latest version identifier for the skill. + + This represents the most recent version of the skill that has been created. + + - `source: string` + + Source of the skill. + + This may be one of the following values: + + * `"custom"`: the skill was created by a user + * `"anthropic"`: the skill was created by Anthropic + + - `type: string` + + Object type. + + For Skills, this is always `"skill"`. + + - `updated_at: string` + + ISO 8601 timestamp of when the skill was last updated. + +### Skill Retrieve Response + +- `SkillRetrieveResponse = object { id, created_at, display_title, 4 more }` + + - `id: string` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + + - `created_at: string` + + ISO 8601 timestamp of when the skill was created. + + - `display_title: string` + + Display title for the skill. + + This is a human-readable label that is not included in the prompt sent to the model. + + - `latest_version: string` + + The latest version identifier for the skill. + + This represents the most recent version of the skill that has been created. + + - `source: string` + + Source of the skill. + + This may be one of the following values: + + * `"custom"`: the skill was created by a user + * `"anthropic"`: the skill was created by Anthropic + + - `type: string` + + Object type. + + For Skills, this is always `"skill"`. + + - `updated_at: string` + + ISO 8601 timestamp of when the skill was last updated. + +### Skill Delete Response + +- `SkillDeleteResponse = object { id, type }` + + - `id: string` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + + - `type: string` + + Deleted object type. + + For Skills, this is always `"skill_deleted"`. + # Versions ## Create @@ -46082,7 +46589,7 @@ Create Skill Version - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -46124,6 +46631,10 @@ Create Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `id: string` @@ -46173,7 +46684,7 @@ Create Skill Version ### Example ```http -curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions?beta=true \ +curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \ -X POST \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ @@ -46214,7 +46725,7 @@ List Skill Versions - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -46256,6 +46767,10 @@ List Skill Versions - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `data: array of object { id, created_at, description, 5 more }` @@ -46317,7 +46832,7 @@ List Skill Versions ### Example ```http -curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions?beta=true \ +curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" @@ -46351,7 +46866,7 @@ Get Skill Version - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -46393,6 +46908,10 @@ Get Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `id: string` @@ -46442,7 +46961,7 @@ Get Skill Version ### Example ```http -curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION?beta=true \ +curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" @@ -46476,7 +46995,7 @@ Delete Skill Version - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -46518,6 +47037,10 @@ Delete Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `id: string` @@ -46535,9 +47058,723 @@ Delete Skill Version ### Example ```http -curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION?beta=true \ +curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \ -X DELETE \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" ``` + +## Domain Types + +### Version Create Response + +- `VersionCreateResponse = object { id, created_at, description, 5 more }` + + - `id: string` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: string` + + ISO 8601 timestamp of when the skill version was created. + + - `description: string` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: string` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: string` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: string` + + Identifier for the skill that this version belongs to. + + - `type: string` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: string` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version List Response + +- `VersionListResponse = object { id, created_at, description, 5 more }` + + - `id: string` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: string` + + ISO 8601 timestamp of when the skill version was created. + + - `description: string` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: string` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: string` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: string` + + Identifier for the skill that this version belongs to. + + - `type: string` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: string` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version Retrieve Response + +- `VersionRetrieveResponse = object { id, created_at, description, 5 more }` + + - `id: string` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: string` + + ISO 8601 timestamp of when the skill version was created. + + - `description: string` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: string` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: string` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: string` + + Identifier for the skill that this version belongs to. + + - `type: string` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: string` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version Delete Response + +- `VersionDeleteResponse = object { id, type }` + + - `id: string` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + + - `type: string` + + Deleted object type. + + For Skill Versions, this is always `"skill_version_deleted"`. + +# User Profiles + +## Create + +**post** `/v1/user_profiles` + +Create User Profile + +### Header Parameters + +- `"anthropic-beta": optional array of AnthropicBeta` + + Optional header to specify the beta version(s) you want to use. + + - `UnionMember0 = string` + + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Body Parameters + +- `external_id: optional string` + +- `metadata: optional map[string]` + + Free-form key-value data to attach to this user profile. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. Values must be non-empty strings. + +### Returns + +- `BetaUserProfile = object { id, created_at, metadata, 4 more }` + + - `id: string` + + - `created_at: string` + + A timestamp in RFC 3339 format + + - `metadata: map[string]` + + - `trust_grants: map[BetaUserProfileTrustGrant]` + + - `status: string` + + - `type: string` + + - `updated_at: string` + + A timestamp in RFC 3339 format + + - `external_id: optional string` + +### Example + +```http +curl https://api.anthropic.com/v1/user_profiles \ + -H 'Content-Type: application/json' \ + -H 'anthropic-version: 2023-06-01' \ + -H 'anthropic-beta: user-profiles-2026-03-24' \ + -H "X-Api-Key: $ANTHROPIC_API_KEY" \ + -d '{}' +``` + +## List + +**get** `/v1/user_profiles` + +List User Profiles + +### Query Parameters + +- `limit: optional number` + + Query parameter for limit + +- `order: optional "asc" or "desc"` + + Query parameter for order + + - `"asc"` + + - `"desc"` + +- `page: optional string` + + Query parameter for page + +### Header Parameters + +- `"anthropic-beta": optional array of AnthropicBeta` + + Optional header to specify the beta version(s) you want to use. + + - `UnionMember0 = string` + + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `data: array of BetaUserProfile` + + - `id: string` + + - `created_at: string` + + A timestamp in RFC 3339 format + + - `metadata: map[string]` + + - `trust_grants: map[BetaUserProfileTrustGrant]` + + - `status: string` + + - `type: string` + + - `updated_at: string` + + A timestamp in RFC 3339 format + + - `external_id: optional string` + +- `next_page: optional string` + +### Example + +```http +curl https://api.anthropic.com/v1/user_profiles \ + -H 'anthropic-version: 2023-06-01' \ + -H 'anthropic-beta: user-profiles-2026-03-24' \ + -H "X-Api-Key: $ANTHROPIC_API_KEY" +``` + +## Retrieve + +**get** `/v1/user_profiles/{id}` + +Get User Profile + +### Path Parameters + +- `id: string` + +### Header Parameters + +- `"anthropic-beta": optional array of AnthropicBeta` + + Optional header to specify the beta version(s) you want to use. + + - `UnionMember0 = string` + + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `BetaUserProfile = object { id, created_at, metadata, 4 more }` + + - `id: string` + + - `created_at: string` + + A timestamp in RFC 3339 format + + - `metadata: map[string]` + + - `trust_grants: map[BetaUserProfileTrustGrant]` + + - `status: string` + + - `type: string` + + - `updated_at: string` + + A timestamp in RFC 3339 format + + - `external_id: optional string` + +### Example + +```http +curl https://api.anthropic.com/v1/user_profiles/$ID \ + -H 'anthropic-version: 2023-06-01' \ + -H 'anthropic-beta: user-profiles-2026-03-24' \ + -H "X-Api-Key: $ANTHROPIC_API_KEY" +``` + +## Update + +**post** `/v1/user_profiles/{id}` + +Update User Profile + +### Path Parameters + +- `id: string` + +### Header Parameters + +- `"anthropic-beta": optional array of AnthropicBeta` + + Optional header to specify the beta version(s) you want to use. + + - `UnionMember0 = string` + + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Body Parameters + +- `external_id: optional string` + +- `metadata: optional map[string]` + + Key-value pairs to merge into the stored metadata. Keys provided overwrite existing values. To remove a key, set its value to an empty string. Keys not provided are left unchanged. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. + +### Returns + +- `BetaUserProfile = object { id, created_at, metadata, 4 more }` + + - `id: string` + + - `created_at: string` + + A timestamp in RFC 3339 format + + - `metadata: map[string]` + + - `trust_grants: map[BetaUserProfileTrustGrant]` + + - `status: string` + + - `type: string` + + - `updated_at: string` + + A timestamp in RFC 3339 format + + - `external_id: optional string` + +### Example + +```http +curl https://api.anthropic.com/v1/user_profiles/$ID \ + -H 'Content-Type: application/json' \ + -H 'anthropic-version: 2023-06-01' \ + -H 'anthropic-beta: user-profiles-2026-03-24' \ + -H "X-Api-Key: $ANTHROPIC_API_KEY" \ + -d '{}' +``` + +## Create Enrollment URL + +**post** `/v1/user_profiles/{id}/enrollment_url` + +Create Enrollment URL + +### Path Parameters + +- `id: string` + +### Header Parameters + +- `"anthropic-beta": optional array of AnthropicBeta` + + Optional header to specify the beta version(s) you want to use. + + - `UnionMember0 = string` + + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `BetaUserProfileEnrollmentURL = object { expires_at, type, url }` + + - `expires_at: string` + + A timestamp in RFC 3339 format + + - `type: string` + + - `url: string` + +### Example + +```http +curl https://api.anthropic.com/v1/user_profiles/$ID/enrollment_url \ + -X POST \ + -H 'anthropic-version: 2023-06-01' \ + -H 'anthropic-beta: user-profiles-2026-03-24' \ + -H "X-Api-Key: $ANTHROPIC_API_KEY" +``` + +## Domain Types + +### Beta User Profile + +- `BetaUserProfile = object { id, created_at, metadata, 4 more }` + + - `id: string` + + - `created_at: string` + + A timestamp in RFC 3339 format + + - `metadata: map[string]` + + - `trust_grants: map[BetaUserProfileTrustGrant]` + + - `status: string` + + - `type: string` + + - `updated_at: string` + + A timestamp in RFC 3339 format + + - `external_id: optional string` + +### Beta User Profile Enrollment URL + +- `BetaUserProfileEnrollmentURL = object { expires_at, type, url }` + + - `expires_at: string` + + A timestamp in RFC 3339 format + + - `type: string` + + - `url: string` + +### Beta User Profile Trust Grant + +- `BetaUserProfileTrustGrant = object { status }` + + - `status: string` diff --git a/content/en/api/beta/files.md b/content/en/api/beta/files.md index c13ce3334..cd40bc85b 100644 --- a/content/en/api/beta/files.md +++ b/content/en/api/beta/files.md @@ -14,7 +14,7 @@ Upload File - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -56,6 +56,10 @@ Upload File - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `FileMetadata = object { id, created_at, filename, 4 more }` @@ -97,7 +101,7 @@ Upload File ### Example ```http -curl https://api.anthropic.com/v1/files?beta=true \ +curl https://api.anthropic.com/v1/files \ -H 'Content-Type: multipart/form-data' \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: files-api-2025-04-14' \ @@ -135,7 +139,7 @@ List Files - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -177,6 +181,10 @@ List Files - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `data: array of FileMetadata` @@ -232,7 +240,7 @@ List Files ### Example ```http -curl https://api.anthropic.com/v1/files?beta=true \ +curl https://api.anthropic.com/v1/files \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: files-api-2025-04-14' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" @@ -258,7 +266,7 @@ Download File - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -300,10 +308,14 @@ Download File - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Example ```http -curl https://api.anthropic.com/v1/files/$FILE_ID/content?beta=true \ +curl https://api.anthropic.com/v1/files/$FILE_ID/content \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: files-api-2025-04-14' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" @@ -329,7 +341,7 @@ Get File Metadata - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -371,6 +383,10 @@ Get File Metadata - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `FileMetadata = object { id, created_at, filename, 4 more }` @@ -412,7 +428,7 @@ Get File Metadata ### Example ```http -curl https://api.anthropic.com/v1/files/$FILE_ID?beta=true \ +curl https://api.anthropic.com/v1/files/$FILE_ID \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: files-api-2025-04-14' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" @@ -438,7 +454,7 @@ Delete File - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -480,6 +496,10 @@ Delete File - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `DeletedFile = object { id, type }` @@ -499,7 +519,7 @@ Delete File ### Example ```http -curl https://api.anthropic.com/v1/files/$FILE_ID?beta=true \ +curl https://api.anthropic.com/v1/files/$FILE_ID \ -X DELETE \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: files-api-2025-04-14' \ diff --git a/content/en/api/beta/files/delete.md b/content/en/api/beta/files/delete.md index 810c1ffb9..7009deee2 100644 --- a/content/en/api/beta/files/delete.md +++ b/content/en/api/beta/files/delete.md @@ -18,7 +18,7 @@ Delete File - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -60,6 +60,10 @@ Delete File - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `DeletedFile = object { id, type }` @@ -79,7 +83,7 @@ Delete File ### Example ```http -curl https://api.anthropic.com/v1/files/$FILE_ID?beta=true \ +curl https://api.anthropic.com/v1/files/$FILE_ID \ -X DELETE \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: files-api-2025-04-14' \ diff --git a/content/en/api/beta/files/download.md b/content/en/api/beta/files/download.md index adfbc3eb0..8d1164776 100644 --- a/content/en/api/beta/files/download.md +++ b/content/en/api/beta/files/download.md @@ -18,7 +18,7 @@ Download File - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -60,10 +60,14 @@ Download File - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Example ```http -curl https://api.anthropic.com/v1/files/$FILE_ID/content?beta=true \ +curl https://api.anthropic.com/v1/files/$FILE_ID/content \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: files-api-2025-04-14' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" diff --git a/content/en/api/beta/files/list.md b/content/en/api/beta/files/list.md index fa9d14962..8668a0ba0 100644 --- a/content/en/api/beta/files/list.md +++ b/content/en/api/beta/files/list.md @@ -28,7 +28,7 @@ List Files - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -70,6 +70,10 @@ List Files - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `data: array of FileMetadata` @@ -125,7 +129,7 @@ List Files ### Example ```http -curl https://api.anthropic.com/v1/files?beta=true \ +curl https://api.anthropic.com/v1/files \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: files-api-2025-04-14' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" diff --git a/content/en/api/beta/files/retrieve_metadata.md b/content/en/api/beta/files/retrieve_metadata.md index 6b7a9df28..2172981e2 100644 --- a/content/en/api/beta/files/retrieve_metadata.md +++ b/content/en/api/beta/files/retrieve_metadata.md @@ -18,7 +18,7 @@ Get File Metadata - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -60,6 +60,10 @@ Get File Metadata - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `FileMetadata = object { id, created_at, filename, 4 more }` @@ -101,7 +105,7 @@ Get File Metadata ### Example ```http -curl https://api.anthropic.com/v1/files/$FILE_ID?beta=true \ +curl https://api.anthropic.com/v1/files/$FILE_ID \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: files-api-2025-04-14' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" diff --git a/content/en/api/beta/files/upload.md b/content/en/api/beta/files/upload.md index 501c6393d..47b2d0fc5 100644 --- a/content/en/api/beta/files/upload.md +++ b/content/en/api/beta/files/upload.md @@ -12,7 +12,7 @@ Upload File - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -54,6 +54,10 @@ Upload File - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `FileMetadata = object { id, created_at, filename, 4 more }` @@ -95,7 +99,7 @@ Upload File ### Example ```http -curl https://api.anthropic.com/v1/files?beta=true \ +curl https://api.anthropic.com/v1/files \ -H 'Content-Type: multipart/form-data' \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: files-api-2025-04-14' \ diff --git a/content/en/api/beta/messages.md b/content/en/api/beta/messages.md index 5300a1bb6..b01a5b1ef 100644 --- a/content/en/api/beta/messages.md +++ b/content/en/api/beta/messages.md @@ -18,7 +18,7 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -60,6 +60,10 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Body Parameters - `max_tokens: number` @@ -4724,9 +4728,13 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en Recommended for advanced use cases only. You usually only need to use `temperature`. +- `user_profile_id: optional string` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + ### Returns -- `BetaMessage = object { id, container, content, 7 more }` +- `BetaMessage = object { id, container, content, 8 more }` - `id: string` @@ -5723,6 +5731,30 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `"assistant"` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -5931,7 +5963,7 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en ### Example ```http -curl https://api.anthropic.com/v1/messages?beta=true \ +curl https://api.anthropic.com/v1/messages \ -H 'Content-Type: application/json' \ -H 'anthropic-version: 2023-06-01' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" \ @@ -5966,7 +5998,7 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -6008,6 +6040,10 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Body Parameters - `messages: array of BetaMessageParam` @@ -10587,7 +10623,7 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d ### Example ```http -curl https://api.anthropic.com/v1/messages/count_tokens?beta=true \ +curl https://api.anthropic.com/v1/messages/count_tokens \ -H 'Content-Type: application/json' \ -H 'anthropic-version: 2023-06-01' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" \ @@ -16866,7 +16902,7 @@ curl https://api.anthropic.com/v1/messages/count_tokens?beta=true \ ### Beta Message -- `BetaMessage = object { id, container, content, 7 more }` +- `BetaMessage = object { id, container, content, 8 more }` - `id: string` @@ -17863,6 +17899,30 @@ curl https://api.anthropic.com/v1/messages/count_tokens?beta=true \ - `"assistant"` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -21974,7 +22034,7 @@ curl https://api.anthropic.com/v1/messages/count_tokens?beta=true \ - `"clear_thinking_20251015"` - - `delta: object { container, stop_reason, stop_sequence }` + - `delta: object { container, stop_details, stop_reason, stop_sequence }` - `container: BetaContainer` @@ -22008,6 +22068,30 @@ curl https://api.anthropic.com/v1/messages/count_tokens?beta=true \ Skill version or 'latest' for most recent version + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason` - `"end_turn"` @@ -23159,6 +23243,30 @@ curl https://api.anthropic.com/v1/messages/count_tokens?beta=true \ - `"assistant"` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -24379,6 +24487,30 @@ curl https://api.anthropic.com/v1/messages/count_tokens?beta=true \ - `"assistant"` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -24630,7 +24762,7 @@ curl https://api.anthropic.com/v1/messages/count_tokens?beta=true \ - `"clear_thinking_20251015"` - - `delta: object { container, stop_reason, stop_sequence }` + - `delta: object { container, stop_details, stop_reason, stop_sequence }` - `container: BetaContainer` @@ -24664,6 +24796,30 @@ curl https://api.anthropic.com/v1/messages/count_tokens?beta=true \ Skill version or 'latest' for most recent version + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason` - `"end_turn"` @@ -25808,6 +25964,32 @@ curl https://api.anthropic.com/v1/messages/count_tokens?beta=true \ - `"redacted_thinking"` +### Beta Refusal Stop Details + +- `BetaRefusalStopDetails = object { category, explanation, type }` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + ### Beta Request Document Block - `BetaRequestDocumentBlock = object { source, type, cache_control, 3 more }` @@ -32772,7 +32954,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -32814,6 +32996,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Body Parameters - `requests: array of object { custom_id, params }` @@ -32826,7 +33012,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Must be unique for each request within the Message Batch. - - `params: object { max_tokens, messages, model, 19 more }` + - `params: object { max_tokens, messages, model, 20 more }` Messages API creation parameters for the individual request. @@ -37494,6 +37680,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Recommended for advanced use cases only. You usually only need to use `temperature`. + - `user_profile_id: optional string` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + ### Returns - `BetaMessageBatch = object { id, archived_at, cancel_initiated_at, 7 more }` @@ -37587,7 +37777,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude ### Example ```http -curl https://api.anthropic.com/v1/messages/batches?beta=true \ +curl https://api.anthropic.com/v1/messages/batches \ -H 'Content-Type: application/json' \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: message-batches-2024-09-24' \ @@ -37633,7 +37823,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -37675,6 +37865,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaMessageBatch = object { id, archived_at, cancel_initiated_at, 7 more }` @@ -37768,7 +37962,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude ### Example ```http -curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID?beta=true \ +curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: message-batches-2024-09-24' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" @@ -37806,7 +38000,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -37848,6 +38042,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `data: array of BetaMessageBatch` @@ -37953,7 +38151,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude ### Example ```http -curl https://api.anthropic.com/v1/messages/batches?beta=true \ +curl https://api.anthropic.com/v1/messages/batches \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: message-batches-2024-09-24' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" @@ -37983,7 +38181,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -38025,6 +38223,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaMessageBatch = object { id, archived_at, cancel_initiated_at, 7 more }` @@ -38118,7 +38320,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude ### Example ```http -curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID/cancel?beta=true \ +curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID/cancel \ -X POST \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: message-batches-2024-09-24' \ @@ -38149,7 +38351,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -38191,6 +38393,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaDeletedMessageBatch = object { id, type }` @@ -38210,7 +38416,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude ### Example ```http -curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID?beta=true \ +curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID \ -X DELETE \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: message-batches-2024-09-24' \ @@ -38241,7 +38447,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -38283,6 +38489,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaMessageBatchIndividualResponse = object { custom_id, result }` @@ -39300,6 +39510,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"assistant"` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -39612,7 +39846,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude ### Example ```http -curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID/results?beta=true \ +curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID/results \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: message-batches-2024-09-24' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" @@ -40849,6 +41083,30 @@ curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID/results?bet - `"assistant"` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -42197,6 +42455,30 @@ curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID/results?bet - `"assistant"` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -43507,6 +43789,30 @@ curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID/results?bet - `"assistant"` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason` The reason that we stopped. diff --git a/content/en/api/beta/messages/batches.md b/content/en/api/beta/messages/batches.md index ee3360bc4..1e6c99d13 100644 --- a/content/en/api/beta/messages/batches.md +++ b/content/en/api/beta/messages/batches.md @@ -18,7 +18,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -60,6 +60,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Body Parameters - `requests: array of object { custom_id, params }` @@ -72,7 +76,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Must be unique for each request within the Message Batch. - - `params: object { max_tokens, messages, model, 19 more }` + - `params: object { max_tokens, messages, model, 20 more }` Messages API creation parameters for the individual request. @@ -4740,6 +4744,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Recommended for advanced use cases only. You usually only need to use `temperature`. + - `user_profile_id: optional string` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + ### Returns - `BetaMessageBatch = object { id, archived_at, cancel_initiated_at, 7 more }` @@ -4833,7 +4841,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude ### Example ```http -curl https://api.anthropic.com/v1/messages/batches?beta=true \ +curl https://api.anthropic.com/v1/messages/batches \ -H 'Content-Type: application/json' \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: message-batches-2024-09-24' \ @@ -4879,7 +4887,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -4921,6 +4929,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaMessageBatch = object { id, archived_at, cancel_initiated_at, 7 more }` @@ -5014,7 +5026,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude ### Example ```http -curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID?beta=true \ +curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: message-batches-2024-09-24' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" @@ -5052,7 +5064,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -5094,6 +5106,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `data: array of BetaMessageBatch` @@ -5199,7 +5215,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude ### Example ```http -curl https://api.anthropic.com/v1/messages/batches?beta=true \ +curl https://api.anthropic.com/v1/messages/batches \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: message-batches-2024-09-24' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" @@ -5229,7 +5245,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -5271,6 +5287,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaMessageBatch = object { id, archived_at, cancel_initiated_at, 7 more }` @@ -5364,7 +5384,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude ### Example ```http -curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID/cancel?beta=true \ +curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID/cancel \ -X POST \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: message-batches-2024-09-24' \ @@ -5395,7 +5415,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -5437,6 +5457,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaDeletedMessageBatch = object { id, type }` @@ -5456,7 +5480,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude ### Example ```http -curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID?beta=true \ +curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID \ -X DELETE \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: message-batches-2024-09-24' \ @@ -5487,7 +5511,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -5529,6 +5553,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaMessageBatchIndividualResponse = object { custom_id, result }` @@ -6546,6 +6574,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"assistant"` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -6858,7 +6910,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude ### Example ```http -curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID/results?beta=true \ +curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID/results \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: message-batches-2024-09-24' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" @@ -8095,6 +8147,30 @@ curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID/results?bet - `"assistant"` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -9443,6 +9519,30 @@ curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID/results?bet - `"assistant"` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -10753,6 +10853,30 @@ curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID/results?bet - `"assistant"` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason` The reason that we stopped. diff --git a/content/en/api/beta/messages/batches/cancel.md b/content/en/api/beta/messages/batches/cancel.md index 1047bb810..b637d8c84 100644 --- a/content/en/api/beta/messages/batches/cancel.md +++ b/content/en/api/beta/messages/batches/cancel.md @@ -22,7 +22,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -64,6 +64,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaMessageBatch = object { id, archived_at, cancel_initiated_at, 7 more }` @@ -157,7 +161,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude ### Example ```http -curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID/cancel?beta=true \ +curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID/cancel \ -X POST \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: message-batches-2024-09-24' \ diff --git a/content/en/api/beta/messages/batches/create.md b/content/en/api/beta/messages/batches/create.md index 7aeafe596..60945a961 100644 --- a/content/en/api/beta/messages/batches/create.md +++ b/content/en/api/beta/messages/batches/create.md @@ -16,7 +16,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -58,6 +58,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Body Parameters - `requests: array of object { custom_id, params }` @@ -70,7 +74,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Must be unique for each request within the Message Batch. - - `params: object { max_tokens, messages, model, 19 more }` + - `params: object { max_tokens, messages, model, 20 more }` Messages API creation parameters for the individual request. @@ -4738,6 +4742,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Recommended for advanced use cases only. You usually only need to use `temperature`. + - `user_profile_id: optional string` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + ### Returns - `BetaMessageBatch = object { id, archived_at, cancel_initiated_at, 7 more }` @@ -4831,7 +4839,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude ### Example ```http -curl https://api.anthropic.com/v1/messages/batches?beta=true \ +curl https://api.anthropic.com/v1/messages/batches \ -H 'Content-Type: application/json' \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: message-batches-2024-09-24' \ diff --git a/content/en/api/beta/messages/batches/delete.md b/content/en/api/beta/messages/batches/delete.md index 0e9afa2af..b2a0e521a 100644 --- a/content/en/api/beta/messages/batches/delete.md +++ b/content/en/api/beta/messages/batches/delete.md @@ -22,7 +22,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -64,6 +64,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaDeletedMessageBatch = object { id, type }` @@ -83,7 +87,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude ### Example ```http -curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID?beta=true \ +curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID \ -X DELETE \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: message-batches-2024-09-24' \ diff --git a/content/en/api/beta/messages/batches/list.md b/content/en/api/beta/messages/batches/list.md index 054fb43e8..602d870bd 100644 --- a/content/en/api/beta/messages/batches/list.md +++ b/content/en/api/beta/messages/batches/list.md @@ -30,7 +30,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -72,6 +72,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `data: array of BetaMessageBatch` @@ -177,7 +181,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude ### Example ```http -curl https://api.anthropic.com/v1/messages/batches?beta=true \ +curl https://api.anthropic.com/v1/messages/batches \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: message-batches-2024-09-24' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" diff --git a/content/en/api/beta/messages/batches/results.md b/content/en/api/beta/messages/batches/results.md index a1669c14e..fff5b6b91 100644 --- a/content/en/api/beta/messages/batches/results.md +++ b/content/en/api/beta/messages/batches/results.md @@ -22,7 +22,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -64,6 +64,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaMessageBatchIndividualResponse = object { custom_id, result }` @@ -1081,6 +1085,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"assistant"` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -1393,7 +1421,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude ### Example ```http -curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID/results?beta=true \ +curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID/results \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: message-batches-2024-09-24' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" diff --git a/content/en/api/beta/messages/batches/retrieve.md b/content/en/api/beta/messages/batches/retrieve.md index eb953b188..e90385f83 100644 --- a/content/en/api/beta/messages/batches/retrieve.md +++ b/content/en/api/beta/messages/batches/retrieve.md @@ -20,7 +20,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -62,6 +62,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaMessageBatch = object { id, archived_at, cancel_initiated_at, 7 more }` @@ -155,7 +159,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude ### Example ```http -curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID?beta=true \ +curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: message-batches-2024-09-24' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" diff --git a/content/en/api/beta/messages/count_tokens.md b/content/en/api/beta/messages/count_tokens.md index 90a1b91d4..b678e5997 100644 --- a/content/en/api/beta/messages/count_tokens.md +++ b/content/en/api/beta/messages/count_tokens.md @@ -16,7 +16,7 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -58,6 +58,10 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Body Parameters - `messages: array of BetaMessageParam` @@ -4637,7 +4641,7 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d ### Example ```http -curl https://api.anthropic.com/v1/messages/count_tokens?beta=true \ +curl https://api.anthropic.com/v1/messages/count_tokens \ -H 'Content-Type: application/json' \ -H 'anthropic-version: 2023-06-01' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" \ diff --git a/content/en/api/beta/messages/create.md b/content/en/api/beta/messages/create.md index eec98e597..412d127ef 100644 --- a/content/en/api/beta/messages/create.md +++ b/content/en/api/beta/messages/create.md @@ -16,7 +16,7 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -58,6 +58,10 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Body Parameters - `max_tokens: number` @@ -4722,9 +4726,13 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en Recommended for advanced use cases only. You usually only need to use `temperature`. +- `user_profile_id: optional string` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + ### Returns -- `BetaMessage = object { id, container, content, 7 more }` +- `BetaMessage = object { id, container, content, 8 more }` - `id: string` @@ -5721,6 +5729,30 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `"assistant"` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -5929,7 +5961,7 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en ### Example ```http -curl https://api.anthropic.com/v1/messages?beta=true \ +curl https://api.anthropic.com/v1/messages \ -H 'Content-Type: application/json' \ -H 'anthropic-version: 2023-06-01' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" \ diff --git a/content/en/api/beta/models.md b/content/en/api/beta/models.md index aa58a6d2e..ddf8c392a 100644 --- a/content/en/api/beta/models.md +++ b/content/en/api/beta/models.md @@ -32,7 +32,7 @@ The Models API response can be used to determine which models are available for - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -74,6 +74,10 @@ The Models API response can be used to determine which models are available for - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `data: array of BetaModelInfo` @@ -273,7 +277,7 @@ The Models API response can be used to determine which models are available for ### Example ```http -curl https://api.anthropic.com/v1/models?beta=true \ +curl https://api.anthropic.com/v1/models \ -H 'anthropic-version: 2023-06-01' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" ``` @@ -300,7 +304,7 @@ The Models API response can be used to determine information about a specific mo - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -342,6 +346,10 @@ The Models API response can be used to determine information about a specific mo - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaModelInfo = object { id, capabilities, created_at, 4 more }` @@ -529,7 +537,7 @@ The Models API response can be used to determine information about a specific mo ### Example ```http -curl https://api.anthropic.com/v1/models/$MODEL_ID?beta=true \ +curl https://api.anthropic.com/v1/models/$MODEL_ID \ -H 'anthropic-version: 2023-06-01' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" ``` diff --git a/content/en/api/beta/models/list.md b/content/en/api/beta/models/list.md index 972427362..261cff20d 100644 --- a/content/en/api/beta/models/list.md +++ b/content/en/api/beta/models/list.md @@ -30,7 +30,7 @@ The Models API response can be used to determine which models are available for - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -72,6 +72,10 @@ The Models API response can be used to determine which models are available for - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `data: array of BetaModelInfo` @@ -271,7 +275,7 @@ The Models API response can be used to determine which models are available for ### Example ```http -curl https://api.anthropic.com/v1/models?beta=true \ +curl https://api.anthropic.com/v1/models \ -H 'anthropic-version: 2023-06-01' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" ``` diff --git a/content/en/api/beta/models/retrieve.md b/content/en/api/beta/models/retrieve.md index 994c9cb51..b560585a2 100644 --- a/content/en/api/beta/models/retrieve.md +++ b/content/en/api/beta/models/retrieve.md @@ -20,7 +20,7 @@ The Models API response can be used to determine information about a specific mo - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -62,6 +62,10 @@ The Models API response can be used to determine information about a specific mo - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaModelInfo = object { id, capabilities, created_at, 4 more }` @@ -249,7 +253,7 @@ The Models API response can be used to determine information about a specific mo ### Example ```http -curl https://api.anthropic.com/v1/models/$MODEL_ID?beta=true \ +curl https://api.anthropic.com/v1/models/$MODEL_ID \ -H 'anthropic-version: 2023-06-01' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" ``` diff --git a/content/en/api/beta/skills.md b/content/en/api/beta/skills.md index 7add3fe6c..1f0df159b 100644 --- a/content/en/api/beta/skills.md +++ b/content/en/api/beta/skills.md @@ -14,7 +14,7 @@ Create Skill - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -56,6 +56,10 @@ Create Skill - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `id: string` @@ -102,7 +106,7 @@ Create Skill ### Example ```http -curl https://api.anthropic.com/v1/skills?beta=true \ +curl https://api.anthropic.com/v1/skills \ -X POST \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ @@ -146,7 +150,7 @@ List Skills - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -188,6 +192,10 @@ List Skills - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `data: array of object { id, created_at, display_title, 4 more }` @@ -250,7 +258,7 @@ List Skills ### Example ```http -curl https://api.anthropic.com/v1/skills?beta=true \ +curl https://api.anthropic.com/v1/skills \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" @@ -278,7 +286,7 @@ Get Skill - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -320,6 +328,10 @@ Get Skill - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `id: string` @@ -366,7 +378,7 @@ Get Skill ### Example ```http -curl https://api.anthropic.com/v1/skills/$SKILL_ID?beta=true \ +curl https://api.anthropic.com/v1/skills/$SKILL_ID \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" @@ -394,7 +406,7 @@ Delete Skill - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -436,6 +448,10 @@ Delete Skill - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `id: string` @@ -453,13 +469,166 @@ Delete Skill ### Example ```http -curl https://api.anthropic.com/v1/skills/$SKILL_ID?beta=true \ +curl https://api.anthropic.com/v1/skills/$SKILL_ID \ -X DELETE \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" ``` +## Domain Types + +### Skill Create Response + +- `SkillCreateResponse = object { id, created_at, display_title, 4 more }` + + - `id: string` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + + - `created_at: string` + + ISO 8601 timestamp of when the skill was created. + + - `display_title: string` + + Display title for the skill. + + This is a human-readable label that is not included in the prompt sent to the model. + + - `latest_version: string` + + The latest version identifier for the skill. + + This represents the most recent version of the skill that has been created. + + - `source: string` + + Source of the skill. + + This may be one of the following values: + + * `"custom"`: the skill was created by a user + * `"anthropic"`: the skill was created by Anthropic + + - `type: string` + + Object type. + + For Skills, this is always `"skill"`. + + - `updated_at: string` + + ISO 8601 timestamp of when the skill was last updated. + +### Skill List Response + +- `SkillListResponse = object { id, created_at, display_title, 4 more }` + + - `id: string` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + + - `created_at: string` + + ISO 8601 timestamp of when the skill was created. + + - `display_title: string` + + Display title for the skill. + + This is a human-readable label that is not included in the prompt sent to the model. + + - `latest_version: string` + + The latest version identifier for the skill. + + This represents the most recent version of the skill that has been created. + + - `source: string` + + Source of the skill. + + This may be one of the following values: + + * `"custom"`: the skill was created by a user + * `"anthropic"`: the skill was created by Anthropic + + - `type: string` + + Object type. + + For Skills, this is always `"skill"`. + + - `updated_at: string` + + ISO 8601 timestamp of when the skill was last updated. + +### Skill Retrieve Response + +- `SkillRetrieveResponse = object { id, created_at, display_title, 4 more }` + + - `id: string` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + + - `created_at: string` + + ISO 8601 timestamp of when the skill was created. + + - `display_title: string` + + Display title for the skill. + + This is a human-readable label that is not included in the prompt sent to the model. + + - `latest_version: string` + + The latest version identifier for the skill. + + This represents the most recent version of the skill that has been created. + + - `source: string` + + Source of the skill. + + This may be one of the following values: + + * `"custom"`: the skill was created by a user + * `"anthropic"`: the skill was created by Anthropic + + - `type: string` + + Object type. + + For Skills, this is always `"skill"`. + + - `updated_at: string` + + ISO 8601 timestamp of when the skill was last updated. + +### Skill Delete Response + +- `SkillDeleteResponse = object { id, type }` + + - `id: string` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + + - `type: string` + + Deleted object type. + + For Skills, this is always `"skill_deleted"`. + # Versions ## Create @@ -484,7 +653,7 @@ Create Skill Version - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -526,6 +695,10 @@ Create Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `id: string` @@ -575,7 +748,7 @@ Create Skill Version ### Example ```http -curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions?beta=true \ +curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \ -X POST \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ @@ -616,7 +789,7 @@ List Skill Versions - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -658,6 +831,10 @@ List Skill Versions - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `data: array of object { id, created_at, description, 5 more }` @@ -719,7 +896,7 @@ List Skill Versions ### Example ```http -curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions?beta=true \ +curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" @@ -753,7 +930,7 @@ Get Skill Version - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -795,6 +972,10 @@ Get Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `id: string` @@ -844,7 +1025,7 @@ Get Skill Version ### Example ```http -curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION?beta=true \ +curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" @@ -878,7 +1059,7 @@ Delete Skill Version - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -920,6 +1101,10 @@ Delete Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `id: string` @@ -937,9 +1122,171 @@ Delete Skill Version ### Example ```http -curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION?beta=true \ +curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \ -X DELETE \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" ``` + +## Domain Types + +### Version Create Response + +- `VersionCreateResponse = object { id, created_at, description, 5 more }` + + - `id: string` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: string` + + ISO 8601 timestamp of when the skill version was created. + + - `description: string` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: string` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: string` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: string` + + Identifier for the skill that this version belongs to. + + - `type: string` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: string` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version List Response + +- `VersionListResponse = object { id, created_at, description, 5 more }` + + - `id: string` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: string` + + ISO 8601 timestamp of when the skill version was created. + + - `description: string` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: string` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: string` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: string` + + Identifier for the skill that this version belongs to. + + - `type: string` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: string` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version Retrieve Response + +- `VersionRetrieveResponse = object { id, created_at, description, 5 more }` + + - `id: string` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: string` + + ISO 8601 timestamp of when the skill version was created. + + - `description: string` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: string` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: string` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: string` + + Identifier for the skill that this version belongs to. + + - `type: string` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: string` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version Delete Response + +- `VersionDeleteResponse = object { id, type }` + + - `id: string` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + + - `type: string` + + Deleted object type. + + For Skill Versions, this is always `"skill_version_deleted"`. diff --git a/content/en/api/beta/skills/create.md b/content/en/api/beta/skills/create.md index a6be72e08..e8f013249 100644 --- a/content/en/api/beta/skills/create.md +++ b/content/en/api/beta/skills/create.md @@ -12,7 +12,7 @@ Create Skill - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -54,6 +54,10 @@ Create Skill - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `id: string` @@ -100,7 +104,7 @@ Create Skill ### Example ```http -curl https://api.anthropic.com/v1/skills?beta=true \ +curl https://api.anthropic.com/v1/skills \ -X POST \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ diff --git a/content/en/api/beta/skills/delete.md b/content/en/api/beta/skills/delete.md index c572b8cb2..084cbefc1 100644 --- a/content/en/api/beta/skills/delete.md +++ b/content/en/api/beta/skills/delete.md @@ -20,7 +20,7 @@ Delete Skill - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -62,6 +62,10 @@ Delete Skill - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `id: string` @@ -79,7 +83,7 @@ Delete Skill ### Example ```http -curl https://api.anthropic.com/v1/skills/$SKILL_ID?beta=true \ +curl https://api.anthropic.com/v1/skills/$SKILL_ID \ -X DELETE \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ diff --git a/content/en/api/beta/skills/list.md b/content/en/api/beta/skills/list.md index 9537799c3..29bec9902 100644 --- a/content/en/api/beta/skills/list.md +++ b/content/en/api/beta/skills/list.md @@ -35,7 +35,7 @@ List Skills - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -77,6 +77,10 @@ List Skills - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `data: array of object { id, created_at, display_title, 4 more }` @@ -139,7 +143,7 @@ List Skills ### Example ```http -curl https://api.anthropic.com/v1/skills?beta=true \ +curl https://api.anthropic.com/v1/skills \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" diff --git a/content/en/api/beta/skills/retrieve.md b/content/en/api/beta/skills/retrieve.md index fca12aa62..814464b43 100644 --- a/content/en/api/beta/skills/retrieve.md +++ b/content/en/api/beta/skills/retrieve.md @@ -20,7 +20,7 @@ Get Skill - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -62,6 +62,10 @@ Get Skill - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `id: string` @@ -108,7 +112,7 @@ Get Skill ### Example ```http -curl https://api.anthropic.com/v1/skills/$SKILL_ID?beta=true \ +curl https://api.anthropic.com/v1/skills/$SKILL_ID \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" diff --git a/content/en/api/beta/skills/versions.md b/content/en/api/beta/skills/versions.md index 6a0f7ba01..7ae4e5869 100644 --- a/content/en/api/beta/skills/versions.md +++ b/content/en/api/beta/skills/versions.md @@ -22,7 +22,7 @@ Create Skill Version - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -64,6 +64,10 @@ Create Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `id: string` @@ -113,7 +117,7 @@ Create Skill Version ### Example ```http -curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions?beta=true \ +curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \ -X POST \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ @@ -154,7 +158,7 @@ List Skill Versions - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -196,6 +200,10 @@ List Skill Versions - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `data: array of object { id, created_at, description, 5 more }` @@ -257,7 +265,7 @@ List Skill Versions ### Example ```http -curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions?beta=true \ +curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" @@ -291,7 +299,7 @@ Get Skill Version - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -333,6 +341,10 @@ Get Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `id: string` @@ -382,7 +394,7 @@ Get Skill Version ### Example ```http -curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION?beta=true \ +curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" @@ -416,7 +428,7 @@ Delete Skill Version - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -458,6 +470,10 @@ Delete Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `id: string` @@ -475,9 +491,171 @@ Delete Skill Version ### Example ```http -curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION?beta=true \ +curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \ -X DELETE \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" ``` + +## Domain Types + +### Version Create Response + +- `VersionCreateResponse = object { id, created_at, description, 5 more }` + + - `id: string` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: string` + + ISO 8601 timestamp of when the skill version was created. + + - `description: string` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: string` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: string` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: string` + + Identifier for the skill that this version belongs to. + + - `type: string` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: string` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version List Response + +- `VersionListResponse = object { id, created_at, description, 5 more }` + + - `id: string` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: string` + + ISO 8601 timestamp of when the skill version was created. + + - `description: string` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: string` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: string` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: string` + + Identifier for the skill that this version belongs to. + + - `type: string` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: string` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version Retrieve Response + +- `VersionRetrieveResponse = object { id, created_at, description, 5 more }` + + - `id: string` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: string` + + ISO 8601 timestamp of when the skill version was created. + + - `description: string` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: string` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: string` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: string` + + Identifier for the skill that this version belongs to. + + - `type: string` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: string` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version Delete Response + +- `VersionDeleteResponse = object { id, type }` + + - `id: string` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + + - `type: string` + + Deleted object type. + + For Skill Versions, this is always `"skill_version_deleted"`. diff --git a/content/en/api/beta/skills/versions/create.md b/content/en/api/beta/skills/versions/create.md index f97145615..1fb7211be 100644 --- a/content/en/api/beta/skills/versions/create.md +++ b/content/en/api/beta/skills/versions/create.md @@ -20,7 +20,7 @@ Create Skill Version - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -62,6 +62,10 @@ Create Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `id: string` @@ -111,7 +115,7 @@ Create Skill Version ### Example ```http -curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions?beta=true \ +curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \ -X POST \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ diff --git a/content/en/api/beta/skills/versions/delete.md b/content/en/api/beta/skills/versions/delete.md index fd0882d66..a60aee72e 100644 --- a/content/en/api/beta/skills/versions/delete.md +++ b/content/en/api/beta/skills/versions/delete.md @@ -26,7 +26,7 @@ Delete Skill Version - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -68,6 +68,10 @@ Delete Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `id: string` @@ -85,7 +89,7 @@ Delete Skill Version ### Example ```http -curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION?beta=true \ +curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \ -X DELETE \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ diff --git a/content/en/api/beta/skills/versions/list.md b/content/en/api/beta/skills/versions/list.md index 4c7968f71..bb30a46ab 100644 --- a/content/en/api/beta/skills/versions/list.md +++ b/content/en/api/beta/skills/versions/list.md @@ -32,7 +32,7 @@ List Skill Versions - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -74,6 +74,10 @@ List Skill Versions - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `data: array of object { id, created_at, description, 5 more }` @@ -135,7 +139,7 @@ List Skill Versions ### Example ```http -curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions?beta=true \ +curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" diff --git a/content/en/api/beta/skills/versions/retrieve.md b/content/en/api/beta/skills/versions/retrieve.md index 3c518b98f..8196ae049 100644 --- a/content/en/api/beta/skills/versions/retrieve.md +++ b/content/en/api/beta/skills/versions/retrieve.md @@ -26,7 +26,7 @@ Get Skill Version - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -68,6 +68,10 @@ Get Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `id: string` @@ -117,7 +121,7 @@ Get Skill Version ### Example ```http -curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION?beta=true \ +curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" diff --git a/content/en/api/beta/user_profiles.md b/content/en/api/beta/user_profiles.md new file mode 100644 index 000000000..0b9122d49 --- /dev/null +++ b/content/en/api/beta/user_profiles.md @@ -0,0 +1,551 @@ +# User Profiles + +## Create + +**post** `/v1/user_profiles` + +Create User Profile + +### Header Parameters + +- `"anthropic-beta": optional array of AnthropicBeta` + + Optional header to specify the beta version(s) you want to use. + + - `UnionMember0 = string` + + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Body Parameters + +- `external_id: optional string` + +- `metadata: optional map[string]` + + Free-form key-value data to attach to this user profile. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. Values must be non-empty strings. + +### Returns + +- `BetaUserProfile = object { id, created_at, metadata, 4 more }` + + - `id: string` + + - `created_at: string` + + A timestamp in RFC 3339 format + + - `metadata: map[string]` + + - `trust_grants: map[BetaUserProfileTrustGrant]` + + - `status: string` + + - `type: string` + + - `updated_at: string` + + A timestamp in RFC 3339 format + + - `external_id: optional string` + +### Example + +```http +curl https://api.anthropic.com/v1/user_profiles \ + -H 'Content-Type: application/json' \ + -H 'anthropic-version: 2023-06-01' \ + -H 'anthropic-beta: user-profiles-2026-03-24' \ + -H "X-Api-Key: $ANTHROPIC_API_KEY" \ + -d '{}' +``` + +## List + +**get** `/v1/user_profiles` + +List User Profiles + +### Query Parameters + +- `limit: optional number` + + Query parameter for limit + +- `order: optional "asc" or "desc"` + + Query parameter for order + + - `"asc"` + + - `"desc"` + +- `page: optional string` + + Query parameter for page + +### Header Parameters + +- `"anthropic-beta": optional array of AnthropicBeta` + + Optional header to specify the beta version(s) you want to use. + + - `UnionMember0 = string` + + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `data: array of BetaUserProfile` + + - `id: string` + + - `created_at: string` + + A timestamp in RFC 3339 format + + - `metadata: map[string]` + + - `trust_grants: map[BetaUserProfileTrustGrant]` + + - `status: string` + + - `type: string` + + - `updated_at: string` + + A timestamp in RFC 3339 format + + - `external_id: optional string` + +- `next_page: optional string` + +### Example + +```http +curl https://api.anthropic.com/v1/user_profiles \ + -H 'anthropic-version: 2023-06-01' \ + -H 'anthropic-beta: user-profiles-2026-03-24' \ + -H "X-Api-Key: $ANTHROPIC_API_KEY" +``` + +## Retrieve + +**get** `/v1/user_profiles/{id}` + +Get User Profile + +### Path Parameters + +- `id: string` + +### Header Parameters + +- `"anthropic-beta": optional array of AnthropicBeta` + + Optional header to specify the beta version(s) you want to use. + + - `UnionMember0 = string` + + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `BetaUserProfile = object { id, created_at, metadata, 4 more }` + + - `id: string` + + - `created_at: string` + + A timestamp in RFC 3339 format + + - `metadata: map[string]` + + - `trust_grants: map[BetaUserProfileTrustGrant]` + + - `status: string` + + - `type: string` + + - `updated_at: string` + + A timestamp in RFC 3339 format + + - `external_id: optional string` + +### Example + +```http +curl https://api.anthropic.com/v1/user_profiles/$ID \ + -H 'anthropic-version: 2023-06-01' \ + -H 'anthropic-beta: user-profiles-2026-03-24' \ + -H "X-Api-Key: $ANTHROPIC_API_KEY" +``` + +## Update + +**post** `/v1/user_profiles/{id}` + +Update User Profile + +### Path Parameters + +- `id: string` + +### Header Parameters + +- `"anthropic-beta": optional array of AnthropicBeta` + + Optional header to specify the beta version(s) you want to use. + + - `UnionMember0 = string` + + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Body Parameters + +- `external_id: optional string` + +- `metadata: optional map[string]` + + Key-value pairs to merge into the stored metadata. Keys provided overwrite existing values. To remove a key, set its value to an empty string. Keys not provided are left unchanged. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. + +### Returns + +- `BetaUserProfile = object { id, created_at, metadata, 4 more }` + + - `id: string` + + - `created_at: string` + + A timestamp in RFC 3339 format + + - `metadata: map[string]` + + - `trust_grants: map[BetaUserProfileTrustGrant]` + + - `status: string` + + - `type: string` + + - `updated_at: string` + + A timestamp in RFC 3339 format + + - `external_id: optional string` + +### Example + +```http +curl https://api.anthropic.com/v1/user_profiles/$ID \ + -H 'Content-Type: application/json' \ + -H 'anthropic-version: 2023-06-01' \ + -H 'anthropic-beta: user-profiles-2026-03-24' \ + -H "X-Api-Key: $ANTHROPIC_API_KEY" \ + -d '{}' +``` + +## Create Enrollment URL + +**post** `/v1/user_profiles/{id}/enrollment_url` + +Create Enrollment URL + +### Path Parameters + +- `id: string` + +### Header Parameters + +- `"anthropic-beta": optional array of AnthropicBeta` + + Optional header to specify the beta version(s) you want to use. + + - `UnionMember0 = string` + + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `BetaUserProfileEnrollmentURL = object { expires_at, type, url }` + + - `expires_at: string` + + A timestamp in RFC 3339 format + + - `type: string` + + - `url: string` + +### Example + +```http +curl https://api.anthropic.com/v1/user_profiles/$ID/enrollment_url \ + -X POST \ + -H 'anthropic-version: 2023-06-01' \ + -H 'anthropic-beta: user-profiles-2026-03-24' \ + -H "X-Api-Key: $ANTHROPIC_API_KEY" +``` + +## Domain Types + +### Beta User Profile + +- `BetaUserProfile = object { id, created_at, metadata, 4 more }` + + - `id: string` + + - `created_at: string` + + A timestamp in RFC 3339 format + + - `metadata: map[string]` + + - `trust_grants: map[BetaUserProfileTrustGrant]` + + - `status: string` + + - `type: string` + + - `updated_at: string` + + A timestamp in RFC 3339 format + + - `external_id: optional string` + +### Beta User Profile Enrollment URL + +- `BetaUserProfileEnrollmentURL = object { expires_at, type, url }` + + - `expires_at: string` + + A timestamp in RFC 3339 format + + - `type: string` + + - `url: string` + +### Beta User Profile Trust Grant + +- `BetaUserProfileTrustGrant = object { status }` + + - `status: string` diff --git a/content/en/api/beta/user_profiles/create.md b/content/en/api/beta/user_profiles/create.md new file mode 100644 index 000000000..4db181258 --- /dev/null +++ b/content/en/api/beta/user_profiles/create.md @@ -0,0 +1,102 @@ +## Create + +**post** `/v1/user_profiles` + +Create User Profile + +### Header Parameters + +- `"anthropic-beta": optional array of AnthropicBeta` + + Optional header to specify the beta version(s) you want to use. + + - `UnionMember0 = string` + + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Body Parameters + +- `external_id: optional string` + +- `metadata: optional map[string]` + + Free-form key-value data to attach to this user profile. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. Values must be non-empty strings. + +### Returns + +- `BetaUserProfile = object { id, created_at, metadata, 4 more }` + + - `id: string` + + - `created_at: string` + + A timestamp in RFC 3339 format + + - `metadata: map[string]` + + - `trust_grants: map[BetaUserProfileTrustGrant]` + + - `status: string` + + - `type: string` + + - `updated_at: string` + + A timestamp in RFC 3339 format + + - `external_id: optional string` + +### Example + +```http +curl https://api.anthropic.com/v1/user_profiles \ + -H 'Content-Type: application/json' \ + -H 'anthropic-version: 2023-06-01' \ + -H 'anthropic-beta: user-profiles-2026-03-24' \ + -H "X-Api-Key: $ANTHROPIC_API_KEY" \ + -d '{}' +``` diff --git a/content/en/api/beta/user_profiles/create_enrollment_url.md b/content/en/api/beta/user_profiles/create_enrollment_url.md new file mode 100644 index 000000000..c17216b10 --- /dev/null +++ b/content/en/api/beta/user_profiles/create_enrollment_url.md @@ -0,0 +1,85 @@ +## Create Enrollment URL + +**post** `/v1/user_profiles/{id}/enrollment_url` + +Create Enrollment URL + +### Path Parameters + +- `id: string` + +### Header Parameters + +- `"anthropic-beta": optional array of AnthropicBeta` + + Optional header to specify the beta version(s) you want to use. + + - `UnionMember0 = string` + + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `BetaUserProfileEnrollmentURL = object { expires_at, type, url }` + + - `expires_at: string` + + A timestamp in RFC 3339 format + + - `type: string` + + - `url: string` + +### Example + +```http +curl https://api.anthropic.com/v1/user_profiles/$ID/enrollment_url \ + -X POST \ + -H 'anthropic-version: 2023-06-01' \ + -H 'anthropic-beta: user-profiles-2026-03-24' \ + -H "X-Api-Key: $ANTHROPIC_API_KEY" +``` diff --git a/content/en/api/beta/user_profiles/list.md b/content/en/api/beta/user_profiles/list.md new file mode 100644 index 000000000..7410d8eae --- /dev/null +++ b/content/en/api/beta/user_profiles/list.md @@ -0,0 +1,112 @@ +## List + +**get** `/v1/user_profiles` + +List User Profiles + +### Query Parameters + +- `limit: optional number` + + Query parameter for limit + +- `order: optional "asc" or "desc"` + + Query parameter for order + + - `"asc"` + + - `"desc"` + +- `page: optional string` + + Query parameter for page + +### Header Parameters + +- `"anthropic-beta": optional array of AnthropicBeta` + + Optional header to specify the beta version(s) you want to use. + + - `UnionMember0 = string` + + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `data: array of BetaUserProfile` + + - `id: string` + + - `created_at: string` + + A timestamp in RFC 3339 format + + - `metadata: map[string]` + + - `trust_grants: map[BetaUserProfileTrustGrant]` + + - `status: string` + + - `type: string` + + - `updated_at: string` + + A timestamp in RFC 3339 format + + - `external_id: optional string` + +- `next_page: optional string` + +### Example + +```http +curl https://api.anthropic.com/v1/user_profiles \ + -H 'anthropic-version: 2023-06-01' \ + -H 'anthropic-beta: user-profiles-2026-03-24' \ + -H "X-Api-Key: $ANTHROPIC_API_KEY" +``` diff --git a/content/en/api/beta/user_profiles/retrieve.md b/content/en/api/beta/user_profiles/retrieve.md new file mode 100644 index 000000000..bb02248ee --- /dev/null +++ b/content/en/api/beta/user_profiles/retrieve.md @@ -0,0 +1,96 @@ +## Retrieve + +**get** `/v1/user_profiles/{id}` + +Get User Profile + +### Path Parameters + +- `id: string` + +### Header Parameters + +- `"anthropic-beta": optional array of AnthropicBeta` + + Optional header to specify the beta version(s) you want to use. + + - `UnionMember0 = string` + + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `BetaUserProfile = object { id, created_at, metadata, 4 more }` + + - `id: string` + + - `created_at: string` + + A timestamp in RFC 3339 format + + - `metadata: map[string]` + + - `trust_grants: map[BetaUserProfileTrustGrant]` + + - `status: string` + + - `type: string` + + - `updated_at: string` + + A timestamp in RFC 3339 format + + - `external_id: optional string` + +### Example + +```http +curl https://api.anthropic.com/v1/user_profiles/$ID \ + -H 'anthropic-version: 2023-06-01' \ + -H 'anthropic-beta: user-profiles-2026-03-24' \ + -H "X-Api-Key: $ANTHROPIC_API_KEY" +``` diff --git a/content/en/api/beta/user_profiles/update.md b/content/en/api/beta/user_profiles/update.md new file mode 100644 index 000000000..acbe2e477 --- /dev/null +++ b/content/en/api/beta/user_profiles/update.md @@ -0,0 +1,106 @@ +## Update + +**post** `/v1/user_profiles/{id}` + +Update User Profile + +### Path Parameters + +- `id: string` + +### Header Parameters + +- `"anthropic-beta": optional array of AnthropicBeta` + + Optional header to specify the beta version(s) you want to use. + + - `UnionMember0 = string` + + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Body Parameters + +- `external_id: optional string` + +- `metadata: optional map[string]` + + Key-value pairs to merge into the stored metadata. Keys provided overwrite existing values. To remove a key, set its value to an empty string. Keys not provided are left unchanged. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. + +### Returns + +- `BetaUserProfile = object { id, created_at, metadata, 4 more }` + + - `id: string` + + - `created_at: string` + + A timestamp in RFC 3339 format + + - `metadata: map[string]` + + - `trust_grants: map[BetaUserProfileTrustGrant]` + + - `status: string` + + - `type: string` + + - `updated_at: string` + + A timestamp in RFC 3339 format + + - `external_id: optional string` + +### Example + +```http +curl https://api.anthropic.com/v1/user_profiles/$ID \ + -H 'Content-Type: application/json' \ + -H 'anthropic-version: 2023-06-01' \ + -H 'anthropic-beta: user-profiles-2026-03-24' \ + -H "X-Api-Key: $ANTHROPIC_API_KEY" \ + -d '{}' +``` diff --git a/content/en/api/cli/beta.md b/content/en/api/cli/beta.md index 80f3dece3..91ff456cc 100644 --- a/content/en/api/cli/beta.md +++ b/content/en/api/cli/beta.md @@ -1 +1 @@ -Not Found - Claude API Docs
    \ No newline at end of file +Not Found - Claude API Docs
      \ No newline at end of file diff --git a/content/en/api/cli/beta/files.md b/content/en/api/cli/beta/files.md index 330d80d12..c816c74e5 100644 --- a/content/en/api/cli/beta/files.md +++ b/content/en/api/cli/beta/files.md @@ -1 +1 @@ -Not Found - Claude API Docs
        \ No newline at end of file +Not Found - Claude API Docs
          \ No newline at end of file diff --git a/content/en/api/cli/beta/files/delete.md b/content/en/api/cli/beta/files/delete.md index eec9e0c86..5d7020f86 100644 --- a/content/en/api/cli/beta/files/delete.md +++ b/content/en/api/cli/beta/files/delete.md @@ -1 +1 @@ -Not Found - Claude API Docs
            \ No newline at end of file +Not Found - Claude API Docs
              \ No newline at end of file diff --git a/content/en/api/cli/beta/files/download.md b/content/en/api/cli/beta/files/download.md index 8fbcd27ea..f1012e8cb 100644 --- a/content/en/api/cli/beta/files/download.md +++ b/content/en/api/cli/beta/files/download.md @@ -1 +1 @@ -Not Found - Claude API Docs
                \ No newline at end of file +Not Found - Claude API Docs
                  \ No newline at end of file diff --git a/content/en/api/cli/beta/files/list.md b/content/en/api/cli/beta/files/list.md index 8632ab0ff..38038a879 100644 --- a/content/en/api/cli/beta/files/list.md +++ b/content/en/api/cli/beta/files/list.md @@ -1 +1 @@ -Not Found - Claude API Docs
                    \ No newline at end of file +Not Found - Claude API Docs
                      \ No newline at end of file diff --git a/content/en/api/cli/beta/files/retrieve_metadata.md b/content/en/api/cli/beta/files/retrieve_metadata.md index 16f44f496..0dd556855 100644 --- a/content/en/api/cli/beta/files/retrieve_metadata.md +++ b/content/en/api/cli/beta/files/retrieve_metadata.md @@ -1 +1 @@ -Not Found - Claude API Docs
                        \ No newline at end of file +Not Found - Claude API Docs
                          \ No newline at end of file diff --git a/content/en/api/cli/beta/files/upload.md b/content/en/api/cli/beta/files/upload.md index d89c1c42a..85784587f 100644 --- a/content/en/api/cli/beta/files/upload.md +++ b/content/en/api/cli/beta/files/upload.md @@ -1 +1 @@ -Not Found - Claude API Docs
                            \ No newline at end of file +Not Found - Claude API Docs
                              \ No newline at end of file diff --git a/content/en/api/cli/beta/messages.md b/content/en/api/cli/beta/messages.md index acd617acf..74089d159 100644 --- a/content/en/api/cli/beta/messages.md +++ b/content/en/api/cli/beta/messages.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                \ No newline at end of file +Not Found - Claude API Docs
                                  \ No newline at end of file diff --git a/content/en/api/cli/beta/messages/batches.md b/content/en/api/cli/beta/messages/batches.md index d865a8f78..21907b0d4 100644 --- a/content/en/api/cli/beta/messages/batches.md +++ b/content/en/api/cli/beta/messages/batches.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                    \ No newline at end of file +Not Found - Claude API Docs
                                      \ No newline at end of file diff --git a/content/en/api/cli/beta/messages/batches/cancel.md b/content/en/api/cli/beta/messages/batches/cancel.md index 7c745d85c..34f803607 100644 --- a/content/en/api/cli/beta/messages/batches/cancel.md +++ b/content/en/api/cli/beta/messages/batches/cancel.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                        \ No newline at end of file +Not Found - Claude API Docs
                                          \ No newline at end of file diff --git a/content/en/api/cli/beta/messages/batches/create.md b/content/en/api/cli/beta/messages/batches/create.md index 0132c4a0e..e7133e01b 100644 --- a/content/en/api/cli/beta/messages/batches/create.md +++ b/content/en/api/cli/beta/messages/batches/create.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                            \ No newline at end of file +Not Found - Claude API Docs
                                              \ No newline at end of file diff --git a/content/en/api/cli/beta/messages/batches/delete.md b/content/en/api/cli/beta/messages/batches/delete.md index 35932dd3e..09246687f 100644 --- a/content/en/api/cli/beta/messages/batches/delete.md +++ b/content/en/api/cli/beta/messages/batches/delete.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                \ No newline at end of file +Not Found - Claude API Docs
                                                  \ No newline at end of file diff --git a/content/en/api/cli/beta/messages/batches/list.md b/content/en/api/cli/beta/messages/batches/list.md index 8be90fcc6..e6c80d8df 100644 --- a/content/en/api/cli/beta/messages/batches/list.md +++ b/content/en/api/cli/beta/messages/batches/list.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                    \ No newline at end of file +Not Found - Claude API Docs
                                                      \ No newline at end of file diff --git a/content/en/api/cli/beta/messages/batches/results.md b/content/en/api/cli/beta/messages/batches/results.md index 00e17c8b6..41b01b9f6 100644 --- a/content/en/api/cli/beta/messages/batches/results.md +++ b/content/en/api/cli/beta/messages/batches/results.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                        \ No newline at end of file +Not Found - Claude API Docs
                                                          \ No newline at end of file diff --git a/content/en/api/cli/beta/messages/batches/retrieve.md b/content/en/api/cli/beta/messages/batches/retrieve.md index 453b5affb..99d190af7 100644 --- a/content/en/api/cli/beta/messages/batches/retrieve.md +++ b/content/en/api/cli/beta/messages/batches/retrieve.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                            \ No newline at end of file +Not Found - Claude API Docs
                                                              \ No newline at end of file diff --git a/content/en/api/cli/beta/messages/count_tokens.md b/content/en/api/cli/beta/messages/count_tokens.md index fcafaa1b5..c8646c0dc 100644 --- a/content/en/api/cli/beta/messages/count_tokens.md +++ b/content/en/api/cli/beta/messages/count_tokens.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                \ No newline at end of file +Not Found - Claude API Docs
                                                                  \ No newline at end of file diff --git a/content/en/api/cli/beta/messages/create.md b/content/en/api/cli/beta/messages/create.md index 6c36f1e6b..2ec4bced0 100644 --- a/content/en/api/cli/beta/messages/create.md +++ b/content/en/api/cli/beta/messages/create.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                    \ No newline at end of file +Not Found - Claude API Docs
                                                                      \ No newline at end of file diff --git a/content/en/api/cli/beta/models.md b/content/en/api/cli/beta/models.md index 4d7a8f82d..b49b133e5 100644 --- a/content/en/api/cli/beta/models.md +++ b/content/en/api/cli/beta/models.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                        \ No newline at end of file +Not Found - Claude API Docs
                                                                          \ No newline at end of file diff --git a/content/en/api/cli/beta/models/list.md b/content/en/api/cli/beta/models/list.md index d9a3b56c8..d4238aa95 100644 --- a/content/en/api/cli/beta/models/list.md +++ b/content/en/api/cli/beta/models/list.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                            \ No newline at end of file +Not Found - Claude API Docs
                                                                              \ No newline at end of file diff --git a/content/en/api/cli/beta/models/retrieve.md b/content/en/api/cli/beta/models/retrieve.md index d10d92546..73e3324ff 100644 --- a/content/en/api/cli/beta/models/retrieve.md +++ b/content/en/api/cli/beta/models/retrieve.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                \ No newline at end of file +Not Found - Claude API Docs
                                                                                  \ No newline at end of file diff --git a/content/en/api/cli/beta/skills.md b/content/en/api/cli/beta/skills.md index 8cfcb5bb8..491f467a9 100644 --- a/content/en/api/cli/beta/skills.md +++ b/content/en/api/cli/beta/skills.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                    \ No newline at end of file +Not Found - Claude API Docs
                                                                                      \ No newline at end of file diff --git a/content/en/api/cli/beta/skills/create.md b/content/en/api/cli/beta/skills/create.md index 5fed9d826..8f399abd2 100644 --- a/content/en/api/cli/beta/skills/create.md +++ b/content/en/api/cli/beta/skills/create.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                        \ No newline at end of file +Not Found - Claude API Docs
                                                                                          \ No newline at end of file diff --git a/content/en/api/cli/beta/skills/delete.md b/content/en/api/cli/beta/skills/delete.md index 6136fb0a7..9327077a9 100644 --- a/content/en/api/cli/beta/skills/delete.md +++ b/content/en/api/cli/beta/skills/delete.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                            \ No newline at end of file +Not Found - Claude API Docs
                                                                                              \ No newline at end of file diff --git a/content/en/api/cli/beta/skills/list.md b/content/en/api/cli/beta/skills/list.md index 8624cb401..88c4e9be4 100644 --- a/content/en/api/cli/beta/skills/list.md +++ b/content/en/api/cli/beta/skills/list.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                \ No newline at end of file +Not Found - Claude API Docs
                                                                                                  \ No newline at end of file diff --git a/content/en/api/cli/beta/skills/retrieve.md b/content/en/api/cli/beta/skills/retrieve.md index 7dae6f08a..c74c3e785 100644 --- a/content/en/api/cli/beta/skills/retrieve.md +++ b/content/en/api/cli/beta/skills/retrieve.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                    \ No newline at end of file +Not Found - Claude API Docs
                                                                                                      \ No newline at end of file diff --git a/content/en/api/cli/beta/skills/versions.md b/content/en/api/cli/beta/skills/versions.md index bfc0a53f2..816fde711 100644 --- a/content/en/api/cli/beta/skills/versions.md +++ b/content/en/api/cli/beta/skills/versions.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                        \ No newline at end of file +Not Found - Claude API Docs
                                                                                                          \ No newline at end of file diff --git a/content/en/api/cli/beta/skills/versions/create.md b/content/en/api/cli/beta/skills/versions/create.md index 629e8993d..6c7c84078 100644 --- a/content/en/api/cli/beta/skills/versions/create.md +++ b/content/en/api/cli/beta/skills/versions/create.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                            \ No newline at end of file +Not Found - Claude API Docs
                                                                                                              \ No newline at end of file diff --git a/content/en/api/cli/beta/skills/versions/delete.md b/content/en/api/cli/beta/skills/versions/delete.md index d1dd7ef0c..1026c1b06 100644 --- a/content/en/api/cli/beta/skills/versions/delete.md +++ b/content/en/api/cli/beta/skills/versions/delete.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                  \ No newline at end of file diff --git a/content/en/api/cli/beta/skills/versions/list.md b/content/en/api/cli/beta/skills/versions/list.md index 746ab4024..1ddd29677 100644 --- a/content/en/api/cli/beta/skills/versions/list.md +++ b/content/en/api/cli/beta/skills/versions/list.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                    \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                      \ No newline at end of file diff --git a/content/en/api/cli/beta/skills/versions/retrieve.md b/content/en/api/cli/beta/skills/versions/retrieve.md index 815a80ac5..17cfea617 100644 --- a/content/en/api/cli/beta/skills/versions/retrieve.md +++ b/content/en/api/cli/beta/skills/versions/retrieve.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                        \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                          \ No newline at end of file diff --git a/content/en/api/cli/beta/user_profiles.md b/content/en/api/cli/beta/user_profiles.md new file mode 100644 index 000000000..90d991804 --- /dev/null +++ b/content/en/api/cli/beta/user_profiles.md @@ -0,0 +1 @@ +Not Found - Claude API Docs
                                                                                                                            \ No newline at end of file diff --git a/content/en/api/cli/beta/user_profiles/create.md b/content/en/api/cli/beta/user_profiles/create.md new file mode 100644 index 000000000..dbe6f8b0e --- /dev/null +++ b/content/en/api/cli/beta/user_profiles/create.md @@ -0,0 +1 @@ +Not Found - Claude API Docs
                                                                                                                              \ No newline at end of file diff --git a/content/en/api/cli/beta/user_profiles/create_enrollment_url.md b/content/en/api/cli/beta/user_profiles/create_enrollment_url.md new file mode 100644 index 000000000..104912e32 --- /dev/null +++ b/content/en/api/cli/beta/user_profiles/create_enrollment_url.md @@ -0,0 +1 @@ +Not Found - Claude API Docs
                                                                                                                                \ No newline at end of file diff --git a/content/en/api/cli/beta/user_profiles/list.md b/content/en/api/cli/beta/user_profiles/list.md new file mode 100644 index 000000000..c56965c1a --- /dev/null +++ b/content/en/api/cli/beta/user_profiles/list.md @@ -0,0 +1 @@ +Not Found - Claude API Docs
                                                                                                                                  \ No newline at end of file diff --git a/content/en/api/cli/beta/user_profiles/retrieve.md b/content/en/api/cli/beta/user_profiles/retrieve.md new file mode 100644 index 000000000..7e76f0f6a --- /dev/null +++ b/content/en/api/cli/beta/user_profiles/retrieve.md @@ -0,0 +1 @@ +Not Found - Claude API Docs
                                                                                                                                    \ No newline at end of file diff --git a/content/en/api/cli/beta/user_profiles/update.md b/content/en/api/cli/beta/user_profiles/update.md new file mode 100644 index 000000000..a44832f40 --- /dev/null +++ b/content/en/api/cli/beta/user_profiles/update.md @@ -0,0 +1 @@ +Not Found - Claude API Docs
                                                                                                                                      \ No newline at end of file diff --git a/content/en/api/cli/completions.md b/content/en/api/cli/completions.md index 96420b52a..98235cd3c 100644 --- a/content/en/api/cli/completions.md +++ b/content/en/api/cli/completions.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                        \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                          \ No newline at end of file diff --git a/content/en/api/cli/completions/create.md b/content/en/api/cli/completions/create.md index 9c3473ee8..eb0377b2c 100644 --- a/content/en/api/cli/completions/create.md +++ b/content/en/api/cli/completions/create.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                            \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                              \ No newline at end of file diff --git a/content/en/api/cli/messages.md b/content/en/api/cli/messages.md index edee485f4..ee46967ae 100644 --- a/content/en/api/cli/messages.md +++ b/content/en/api/cli/messages.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                  \ No newline at end of file diff --git a/content/en/api/cli/messages/batches.md b/content/en/api/cli/messages/batches.md index f350ef153..5d627650b 100644 --- a/content/en/api/cli/messages/batches.md +++ b/content/en/api/cli/messages/batches.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                    \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                      \ No newline at end of file diff --git a/content/en/api/cli/messages/batches/cancel.md b/content/en/api/cli/messages/batches/cancel.md index 55c04d9d0..81a0014ec 100644 --- a/content/en/api/cli/messages/batches/cancel.md +++ b/content/en/api/cli/messages/batches/cancel.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                        \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                          \ No newline at end of file diff --git a/content/en/api/cli/messages/batches/create.md b/content/en/api/cli/messages/batches/create.md index 079308c61..9425d5356 100644 --- a/content/en/api/cli/messages/batches/create.md +++ b/content/en/api/cli/messages/batches/create.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                            \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                              \ No newline at end of file diff --git a/content/en/api/cli/messages/batches/delete.md b/content/en/api/cli/messages/batches/delete.md index 7e8023f07..92909acc6 100644 --- a/content/en/api/cli/messages/batches/delete.md +++ b/content/en/api/cli/messages/batches/delete.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                  \ No newline at end of file diff --git a/content/en/api/cli/messages/batches/list.md b/content/en/api/cli/messages/batches/list.md index b856bcd9e..f52ea9152 100644 --- a/content/en/api/cli/messages/batches/list.md +++ b/content/en/api/cli/messages/batches/list.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                    \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                      \ No newline at end of file diff --git a/content/en/api/cli/messages/batches/results.md b/content/en/api/cli/messages/batches/results.md index 8756f915d..d45d10752 100644 --- a/content/en/api/cli/messages/batches/results.md +++ b/content/en/api/cli/messages/batches/results.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                        \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                          \ No newline at end of file diff --git a/content/en/api/cli/messages/batches/retrieve.md b/content/en/api/cli/messages/batches/retrieve.md index 1639ff94e..6fce047c0 100644 --- a/content/en/api/cli/messages/batches/retrieve.md +++ b/content/en/api/cli/messages/batches/retrieve.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                            \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                              \ No newline at end of file diff --git a/content/en/api/cli/messages/count_tokens.md b/content/en/api/cli/messages/count_tokens.md index 70ad01fc6..ba5e1ff0c 100644 --- a/content/en/api/cli/messages/count_tokens.md +++ b/content/en/api/cli/messages/count_tokens.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                  \ No newline at end of file diff --git a/content/en/api/cli/messages/create.md b/content/en/api/cli/messages/create.md index ae1586106..0bbbc48e2 100644 --- a/content/en/api/cli/messages/create.md +++ b/content/en/api/cli/messages/create.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                    \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                      \ No newline at end of file diff --git a/content/en/api/cli/models.md b/content/en/api/cli/models.md index 369401bde..236260cd6 100644 --- a/content/en/api/cli/models.md +++ b/content/en/api/cli/models.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                        \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                          \ No newline at end of file diff --git a/content/en/api/cli/models/list.md b/content/en/api/cli/models/list.md index 393bae291..d906e3717 100644 --- a/content/en/api/cli/models/list.md +++ b/content/en/api/cli/models/list.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                            \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                              \ No newline at end of file diff --git a/content/en/api/cli/models/retrieve.md b/content/en/api/cli/models/retrieve.md index 82e0f7b4d..4628c12f4 100644 --- a/content/en/api/cli/models/retrieve.md +++ b/content/en/api/cli/models/retrieve.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                  \ No newline at end of file diff --git a/content/en/api/client-sdks.md b/content/en/api/client-sdks.md index 8ef50446d..feb822927 100644 --- a/content/en/api/client-sdks.md +++ b/content/en/api/client-sdks.md @@ -212,7 +212,7 @@ All SDKs support multiple deployment options: | Platform | Description | |----------|-------------| | Claude API | Connect directly to Claude API endpoints | -| [Amazon Bedrock](/docs/en/build-with-claude/claude-on-amazon-bedrock) | Use Claude through AWS | +| [Amazon Bedrock](/docs/en/build-with-claude/claude-in-amazon-bedrock) | Use Claude through AWS | | [Google Vertex AI](/docs/en/build-with-claude/claude-on-vertex-ai) | Use Claude through Google Cloud | | [Microsoft Foundry](/docs/en/build-with-claude/claude-in-microsoft-foundry) | Use Claude through Microsoft Azure | diff --git a/content/en/api/completions.md b/content/en/api/completions.md index 2812473ba..25d48f90b 100644 --- a/content/en/api/completions.md +++ b/content/en/api/completions.md @@ -18,7 +18,7 @@ Future models and features will not be compatible with Text Completions. See our - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -60,6 +60,10 @@ Future models and features will not be compatible with Text Completions. See our - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Body Parameters - `max_tokens_to_sample: number` diff --git a/content/en/api/completions/create.md b/content/en/api/completions/create.md index 9eed271cd..deee11be4 100644 --- a/content/en/api/completions/create.md +++ b/content/en/api/completions/create.md @@ -16,7 +16,7 @@ Future models and features will not be compatible with Text Completions. See our - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -58,6 +58,10 @@ Future models and features will not be compatible with Text Completions. See our - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Body Parameters - `max_tokens_to_sample: number` diff --git a/content/en/api/csharp/beta.md b/content/en/api/csharp/beta.md index 9966217e1..8836ef4da 100644 --- a/content/en/api/csharp/beta.md +++ b/content/en/api/csharp/beta.md @@ -270,6 +270,10 @@ The Models API response can be used to determine which models are available for - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class ModelListPageResponse:` @@ -540,6 +544,10 @@ The Models API response can be used to determine information about a specific mo - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class BetaModelInfo:` @@ -5053,6 +5061,10 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en Recommended for advanced use cases only. You usually only need to use `temperature`. + - `string? userProfileID` + + Body param: The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + - `IReadOnlyList betas` Header param: Optional header to specify the beta version(s) you want to use. @@ -5097,6 +5109,10 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class BetaMessage:` @@ -5958,6 +5974,28 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en This will always be `"assistant"`. + - `required BetaRefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required BetaStopReason? StopReason` The reason that we stopped. @@ -9974,6 +10012,10 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class BetaMessageTokensCount:` @@ -16204,6 +16246,28 @@ Console.WriteLine(betaMessageTokensCount); This will always be `"assistant"`. + - `required BetaRefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required BetaStopReason? StopReason` The reason that we stopped. @@ -19805,6 +19869,28 @@ Console.WriteLine(betaMessageTokensCount); Skill version or 'latest' for most recent version + - `required BetaRefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required BetaStopReason? StopReason` - `"end_turn"EndTurn` @@ -20812,6 +20898,28 @@ Console.WriteLine(betaMessageTokensCount); This will always be `"assistant"`. + - `required BetaRefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required BetaStopReason? StopReason` The reason that we stopped. @@ -21884,6 +21992,28 @@ Console.WriteLine(betaMessageTokensCount); This will always be `"assistant"`. + - `required BetaRefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required BetaStopReason? StopReason` The reason that we stopped. @@ -22157,6 +22287,28 @@ Console.WriteLine(betaMessageTokensCount); Skill version or 'latest' for most recent version + - `required BetaRefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required BetaStopReason? StopReason` - `"end_turn"EndTurn` @@ -23137,6 +23289,30 @@ Console.WriteLine(betaMessageTokensCount); - `JsonElement Type "redacted_thinking"constant` +### Beta Refusal Stop Details + +- `class BetaRefusalStopDetails:` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + ### Beta Request Document Block - `class BetaRequestDocumentBlock:` @@ -33437,6 +33613,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Recommended for advanced use cases only. You usually only need to use `temperature`. + - `string? UserProfileID` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + - `IReadOnlyList betas` Header param: Optional header to specify the beta version(s) you want to use. @@ -33481,6 +33661,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class BetaMessageBatch:` @@ -33737,6 +33921,7 @@ BatchCreateParams parameters = new() ], TopK = 5, TopP = 0.7, + UserProfileID = "user_profile_id", }, }, ], @@ -33809,6 +33994,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class BetaMessageBatch:` @@ -33979,6 +34168,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class BatchListPageResponse:` @@ -34157,6 +34350,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class BetaMessageBatch:` @@ -34319,6 +34516,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class BetaDeletedMessageBatch:` @@ -34407,6 +34608,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class BetaMessageBatchIndividualResponse:` @@ -35286,6 +35491,28 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude This will always be `"assistant"`. + - `required BetaRefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required BetaStopReason? StopReason` The reason that we stopped. @@ -36635,6 +36862,28 @@ await foreach (var betaMessageBatchIndividualResponse in client.Beta.Messages.Ba This will always be `"assistant"`. + - `required BetaRefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required BetaStopReason? StopReason` The reason that we stopped. @@ -37811,6 +38060,28 @@ await foreach (var betaMessageBatchIndividualResponse in client.Beta.Messages.Ba This will always be `"assistant"`. + - `required BetaRefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required BetaStopReason? StopReason` The reason that we stopped. @@ -38949,6 +39220,28 @@ await foreach (var betaMessageBatchIndividualResponse in client.Beta.Messages.Ba This will always be `"assistant"`. + - `required BetaRefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required BetaStopReason? StopReason` The reason that we stopped. @@ -39212,6 +39505,10 @@ Upload File - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class FileMetadata:` @@ -39331,6 +39628,10 @@ List Files - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class FileListPageResponse:` @@ -39455,6 +39756,10 @@ Download File - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Example ```csharp @@ -39525,158 +39830,166 @@ Get File Metadata - `"fast-mode-2026-02-01"FastMode2026_02_01` -### Returns - -- `class FileMetadata:` - - - `required string ID` - - Unique object identifier. - - The format and length of IDs may change over time. - - - `required DateTimeOffset CreatedAt` - - RFC 3339 datetime string representing when the file was created. - - - `required string Filename` - - Original filename of the uploaded file. - - - `required string MimeType` - - MIME type of the file. - - - `required Long SizeBytes` - - Size of the file in bytes. - - - `JsonElement Type "file"constant` - - Object type. - - For files, this is always `"file"`. - - - `Boolean Downloadable` - - Whether the file can be downloaded. - -### Example - -```csharp -FileRetrieveMetadataParams parameters = new() { FileID = "file_id" }; - -var fileMetadata = await client.Beta.Files.RetrieveMetadata(parameters); - -Console.WriteLine(fileMetadata); -``` - -## Delete - -`DeletedFile Beta.Files.Delete(FileDeleteParamsparameters, CancellationTokencancellationToken = default)` - -**delete** `/v1/files/{file_id}` - -Delete File - -### Parameters - -- `FileDeleteParams parameters` - - - `required string fileID` - - ID of the File. - - - `IReadOnlyList betas` - - Optional header to specify the beta version(s) you want to use. - - - `"message-batches-2024-09-24"MessageBatches2024_09_24` - - - `"prompt-caching-2024-07-31"PromptCaching2024_07_31` - - - `"computer-use-2024-10-22"ComputerUse2024_10_22` - - - `"computer-use-2025-01-24"ComputerUse2025_01_24` - - - `"pdfs-2024-09-25"Pdfs2024_09_25` - - - `"token-counting-2024-11-01"TokenCounting2024_11_01` - - - `"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19` - - - `"output-128k-2025-02-19"Output128k2025_02_19` - - - `"files-api-2025-04-14"FilesApi2025_04_14` - - - `"mcp-client-2025-04-04"McpClient2025_04_04` - - - `"mcp-client-2025-11-20"McpClient2025_11_20` - - - `"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14` - - - `"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14` - - - `"code-execution-2025-05-22"CodeExecution2025_05_22` - - - `"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11` - - - `"context-1m-2025-08-07"Context1m2025_08_07` + - `"output-300k-2026-03-24"Output300k2026_03_24` - - `"context-management-2025-06-27"ContextManagement2025_06_27` - - - `"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26` - - - `"skills-2025-10-02"Skills2025_10_02` - - - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` ### Returns -- `class DeletedFile:` - - - `required string ID` - - ID of the deleted file. - - - `Type Type` - - Deleted object type. - - For file deletion, this is always `"file_deleted"`. - - - `"file_deleted"FileDeleted` - -### Example - -```csharp -FileDeleteParams parameters = new() { FileID = "file_id" }; - -var deletedFile = await client.Beta.Files.Delete(parameters); - -Console.WriteLine(deletedFile); -``` - -## Domain Types - -### Deleted File - -- `class DeletedFile:` - - - `required string ID` - - ID of the deleted file. - - - `Type Type` - - Deleted object type. - - For file deletion, this is always `"file_deleted"`. - - - `"file_deleted"FileDeleted` - -### File Metadata - +- `class FileMetadata:` + + - `required string ID` + + Unique object identifier. + + The format and length of IDs may change over time. + + - `required DateTimeOffset CreatedAt` + + RFC 3339 datetime string representing when the file was created. + + - `required string Filename` + + Original filename of the uploaded file. + + - `required string MimeType` + + MIME type of the file. + + - `required Long SizeBytes` + + Size of the file in bytes. + + - `JsonElement Type "file"constant` + + Object type. + + For files, this is always `"file"`. + + - `Boolean Downloadable` + + Whether the file can be downloaded. + +### Example + +```csharp +FileRetrieveMetadataParams parameters = new() { FileID = "file_id" }; + +var fileMetadata = await client.Beta.Files.RetrieveMetadata(parameters); + +Console.WriteLine(fileMetadata); +``` + +## Delete + +`DeletedFile Beta.Files.Delete(FileDeleteParamsparameters, CancellationTokencancellationToken = default)` + +**delete** `/v1/files/{file_id}` + +Delete File + +### Parameters + +- `FileDeleteParams parameters` + + - `required string fileID` + + ID of the File. + + - `IReadOnlyList betas` + + Optional header to specify the beta version(s) you want to use. + + - `"message-batches-2024-09-24"MessageBatches2024_09_24` + + - `"prompt-caching-2024-07-31"PromptCaching2024_07_31` + + - `"computer-use-2024-10-22"ComputerUse2024_10_22` + + - `"computer-use-2025-01-24"ComputerUse2025_01_24` + + - `"pdfs-2024-09-25"Pdfs2024_09_25` + + - `"token-counting-2024-11-01"TokenCounting2024_11_01` + + - `"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19` + + - `"output-128k-2025-02-19"Output128k2025_02_19` + + - `"files-api-2025-04-14"FilesApi2025_04_14` + + - `"mcp-client-2025-04-04"McpClient2025_04_04` + + - `"mcp-client-2025-11-20"McpClient2025_11_20` + + - `"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14` + + - `"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14` + + - `"code-execution-2025-05-22"CodeExecution2025_05_22` + + - `"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11` + + - `"context-1m-2025-08-07"Context1m2025_08_07` + + - `"context-management-2025-06-27"ContextManagement2025_06_27` + + - `"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26` + + - `"skills-2025-10-02"Skills2025_10_02` + + - `"fast-mode-2026-02-01"FastMode2026_02_01` + + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + +### Returns + +- `class DeletedFile:` + + - `required string ID` + + ID of the deleted file. + + - `Type Type` + + Deleted object type. + + For file deletion, this is always `"file_deleted"`. + + - `"file_deleted"FileDeleted` + +### Example + +```csharp +FileDeleteParams parameters = new() { FileID = "file_id" }; + +var deletedFile = await client.Beta.Files.Delete(parameters); + +Console.WriteLine(deletedFile); +``` + +## Domain Types + +### Deleted File + +- `class DeletedFile:` + + - `required string ID` + + ID of the deleted file. + + - `Type Type` + + Deleted object type. + + For file deletion, this is always `"file_deleted"`. + + - `"file_deleted"FileDeleted` + +### File Metadata + - `class FileMetadata:` - `required string ID` @@ -39781,6 +40094,10 @@ Create Skill - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class SkillCreateResponse:` @@ -39913,6 +40230,10 @@ List Skills - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class SkillListPageResponse:` @@ -40048,6 +40369,10 @@ Get Skill - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class SkillRetrieveResponse:` @@ -40165,6 +40490,10 @@ Delete Skill - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class SkillDeleteResponse:` @@ -40261,6 +40590,10 @@ Create Skill Version - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class VersionCreateResponse:` @@ -40391,6 +40724,10 @@ List Skill Versions - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class VersionListPageResponse:` @@ -40531,6 +40868,10 @@ Get Skill Version - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class VersionRetrieveResponse:` @@ -40661,6 +41002,10 @@ Delete Skill Version - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class VersionDeleteResponse:` @@ -40690,3 +41035,557 @@ var version = await client.Beta.Skills.Versions.Delete(parameters); Console.WriteLine(version); ``` + +# User Profiles + +## Create + +`BetaUserProfile Beta.UserProfiles.Create(UserProfileCreateParams?parameters, CancellationTokencancellationToken = default)` + +**post** `/v1/user_profiles` + +Create User Profile + +### Parameters + +- `UserProfileCreateParams parameters` + + - `string? externalID` + + Body param + + - `IReadOnlyDictionary metadata` + + Body param: Free-form key-value data to attach to this user profile. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. Values must be non-empty strings. + + - `IReadOnlyList betas` + + Header param: Optional header to specify the beta version(s) you want to use. + + - `"message-batches-2024-09-24"MessageBatches2024_09_24` + + - `"prompt-caching-2024-07-31"PromptCaching2024_07_31` + + - `"computer-use-2024-10-22"ComputerUse2024_10_22` + + - `"computer-use-2025-01-24"ComputerUse2025_01_24` + + - `"pdfs-2024-09-25"Pdfs2024_09_25` + + - `"token-counting-2024-11-01"TokenCounting2024_11_01` + + - `"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19` + + - `"output-128k-2025-02-19"Output128k2025_02_19` + + - `"files-api-2025-04-14"FilesApi2025_04_14` + + - `"mcp-client-2025-04-04"McpClient2025_04_04` + + - `"mcp-client-2025-11-20"McpClient2025_11_20` + + - `"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14` + + - `"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14` + + - `"code-execution-2025-05-22"CodeExecution2025_05_22` + + - `"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11` + + - `"context-1m-2025-08-07"Context1m2025_08_07` + + - `"context-management-2025-06-27"ContextManagement2025_06_27` + + - `"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26` + + - `"skills-2025-10-02"Skills2025_10_02` + + - `"fast-mode-2026-02-01"FastMode2026_02_01` + + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + +### Returns + +- `class BetaUserProfile:` + + - `required string ID` + + - `required DateTimeOffset CreatedAt` + + A timestamp in RFC 3339 format + + - `required IReadOnlyDictionary Metadata` + + - `required IReadOnlyDictionary TrustGrants` + + - `required string Status` + + - `required string Type` + + - `required DateTimeOffset UpdatedAt` + + A timestamp in RFC 3339 format + + - `string? ExternalID` + +### Example + +```csharp +UserProfileCreateParams parameters = new(); + +var betaUserProfile = await client.Beta.UserProfiles.Create(parameters); + +Console.WriteLine(betaUserProfile); +``` + +## List + +`UserProfileListPageResponse Beta.UserProfiles.List(UserProfileListParams?parameters, CancellationTokencancellationToken = default)` + +**get** `/v1/user_profiles` + +List User Profiles + +### Parameters + +- `UserProfileListParams parameters` + + - `Int limit` + + Query param: Query parameter for limit + + - `Order order` + + Query param: Query parameter for order + + - `"asc"Asc` + + - `"desc"Desc` + + - `string page` + + Query param: Query parameter for page + + - `IReadOnlyList betas` + + Header param: Optional header to specify the beta version(s) you want to use. + + - `"message-batches-2024-09-24"MessageBatches2024_09_24` + + - `"prompt-caching-2024-07-31"PromptCaching2024_07_31` + + - `"computer-use-2024-10-22"ComputerUse2024_10_22` + + - `"computer-use-2025-01-24"ComputerUse2025_01_24` + + - `"pdfs-2024-09-25"Pdfs2024_09_25` + + - `"token-counting-2024-11-01"TokenCounting2024_11_01` + + - `"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19` + + - `"output-128k-2025-02-19"Output128k2025_02_19` + + - `"files-api-2025-04-14"FilesApi2025_04_14` + + - `"mcp-client-2025-04-04"McpClient2025_04_04` + + - `"mcp-client-2025-11-20"McpClient2025_11_20` + + - `"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14` + + - `"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14` + + - `"code-execution-2025-05-22"CodeExecution2025_05_22` + + - `"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11` + + - `"context-1m-2025-08-07"Context1m2025_08_07` + + - `"context-management-2025-06-27"ContextManagement2025_06_27` + + - `"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26` + + - `"skills-2025-10-02"Skills2025_10_02` + + - `"fast-mode-2026-02-01"FastMode2026_02_01` + + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + +### Returns + +- `class UserProfileListPageResponse:` + + - `required IReadOnlyList Data` + + - `required string ID` + + - `required DateTimeOffset CreatedAt` + + A timestamp in RFC 3339 format + + - `required IReadOnlyDictionary Metadata` + + - `required IReadOnlyDictionary TrustGrants` + + - `required string Status` + + - `required string Type` + + - `required DateTimeOffset UpdatedAt` + + A timestamp in RFC 3339 format + + - `string? ExternalID` + + - `string? NextPage` + +### Example + +```csharp +UserProfileListParams parameters = new(); + +var page = await client.Beta.UserProfiles.List(parameters); +await foreach (var item in page.Paginate()) +{ + Console.WriteLine(item); +} +``` + +## Retrieve + +`BetaUserProfile Beta.UserProfiles.Retrieve(UserProfileRetrieveParamsparameters, CancellationTokencancellationToken = default)` + +**get** `/v1/user_profiles/{id}` + +Get User Profile + +### Parameters + +- `UserProfileRetrieveParams parameters` + + - `required string id` + + Path parameter id + + - `IReadOnlyList betas` + + Optional header to specify the beta version(s) you want to use. + + - `"message-batches-2024-09-24"MessageBatches2024_09_24` + + - `"prompt-caching-2024-07-31"PromptCaching2024_07_31` + + - `"computer-use-2024-10-22"ComputerUse2024_10_22` + + - `"computer-use-2025-01-24"ComputerUse2025_01_24` + + - `"pdfs-2024-09-25"Pdfs2024_09_25` + + - `"token-counting-2024-11-01"TokenCounting2024_11_01` + + - `"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19` + + - `"output-128k-2025-02-19"Output128k2025_02_19` + + - `"files-api-2025-04-14"FilesApi2025_04_14` + + - `"mcp-client-2025-04-04"McpClient2025_04_04` + + - `"mcp-client-2025-11-20"McpClient2025_11_20` + + - `"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14` + + - `"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14` + + - `"code-execution-2025-05-22"CodeExecution2025_05_22` + + - `"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11` + + - `"context-1m-2025-08-07"Context1m2025_08_07` + + - `"context-management-2025-06-27"ContextManagement2025_06_27` + + - `"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26` + + - `"skills-2025-10-02"Skills2025_10_02` + + - `"fast-mode-2026-02-01"FastMode2026_02_01` + + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + +### Returns + +- `class BetaUserProfile:` + + - `required string ID` + + - `required DateTimeOffset CreatedAt` + + A timestamp in RFC 3339 format + + - `required IReadOnlyDictionary Metadata` + + - `required IReadOnlyDictionary TrustGrants` + + - `required string Status` + + - `required string Type` + + - `required DateTimeOffset UpdatedAt` + + A timestamp in RFC 3339 format + + - `string? ExternalID` + +### Example + +```csharp +UserProfileRetrieveParams parameters = new() { ID = "id" }; + +var betaUserProfile = await client.Beta.UserProfiles.Retrieve(parameters); + +Console.WriteLine(betaUserProfile); +``` + +## Update + +`BetaUserProfile Beta.UserProfiles.Update(UserProfileUpdateParamsparameters, CancellationTokencancellationToken = default)` + +**post** `/v1/user_profiles/{id}` + +Update User Profile + +### Parameters + +- `UserProfileUpdateParams parameters` + + - `required string id` + + Path param: Path parameter id + + - `string? externalID` + + Body param + + - `IReadOnlyDictionary metadata` + + Body param: Key-value pairs to merge into the stored metadata. Keys provided overwrite existing values. To remove a key, set its value to an empty string. Keys not provided are left unchanged. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. + + - `IReadOnlyList betas` + + Header param: Optional header to specify the beta version(s) you want to use. + + - `"message-batches-2024-09-24"MessageBatches2024_09_24` + + - `"prompt-caching-2024-07-31"PromptCaching2024_07_31` + + - `"computer-use-2024-10-22"ComputerUse2024_10_22` + + - `"computer-use-2025-01-24"ComputerUse2025_01_24` + + - `"pdfs-2024-09-25"Pdfs2024_09_25` + + - `"token-counting-2024-11-01"TokenCounting2024_11_01` + + - `"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19` + + - `"output-128k-2025-02-19"Output128k2025_02_19` + + - `"files-api-2025-04-14"FilesApi2025_04_14` + + - `"mcp-client-2025-04-04"McpClient2025_04_04` + + - `"mcp-client-2025-11-20"McpClient2025_11_20` + + - `"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14` + + - `"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14` + + - `"code-execution-2025-05-22"CodeExecution2025_05_22` + + - `"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11` + + - `"context-1m-2025-08-07"Context1m2025_08_07` + + - `"context-management-2025-06-27"ContextManagement2025_06_27` + + - `"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26` + + - `"skills-2025-10-02"Skills2025_10_02` + + - `"fast-mode-2026-02-01"FastMode2026_02_01` + + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + +### Returns + +- `class BetaUserProfile:` + + - `required string ID` + + - `required DateTimeOffset CreatedAt` + + A timestamp in RFC 3339 format + + - `required IReadOnlyDictionary Metadata` + + - `required IReadOnlyDictionary TrustGrants` + + - `required string Status` + + - `required string Type` + + - `required DateTimeOffset UpdatedAt` + + A timestamp in RFC 3339 format + + - `string? ExternalID` + +### Example + +```csharp +UserProfileUpdateParams parameters = new() { ID = "id" }; + +var betaUserProfile = await client.Beta.UserProfiles.Update(parameters); + +Console.WriteLine(betaUserProfile); +``` + +## Create Enrollment URL + +`BetaUserProfileEnrollmentUrl Beta.UserProfiles.CreateEnrollmentUrl(UserProfileCreateEnrollmentUrlParamsparameters, CancellationTokencancellationToken = default)` + +**post** `/v1/user_profiles/{id}/enrollment_url` + +Create Enrollment URL + +### Parameters + +- `UserProfileCreateEnrollmentUrlParams parameters` + + - `required string id` + + Path parameter id + + - `IReadOnlyList betas` + + Optional header to specify the beta version(s) you want to use. + + - `"message-batches-2024-09-24"MessageBatches2024_09_24` + + - `"prompt-caching-2024-07-31"PromptCaching2024_07_31` + + - `"computer-use-2024-10-22"ComputerUse2024_10_22` + + - `"computer-use-2025-01-24"ComputerUse2025_01_24` + + - `"pdfs-2024-09-25"Pdfs2024_09_25` + + - `"token-counting-2024-11-01"TokenCounting2024_11_01` + + - `"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19` + + - `"output-128k-2025-02-19"Output128k2025_02_19` + + - `"files-api-2025-04-14"FilesApi2025_04_14` + + - `"mcp-client-2025-04-04"McpClient2025_04_04` + + - `"mcp-client-2025-11-20"McpClient2025_11_20` + + - `"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14` + + - `"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14` + + - `"code-execution-2025-05-22"CodeExecution2025_05_22` + + - `"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11` + + - `"context-1m-2025-08-07"Context1m2025_08_07` + + - `"context-management-2025-06-27"ContextManagement2025_06_27` + + - `"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26` + + - `"skills-2025-10-02"Skills2025_10_02` + + - `"fast-mode-2026-02-01"FastMode2026_02_01` + + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + +### Returns + +- `class BetaUserProfileEnrollmentUrl:` + + - `required DateTimeOffset ExpiresAt` + + A timestamp in RFC 3339 format + + - `required string Type` + + - `required string Url` + +### Example + +```csharp +UserProfileCreateEnrollmentUrlParams parameters = new() { ID = "id" }; + +var betaUserProfileEnrollmentUrl = await client.Beta.UserProfiles.CreateEnrollmentUrl(parameters); + +Console.WriteLine(betaUserProfileEnrollmentUrl); +``` + +## Domain Types + +### Beta User Profile + +- `class BetaUserProfile:` + + - `required string ID` + + - `required DateTimeOffset CreatedAt` + + A timestamp in RFC 3339 format + + - `required IReadOnlyDictionary Metadata` + + - `required IReadOnlyDictionary TrustGrants` + + - `required string Status` + + - `required string Type` + + - `required DateTimeOffset UpdatedAt` + + A timestamp in RFC 3339 format + + - `string? ExternalID` + +### Beta User Profile Enrollment URL + +- `class BetaUserProfileEnrollmentUrl:` + + - `required DateTimeOffset ExpiresAt` + + A timestamp in RFC 3339 format + + - `required string Type` + + - `required string Url` + +### Beta User Profile Trust Grant + +- `class BetaUserProfileTrustGrant:` + + - `required string Status` diff --git a/content/en/api/csharp/beta/files.md b/content/en/api/csharp/beta/files.md index 37ae886c8..6d97185f1 100644 --- a/content/en/api/csharp/beta/files.md +++ b/content/en/api/csharp/beta/files.md @@ -60,6 +60,10 @@ Upload File - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class FileMetadata:` @@ -179,6 +183,10 @@ List Files - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class FileListPageResponse:` @@ -303,6 +311,10 @@ Download File - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Example ```csharp @@ -373,6 +385,10 @@ Get File Metadata - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class FileMetadata:` @@ -479,6 +495,10 @@ Delete File - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class DeletedFile:` diff --git a/content/en/api/csharp/beta/files/delete.md b/content/en/api/csharp/beta/files/delete.md index 03f417448..de5acdea8 100644 --- a/content/en/api/csharp/beta/files/delete.md +++ b/content/en/api/csharp/beta/files/delete.md @@ -58,6 +58,10 @@ Delete File - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class DeletedFile:` diff --git a/content/en/api/csharp/beta/files/download.md b/content/en/api/csharp/beta/files/download.md index 751db09a6..756aa1cc5 100644 --- a/content/en/api/csharp/beta/files/download.md +++ b/content/en/api/csharp/beta/files/download.md @@ -58,6 +58,10 @@ Download File - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Example ```csharp diff --git a/content/en/api/csharp/beta/files/list.md b/content/en/api/csharp/beta/files/list.md index 085d8b156..81859978f 100644 --- a/content/en/api/csharp/beta/files/list.md +++ b/content/en/api/csharp/beta/files/list.md @@ -68,6 +68,10 @@ List Files - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class FileListPageResponse:` diff --git a/content/en/api/csharp/beta/files/retrieve_metadata.md b/content/en/api/csharp/beta/files/retrieve_metadata.md index 387368741..8f47c3f16 100644 --- a/content/en/api/csharp/beta/files/retrieve_metadata.md +++ b/content/en/api/csharp/beta/files/retrieve_metadata.md @@ -58,6 +58,10 @@ Get File Metadata - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class FileMetadata:` diff --git a/content/en/api/csharp/beta/files/upload.md b/content/en/api/csharp/beta/files/upload.md index 53c0431a9..55c9c5f04 100644 --- a/content/en/api/csharp/beta/files/upload.md +++ b/content/en/api/csharp/beta/files/upload.md @@ -58,6 +58,10 @@ Upload File - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class FileMetadata:` diff --git a/content/en/api/csharp/beta/messages.md b/content/en/api/csharp/beta/messages.md index 2892067c6..e942144ca 100644 --- a/content/en/api/csharp/beta/messages.md +++ b/content/en/api/csharp/beta/messages.md @@ -3843,6 +3843,10 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en Recommended for advanced use cases only. You usually only need to use `temperature`. + - `string? userProfileID` + + Body param: The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + - `IReadOnlyList betas` Header param: Optional header to specify the beta version(s) you want to use. @@ -3887,6 +3891,10 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class BetaMessage:` @@ -4748,6 +4756,28 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en This will always be `"assistant"`. + - `required BetaRefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required BetaStopReason? StopReason` The reason that we stopped. @@ -8764,6 +8794,10 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class BetaMessageTokensCount:` @@ -14994,6 +15028,28 @@ Console.WriteLine(betaMessageTokensCount); This will always be `"assistant"`. + - `required BetaRefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required BetaStopReason? StopReason` The reason that we stopped. @@ -18595,6 +18651,28 @@ Console.WriteLine(betaMessageTokensCount); Skill version or 'latest' for most recent version + - `required BetaRefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required BetaStopReason? StopReason` - `"end_turn"EndTurn` @@ -19602,6 +19680,28 @@ Console.WriteLine(betaMessageTokensCount); This will always be `"assistant"`. + - `required BetaRefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required BetaStopReason? StopReason` The reason that we stopped. @@ -20674,6 +20774,28 @@ Console.WriteLine(betaMessageTokensCount); This will always be `"assistant"`. + - `required BetaRefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required BetaStopReason? StopReason` The reason that we stopped. @@ -20947,6 +21069,28 @@ Console.WriteLine(betaMessageTokensCount); Skill version or 'latest' for most recent version + - `required BetaRefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required BetaStopReason? StopReason` - `"end_turn"EndTurn` @@ -21927,6 +22071,30 @@ Console.WriteLine(betaMessageTokensCount); - `JsonElement Type "redacted_thinking"constant` +### Beta Refusal Stop Details + +- `class BetaRefusalStopDetails:` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + ### Beta Request Document Block - `class BetaRequestDocumentBlock:` @@ -32227,6 +32395,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Recommended for advanced use cases only. You usually only need to use `temperature`. + - `string? UserProfileID` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + - `IReadOnlyList betas` Header param: Optional header to specify the beta version(s) you want to use. @@ -32271,6 +32443,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class BetaMessageBatch:` @@ -32527,6 +32703,7 @@ BatchCreateParams parameters = new() ], TopK = 5, TopP = 0.7, + UserProfileID = "user_profile_id", }, }, ], @@ -32599,6 +32776,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class BetaMessageBatch:` @@ -32769,6 +32950,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class BatchListPageResponse:` @@ -32947,6 +33132,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class BetaMessageBatch:` @@ -33109,6 +33298,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class BetaDeletedMessageBatch:` @@ -33197,6 +33390,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class BetaMessageBatchIndividualResponse:` @@ -34076,6 +34273,28 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude This will always be `"assistant"`. + - `required BetaRefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required BetaStopReason? StopReason` The reason that we stopped. @@ -35425,6 +35644,28 @@ await foreach (var betaMessageBatchIndividualResponse in client.Beta.Messages.Ba This will always be `"assistant"`. + - `required BetaRefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required BetaStopReason? StopReason` The reason that we stopped. @@ -36601,6 +36842,28 @@ await foreach (var betaMessageBatchIndividualResponse in client.Beta.Messages.Ba This will always be `"assistant"`. + - `required BetaRefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required BetaStopReason? StopReason` The reason that we stopped. @@ -37739,6 +38002,28 @@ await foreach (var betaMessageBatchIndividualResponse in client.Beta.Messages.Ba This will always be `"assistant"`. + - `required BetaRefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required BetaStopReason? StopReason` The reason that we stopped. diff --git a/content/en/api/csharp/beta/messages/batches.md b/content/en/api/csharp/beta/messages/batches.md index 613afc742..335f474d9 100644 --- a/content/en/api/csharp/beta/messages/batches.md +++ b/content/en/api/csharp/beta/messages/batches.md @@ -4152,6 +4152,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Recommended for advanced use cases only. You usually only need to use `temperature`. + - `string? UserProfileID` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + - `IReadOnlyList betas` Header param: Optional header to specify the beta version(s) you want to use. @@ -4196,6 +4200,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class BetaMessageBatch:` @@ -4452,6 +4460,7 @@ BatchCreateParams parameters = new() ], TopK = 5, TopP = 0.7, + UserProfileID = "user_profile_id", }, }, ], @@ -4524,6 +4533,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class BetaMessageBatch:` @@ -4694,6 +4707,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class BatchListPageResponse:` @@ -4872,6 +4889,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class BetaMessageBatch:` @@ -5034,6 +5055,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class BetaDeletedMessageBatch:` @@ -5122,6 +5147,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class BetaMessageBatchIndividualResponse:` @@ -6001,6 +6030,28 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude This will always be `"assistant"`. + - `required BetaRefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required BetaStopReason? StopReason` The reason that we stopped. @@ -7350,6 +7401,28 @@ await foreach (var betaMessageBatchIndividualResponse in client.Beta.Messages.Ba This will always be `"assistant"`. + - `required BetaRefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required BetaStopReason? StopReason` The reason that we stopped. @@ -8526,6 +8599,28 @@ await foreach (var betaMessageBatchIndividualResponse in client.Beta.Messages.Ba This will always be `"assistant"`. + - `required BetaRefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required BetaStopReason? StopReason` The reason that we stopped. @@ -9664,6 +9759,28 @@ await foreach (var betaMessageBatchIndividualResponse in client.Beta.Messages.Ba This will always be `"assistant"`. + - `required BetaRefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required BetaStopReason? StopReason` The reason that we stopped. diff --git a/content/en/api/csharp/beta/messages/batches/cancel.md b/content/en/api/csharp/beta/messages/batches/cancel.md index 8675ac413..940e86fbe 100644 --- a/content/en/api/csharp/beta/messages/batches/cancel.md +++ b/content/en/api/csharp/beta/messages/batches/cancel.md @@ -62,6 +62,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class BetaMessageBatch:` diff --git a/content/en/api/csharp/beta/messages/batches/create.md b/content/en/api/csharp/beta/messages/batches/create.md index 44a4590d9..e166c4080 100644 --- a/content/en/api/csharp/beta/messages/batches/create.md +++ b/content/en/api/csharp/beta/messages/batches/create.md @@ -4150,6 +4150,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Recommended for advanced use cases only. You usually only need to use `temperature`. + - `string? UserProfileID` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + - `IReadOnlyList betas` Header param: Optional header to specify the beta version(s) you want to use. @@ -4194,6 +4198,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class BetaMessageBatch:` @@ -4450,6 +4458,7 @@ BatchCreateParams parameters = new() ], TopK = 5, TopP = 0.7, + UserProfileID = "user_profile_id", }, }, ], diff --git a/content/en/api/csharp/beta/messages/batches/delete.md b/content/en/api/csharp/beta/messages/batches/delete.md index 87b0e0610..2bbfc8e71 100644 --- a/content/en/api/csharp/beta/messages/batches/delete.md +++ b/content/en/api/csharp/beta/messages/batches/delete.md @@ -62,6 +62,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class BetaDeletedMessageBatch:` diff --git a/content/en/api/csharp/beta/messages/batches/list.md b/content/en/api/csharp/beta/messages/batches/list.md index eaddcf621..40b45ba44 100644 --- a/content/en/api/csharp/beta/messages/batches/list.md +++ b/content/en/api/csharp/beta/messages/batches/list.md @@ -70,6 +70,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class BatchListPageResponse:` diff --git a/content/en/api/csharp/beta/messages/batches/results.md b/content/en/api/csharp/beta/messages/batches/results.md index c0e624aff..075bbbba3 100644 --- a/content/en/api/csharp/beta/messages/batches/results.md +++ b/content/en/api/csharp/beta/messages/batches/results.md @@ -62,6 +62,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class BetaMessageBatchIndividualResponse:` @@ -941,6 +945,28 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude This will always be `"assistant"`. + - `required BetaRefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required BetaStopReason? StopReason` The reason that we stopped. diff --git a/content/en/api/csharp/beta/messages/batches/retrieve.md b/content/en/api/csharp/beta/messages/batches/retrieve.md index 7b1b5d0d3..120cd39b4 100644 --- a/content/en/api/csharp/beta/messages/batches/retrieve.md +++ b/content/en/api/csharp/beta/messages/batches/retrieve.md @@ -60,6 +60,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class BetaMessageBatch:` diff --git a/content/en/api/csharp/beta/messages/count_tokens.md b/content/en/api/csharp/beta/messages/count_tokens.md index 79ef45042..7da0539c7 100644 --- a/content/en/api/csharp/beta/messages/count_tokens.md +++ b/content/en/api/csharp/beta/messages/count_tokens.md @@ -3793,6 +3793,10 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class BetaMessageTokensCount:` diff --git a/content/en/api/csharp/beta/messages/create.md b/content/en/api/csharp/beta/messages/create.md index 6d8055612..12ed43cbc 100644 --- a/content/en/api/csharp/beta/messages/create.md +++ b/content/en/api/csharp/beta/messages/create.md @@ -3841,6 +3841,10 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en Recommended for advanced use cases only. You usually only need to use `temperature`. + - `string? userProfileID` + + Body param: The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + - `IReadOnlyList betas` Header param: Optional header to specify the beta version(s) you want to use. @@ -3885,6 +3889,10 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class BetaMessage:` @@ -4746,6 +4754,28 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en This will always be `"assistant"`. + - `required BetaRefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required BetaStopReason? StopReason` The reason that we stopped. diff --git a/content/en/api/csharp/beta/models.md b/content/en/api/csharp/beta/models.md index 889da0d16..f900cde32 100644 --- a/content/en/api/csharp/beta/models.md +++ b/content/en/api/csharp/beta/models.md @@ -72,6 +72,10 @@ The Models API response can be used to determine which models are available for - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class ModelListPageResponse:` @@ -342,6 +346,10 @@ The Models API response can be used to determine information about a specific mo - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class BetaModelInfo:` diff --git a/content/en/api/csharp/beta/models/list.md b/content/en/api/csharp/beta/models/list.md index 05354e860..99701c992 100644 --- a/content/en/api/csharp/beta/models/list.md +++ b/content/en/api/csharp/beta/models/list.md @@ -70,6 +70,10 @@ The Models API response can be used to determine which models are available for - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class ModelListPageResponse:` diff --git a/content/en/api/csharp/beta/models/retrieve.md b/content/en/api/csharp/beta/models/retrieve.md index d50d42883..231d82a10 100644 --- a/content/en/api/csharp/beta/models/retrieve.md +++ b/content/en/api/csharp/beta/models/retrieve.md @@ -60,6 +60,10 @@ The Models API response can be used to determine information about a specific mo - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class BetaModelInfo:` diff --git a/content/en/api/csharp/beta/skills.md b/content/en/api/csharp/beta/skills.md index aa6a3fd53..9d7c4f9e9 100644 --- a/content/en/api/csharp/beta/skills.md +++ b/content/en/api/csharp/beta/skills.md @@ -68,6 +68,10 @@ Create Skill - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class SkillCreateResponse:` @@ -200,6 +204,10 @@ List Skills - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class SkillListPageResponse:` @@ -335,6 +343,10 @@ Get Skill - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class SkillRetrieveResponse:` @@ -452,6 +464,10 @@ Delete Skill - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class SkillDeleteResponse:` @@ -548,6 +564,10 @@ Create Skill Version - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class VersionCreateResponse:` @@ -678,6 +698,10 @@ List Skill Versions - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class VersionListPageResponse:` @@ -818,6 +842,10 @@ Get Skill Version - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class VersionRetrieveResponse:` @@ -948,6 +976,10 @@ Delete Skill Version - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class VersionDeleteResponse:` diff --git a/content/en/api/csharp/beta/skills/create.md b/content/en/api/csharp/beta/skills/create.md index 0f2e4111f..e0c3aa4b6 100644 --- a/content/en/api/csharp/beta/skills/create.md +++ b/content/en/api/csharp/beta/skills/create.md @@ -66,6 +66,10 @@ Create Skill - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class SkillCreateResponse:` diff --git a/content/en/api/csharp/beta/skills/delete.md b/content/en/api/csharp/beta/skills/delete.md index 0ba3a01a5..f8bae7df6 100644 --- a/content/en/api/csharp/beta/skills/delete.md +++ b/content/en/api/csharp/beta/skills/delete.md @@ -60,6 +60,10 @@ Delete Skill - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class SkillDeleteResponse:` diff --git a/content/en/api/csharp/beta/skills/list.md b/content/en/api/csharp/beta/skills/list.md index 94a4a6d21..7d875f696 100644 --- a/content/en/api/csharp/beta/skills/list.md +++ b/content/en/api/csharp/beta/skills/list.md @@ -75,6 +75,10 @@ List Skills - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class SkillListPageResponse:` diff --git a/content/en/api/csharp/beta/skills/retrieve.md b/content/en/api/csharp/beta/skills/retrieve.md index 6129453a1..d0f38b3da 100644 --- a/content/en/api/csharp/beta/skills/retrieve.md +++ b/content/en/api/csharp/beta/skills/retrieve.md @@ -60,6 +60,10 @@ Get Skill - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class SkillRetrieveResponse:` diff --git a/content/en/api/csharp/beta/skills/versions.md b/content/en/api/csharp/beta/skills/versions.md index c667397dc..7f21fa68e 100644 --- a/content/en/api/csharp/beta/skills/versions.md +++ b/content/en/api/csharp/beta/skills/versions.md @@ -68,6 +68,10 @@ Create Skill Version - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class VersionCreateResponse:` @@ -198,6 +202,10 @@ List Skill Versions - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class VersionListPageResponse:` @@ -338,6 +346,10 @@ Get Skill Version - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class VersionRetrieveResponse:` @@ -468,6 +480,10 @@ Delete Skill Version - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class VersionDeleteResponse:` diff --git a/content/en/api/csharp/beta/skills/versions/create.md b/content/en/api/csharp/beta/skills/versions/create.md index ac3dd84fd..5fcd14d30 100644 --- a/content/en/api/csharp/beta/skills/versions/create.md +++ b/content/en/api/csharp/beta/skills/versions/create.md @@ -66,6 +66,10 @@ Create Skill Version - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class VersionCreateResponse:` diff --git a/content/en/api/csharp/beta/skills/versions/delete.md b/content/en/api/csharp/beta/skills/versions/delete.md index fb6a464a1..cba2130f9 100644 --- a/content/en/api/csharp/beta/skills/versions/delete.md +++ b/content/en/api/csharp/beta/skills/versions/delete.md @@ -66,6 +66,10 @@ Delete Skill Version - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class VersionDeleteResponse:` diff --git a/content/en/api/csharp/beta/skills/versions/list.md b/content/en/api/csharp/beta/skills/versions/list.md index 3b5ee97b9..5d2f6ef1a 100644 --- a/content/en/api/csharp/beta/skills/versions/list.md +++ b/content/en/api/csharp/beta/skills/versions/list.md @@ -70,6 +70,10 @@ List Skill Versions - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class VersionListPageResponse:` diff --git a/content/en/api/csharp/beta/skills/versions/retrieve.md b/content/en/api/csharp/beta/skills/versions/retrieve.md index 9e808056d..0609c6415 100644 --- a/content/en/api/csharp/beta/skills/versions/retrieve.md +++ b/content/en/api/csharp/beta/skills/versions/retrieve.md @@ -66,6 +66,10 @@ Get Skill Version - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class VersionRetrieveResponse:` diff --git a/content/en/api/csharp/beta/user_profiles.md b/content/en/api/csharp/beta/user_profiles.md new file mode 100644 index 000000000..3f782da0d --- /dev/null +++ b/content/en/api/csharp/beta/user_profiles.md @@ -0,0 +1,553 @@ +# User Profiles + +## Create + +`BetaUserProfile Beta.UserProfiles.Create(UserProfileCreateParams?parameters, CancellationTokencancellationToken = default)` + +**post** `/v1/user_profiles` + +Create User Profile + +### Parameters + +- `UserProfileCreateParams parameters` + + - `string? externalID` + + Body param + + - `IReadOnlyDictionary metadata` + + Body param: Free-form key-value data to attach to this user profile. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. Values must be non-empty strings. + + - `IReadOnlyList betas` + + Header param: Optional header to specify the beta version(s) you want to use. + + - `"message-batches-2024-09-24"MessageBatches2024_09_24` + + - `"prompt-caching-2024-07-31"PromptCaching2024_07_31` + + - `"computer-use-2024-10-22"ComputerUse2024_10_22` + + - `"computer-use-2025-01-24"ComputerUse2025_01_24` + + - `"pdfs-2024-09-25"Pdfs2024_09_25` + + - `"token-counting-2024-11-01"TokenCounting2024_11_01` + + - `"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19` + + - `"output-128k-2025-02-19"Output128k2025_02_19` + + - `"files-api-2025-04-14"FilesApi2025_04_14` + + - `"mcp-client-2025-04-04"McpClient2025_04_04` + + - `"mcp-client-2025-11-20"McpClient2025_11_20` + + - `"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14` + + - `"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14` + + - `"code-execution-2025-05-22"CodeExecution2025_05_22` + + - `"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11` + + - `"context-1m-2025-08-07"Context1m2025_08_07` + + - `"context-management-2025-06-27"ContextManagement2025_06_27` + + - `"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26` + + - `"skills-2025-10-02"Skills2025_10_02` + + - `"fast-mode-2026-02-01"FastMode2026_02_01` + + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + +### Returns + +- `class BetaUserProfile:` + + - `required string ID` + + - `required DateTimeOffset CreatedAt` + + A timestamp in RFC 3339 format + + - `required IReadOnlyDictionary Metadata` + + - `required IReadOnlyDictionary TrustGrants` + + - `required string Status` + + - `required string Type` + + - `required DateTimeOffset UpdatedAt` + + A timestamp in RFC 3339 format + + - `string? ExternalID` + +### Example + +```csharp +UserProfileCreateParams parameters = new(); + +var betaUserProfile = await client.Beta.UserProfiles.Create(parameters); + +Console.WriteLine(betaUserProfile); +``` + +## List + +`UserProfileListPageResponse Beta.UserProfiles.List(UserProfileListParams?parameters, CancellationTokencancellationToken = default)` + +**get** `/v1/user_profiles` + +List User Profiles + +### Parameters + +- `UserProfileListParams parameters` + + - `Int limit` + + Query param: Query parameter for limit + + - `Order order` + + Query param: Query parameter for order + + - `"asc"Asc` + + - `"desc"Desc` + + - `string page` + + Query param: Query parameter for page + + - `IReadOnlyList betas` + + Header param: Optional header to specify the beta version(s) you want to use. + + - `"message-batches-2024-09-24"MessageBatches2024_09_24` + + - `"prompt-caching-2024-07-31"PromptCaching2024_07_31` + + - `"computer-use-2024-10-22"ComputerUse2024_10_22` + + - `"computer-use-2025-01-24"ComputerUse2025_01_24` + + - `"pdfs-2024-09-25"Pdfs2024_09_25` + + - `"token-counting-2024-11-01"TokenCounting2024_11_01` + + - `"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19` + + - `"output-128k-2025-02-19"Output128k2025_02_19` + + - `"files-api-2025-04-14"FilesApi2025_04_14` + + - `"mcp-client-2025-04-04"McpClient2025_04_04` + + - `"mcp-client-2025-11-20"McpClient2025_11_20` + + - `"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14` + + - `"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14` + + - `"code-execution-2025-05-22"CodeExecution2025_05_22` + + - `"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11` + + - `"context-1m-2025-08-07"Context1m2025_08_07` + + - `"context-management-2025-06-27"ContextManagement2025_06_27` + + - `"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26` + + - `"skills-2025-10-02"Skills2025_10_02` + + - `"fast-mode-2026-02-01"FastMode2026_02_01` + + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + +### Returns + +- `class UserProfileListPageResponse:` + + - `required IReadOnlyList Data` + + - `required string ID` + + - `required DateTimeOffset CreatedAt` + + A timestamp in RFC 3339 format + + - `required IReadOnlyDictionary Metadata` + + - `required IReadOnlyDictionary TrustGrants` + + - `required string Status` + + - `required string Type` + + - `required DateTimeOffset UpdatedAt` + + A timestamp in RFC 3339 format + + - `string? ExternalID` + + - `string? NextPage` + +### Example + +```csharp +UserProfileListParams parameters = new(); + +var page = await client.Beta.UserProfiles.List(parameters); +await foreach (var item in page.Paginate()) +{ + Console.WriteLine(item); +} +``` + +## Retrieve + +`BetaUserProfile Beta.UserProfiles.Retrieve(UserProfileRetrieveParamsparameters, CancellationTokencancellationToken = default)` + +**get** `/v1/user_profiles/{id}` + +Get User Profile + +### Parameters + +- `UserProfileRetrieveParams parameters` + + - `required string id` + + Path parameter id + + - `IReadOnlyList betas` + + Optional header to specify the beta version(s) you want to use. + + - `"message-batches-2024-09-24"MessageBatches2024_09_24` + + - `"prompt-caching-2024-07-31"PromptCaching2024_07_31` + + - `"computer-use-2024-10-22"ComputerUse2024_10_22` + + - `"computer-use-2025-01-24"ComputerUse2025_01_24` + + - `"pdfs-2024-09-25"Pdfs2024_09_25` + + - `"token-counting-2024-11-01"TokenCounting2024_11_01` + + - `"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19` + + - `"output-128k-2025-02-19"Output128k2025_02_19` + + - `"files-api-2025-04-14"FilesApi2025_04_14` + + - `"mcp-client-2025-04-04"McpClient2025_04_04` + + - `"mcp-client-2025-11-20"McpClient2025_11_20` + + - `"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14` + + - `"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14` + + - `"code-execution-2025-05-22"CodeExecution2025_05_22` + + - `"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11` + + - `"context-1m-2025-08-07"Context1m2025_08_07` + + - `"context-management-2025-06-27"ContextManagement2025_06_27` + + - `"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26` + + - `"skills-2025-10-02"Skills2025_10_02` + + - `"fast-mode-2026-02-01"FastMode2026_02_01` + + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + +### Returns + +- `class BetaUserProfile:` + + - `required string ID` + + - `required DateTimeOffset CreatedAt` + + A timestamp in RFC 3339 format + + - `required IReadOnlyDictionary Metadata` + + - `required IReadOnlyDictionary TrustGrants` + + - `required string Status` + + - `required string Type` + + - `required DateTimeOffset UpdatedAt` + + A timestamp in RFC 3339 format + + - `string? ExternalID` + +### Example + +```csharp +UserProfileRetrieveParams parameters = new() { ID = "id" }; + +var betaUserProfile = await client.Beta.UserProfiles.Retrieve(parameters); + +Console.WriteLine(betaUserProfile); +``` + +## Update + +`BetaUserProfile Beta.UserProfiles.Update(UserProfileUpdateParamsparameters, CancellationTokencancellationToken = default)` + +**post** `/v1/user_profiles/{id}` + +Update User Profile + +### Parameters + +- `UserProfileUpdateParams parameters` + + - `required string id` + + Path param: Path parameter id + + - `string? externalID` + + Body param + + - `IReadOnlyDictionary metadata` + + Body param: Key-value pairs to merge into the stored metadata. Keys provided overwrite existing values. To remove a key, set its value to an empty string. Keys not provided are left unchanged. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. + + - `IReadOnlyList betas` + + Header param: Optional header to specify the beta version(s) you want to use. + + - `"message-batches-2024-09-24"MessageBatches2024_09_24` + + - `"prompt-caching-2024-07-31"PromptCaching2024_07_31` + + - `"computer-use-2024-10-22"ComputerUse2024_10_22` + + - `"computer-use-2025-01-24"ComputerUse2025_01_24` + + - `"pdfs-2024-09-25"Pdfs2024_09_25` + + - `"token-counting-2024-11-01"TokenCounting2024_11_01` + + - `"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19` + + - `"output-128k-2025-02-19"Output128k2025_02_19` + + - `"files-api-2025-04-14"FilesApi2025_04_14` + + - `"mcp-client-2025-04-04"McpClient2025_04_04` + + - `"mcp-client-2025-11-20"McpClient2025_11_20` + + - `"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14` + + - `"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14` + + - `"code-execution-2025-05-22"CodeExecution2025_05_22` + + - `"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11` + + - `"context-1m-2025-08-07"Context1m2025_08_07` + + - `"context-management-2025-06-27"ContextManagement2025_06_27` + + - `"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26` + + - `"skills-2025-10-02"Skills2025_10_02` + + - `"fast-mode-2026-02-01"FastMode2026_02_01` + + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + +### Returns + +- `class BetaUserProfile:` + + - `required string ID` + + - `required DateTimeOffset CreatedAt` + + A timestamp in RFC 3339 format + + - `required IReadOnlyDictionary Metadata` + + - `required IReadOnlyDictionary TrustGrants` + + - `required string Status` + + - `required string Type` + + - `required DateTimeOffset UpdatedAt` + + A timestamp in RFC 3339 format + + - `string? ExternalID` + +### Example + +```csharp +UserProfileUpdateParams parameters = new() { ID = "id" }; + +var betaUserProfile = await client.Beta.UserProfiles.Update(parameters); + +Console.WriteLine(betaUserProfile); +``` + +## Create Enrollment URL + +`BetaUserProfileEnrollmentUrl Beta.UserProfiles.CreateEnrollmentUrl(UserProfileCreateEnrollmentUrlParamsparameters, CancellationTokencancellationToken = default)` + +**post** `/v1/user_profiles/{id}/enrollment_url` + +Create Enrollment URL + +### Parameters + +- `UserProfileCreateEnrollmentUrlParams parameters` + + - `required string id` + + Path parameter id + + - `IReadOnlyList betas` + + Optional header to specify the beta version(s) you want to use. + + - `"message-batches-2024-09-24"MessageBatches2024_09_24` + + - `"prompt-caching-2024-07-31"PromptCaching2024_07_31` + + - `"computer-use-2024-10-22"ComputerUse2024_10_22` + + - `"computer-use-2025-01-24"ComputerUse2025_01_24` + + - `"pdfs-2024-09-25"Pdfs2024_09_25` + + - `"token-counting-2024-11-01"TokenCounting2024_11_01` + + - `"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19` + + - `"output-128k-2025-02-19"Output128k2025_02_19` + + - `"files-api-2025-04-14"FilesApi2025_04_14` + + - `"mcp-client-2025-04-04"McpClient2025_04_04` + + - `"mcp-client-2025-11-20"McpClient2025_11_20` + + - `"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14` + + - `"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14` + + - `"code-execution-2025-05-22"CodeExecution2025_05_22` + + - `"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11` + + - `"context-1m-2025-08-07"Context1m2025_08_07` + + - `"context-management-2025-06-27"ContextManagement2025_06_27` + + - `"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26` + + - `"skills-2025-10-02"Skills2025_10_02` + + - `"fast-mode-2026-02-01"FastMode2026_02_01` + + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + +### Returns + +- `class BetaUserProfileEnrollmentUrl:` + + - `required DateTimeOffset ExpiresAt` + + A timestamp in RFC 3339 format + + - `required string Type` + + - `required string Url` + +### Example + +```csharp +UserProfileCreateEnrollmentUrlParams parameters = new() { ID = "id" }; + +var betaUserProfileEnrollmentUrl = await client.Beta.UserProfiles.CreateEnrollmentUrl(parameters); + +Console.WriteLine(betaUserProfileEnrollmentUrl); +``` + +## Domain Types + +### Beta User Profile + +- `class BetaUserProfile:` + + - `required string ID` + + - `required DateTimeOffset CreatedAt` + + A timestamp in RFC 3339 format + + - `required IReadOnlyDictionary Metadata` + + - `required IReadOnlyDictionary TrustGrants` + + - `required string Status` + + - `required string Type` + + - `required DateTimeOffset UpdatedAt` + + A timestamp in RFC 3339 format + + - `string? ExternalID` + +### Beta User Profile Enrollment URL + +- `class BetaUserProfileEnrollmentUrl:` + + - `required DateTimeOffset ExpiresAt` + + A timestamp in RFC 3339 format + + - `required string Type` + + - `required string Url` + +### Beta User Profile Trust Grant + +- `class BetaUserProfileTrustGrant:` + + - `required string Status` diff --git a/content/en/api/csharp/beta/user_profiles/create.md b/content/en/api/csharp/beta/user_profiles/create.md new file mode 100644 index 000000000..650f792e5 --- /dev/null +++ b/content/en/api/csharp/beta/user_profiles/create.md @@ -0,0 +1,101 @@ +## Create + +`BetaUserProfile Beta.UserProfiles.Create(UserProfileCreateParams?parameters, CancellationTokencancellationToken = default)` + +**post** `/v1/user_profiles` + +Create User Profile + +### Parameters + +- `UserProfileCreateParams parameters` + + - `string? externalID` + + Body param + + - `IReadOnlyDictionary metadata` + + Body param: Free-form key-value data to attach to this user profile. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. Values must be non-empty strings. + + - `IReadOnlyList betas` + + Header param: Optional header to specify the beta version(s) you want to use. + + - `"message-batches-2024-09-24"MessageBatches2024_09_24` + + - `"prompt-caching-2024-07-31"PromptCaching2024_07_31` + + - `"computer-use-2024-10-22"ComputerUse2024_10_22` + + - `"computer-use-2025-01-24"ComputerUse2025_01_24` + + - `"pdfs-2024-09-25"Pdfs2024_09_25` + + - `"token-counting-2024-11-01"TokenCounting2024_11_01` + + - `"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19` + + - `"output-128k-2025-02-19"Output128k2025_02_19` + + - `"files-api-2025-04-14"FilesApi2025_04_14` + + - `"mcp-client-2025-04-04"McpClient2025_04_04` + + - `"mcp-client-2025-11-20"McpClient2025_11_20` + + - `"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14` + + - `"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14` + + - `"code-execution-2025-05-22"CodeExecution2025_05_22` + + - `"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11` + + - `"context-1m-2025-08-07"Context1m2025_08_07` + + - `"context-management-2025-06-27"ContextManagement2025_06_27` + + - `"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26` + + - `"skills-2025-10-02"Skills2025_10_02` + + - `"fast-mode-2026-02-01"FastMode2026_02_01` + + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + +### Returns + +- `class BetaUserProfile:` + + - `required string ID` + + - `required DateTimeOffset CreatedAt` + + A timestamp in RFC 3339 format + + - `required IReadOnlyDictionary Metadata` + + - `required IReadOnlyDictionary TrustGrants` + + - `required string Status` + + - `required string Type` + + - `required DateTimeOffset UpdatedAt` + + A timestamp in RFC 3339 format + + - `string? ExternalID` + +### Example + +```csharp +UserProfileCreateParams parameters = new(); + +var betaUserProfile = await client.Beta.UserProfiles.Create(parameters); + +Console.WriteLine(betaUserProfile); +``` diff --git a/content/en/api/csharp/beta/user_profiles/create_enrollment_url.md b/content/en/api/csharp/beta/user_profiles/create_enrollment_url.md new file mode 100644 index 000000000..460072d35 --- /dev/null +++ b/content/en/api/csharp/beta/user_profiles/create_enrollment_url.md @@ -0,0 +1,85 @@ +## Create Enrollment URL + +`BetaUserProfileEnrollmentUrl Beta.UserProfiles.CreateEnrollmentUrl(UserProfileCreateEnrollmentUrlParamsparameters, CancellationTokencancellationToken = default)` + +**post** `/v1/user_profiles/{id}/enrollment_url` + +Create Enrollment URL + +### Parameters + +- `UserProfileCreateEnrollmentUrlParams parameters` + + - `required string id` + + Path parameter id + + - `IReadOnlyList betas` + + Optional header to specify the beta version(s) you want to use. + + - `"message-batches-2024-09-24"MessageBatches2024_09_24` + + - `"prompt-caching-2024-07-31"PromptCaching2024_07_31` + + - `"computer-use-2024-10-22"ComputerUse2024_10_22` + + - `"computer-use-2025-01-24"ComputerUse2025_01_24` + + - `"pdfs-2024-09-25"Pdfs2024_09_25` + + - `"token-counting-2024-11-01"TokenCounting2024_11_01` + + - `"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19` + + - `"output-128k-2025-02-19"Output128k2025_02_19` + + - `"files-api-2025-04-14"FilesApi2025_04_14` + + - `"mcp-client-2025-04-04"McpClient2025_04_04` + + - `"mcp-client-2025-11-20"McpClient2025_11_20` + + - `"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14` + + - `"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14` + + - `"code-execution-2025-05-22"CodeExecution2025_05_22` + + - `"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11` + + - `"context-1m-2025-08-07"Context1m2025_08_07` + + - `"context-management-2025-06-27"ContextManagement2025_06_27` + + - `"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26` + + - `"skills-2025-10-02"Skills2025_10_02` + + - `"fast-mode-2026-02-01"FastMode2026_02_01` + + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + +### Returns + +- `class BetaUserProfileEnrollmentUrl:` + + - `required DateTimeOffset ExpiresAt` + + A timestamp in RFC 3339 format + + - `required string Type` + + - `required string Url` + +### Example + +```csharp +UserProfileCreateEnrollmentUrlParams parameters = new() { ID = "id" }; + +var betaUserProfileEnrollmentUrl = await client.Beta.UserProfiles.CreateEnrollmentUrl(parameters); + +Console.WriteLine(betaUserProfileEnrollmentUrl); +``` diff --git a/content/en/api/csharp/beta/user_profiles/list.md b/content/en/api/csharp/beta/user_profiles/list.md new file mode 100644 index 000000000..503532e98 --- /dev/null +++ b/content/en/api/csharp/beta/user_profiles/list.md @@ -0,0 +1,115 @@ +## List + +`UserProfileListPageResponse Beta.UserProfiles.List(UserProfileListParams?parameters, CancellationTokencancellationToken = default)` + +**get** `/v1/user_profiles` + +List User Profiles + +### Parameters + +- `UserProfileListParams parameters` + + - `Int limit` + + Query param: Query parameter for limit + + - `Order order` + + Query param: Query parameter for order + + - `"asc"Asc` + + - `"desc"Desc` + + - `string page` + + Query param: Query parameter for page + + - `IReadOnlyList betas` + + Header param: Optional header to specify the beta version(s) you want to use. + + - `"message-batches-2024-09-24"MessageBatches2024_09_24` + + - `"prompt-caching-2024-07-31"PromptCaching2024_07_31` + + - `"computer-use-2024-10-22"ComputerUse2024_10_22` + + - `"computer-use-2025-01-24"ComputerUse2025_01_24` + + - `"pdfs-2024-09-25"Pdfs2024_09_25` + + - `"token-counting-2024-11-01"TokenCounting2024_11_01` + + - `"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19` + + - `"output-128k-2025-02-19"Output128k2025_02_19` + + - `"files-api-2025-04-14"FilesApi2025_04_14` + + - `"mcp-client-2025-04-04"McpClient2025_04_04` + + - `"mcp-client-2025-11-20"McpClient2025_11_20` + + - `"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14` + + - `"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14` + + - `"code-execution-2025-05-22"CodeExecution2025_05_22` + + - `"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11` + + - `"context-1m-2025-08-07"Context1m2025_08_07` + + - `"context-management-2025-06-27"ContextManagement2025_06_27` + + - `"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26` + + - `"skills-2025-10-02"Skills2025_10_02` + + - `"fast-mode-2026-02-01"FastMode2026_02_01` + + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + +### Returns + +- `class UserProfileListPageResponse:` + + - `required IReadOnlyList Data` + + - `required string ID` + + - `required DateTimeOffset CreatedAt` + + A timestamp in RFC 3339 format + + - `required IReadOnlyDictionary Metadata` + + - `required IReadOnlyDictionary TrustGrants` + + - `required string Status` + + - `required string Type` + + - `required DateTimeOffset UpdatedAt` + + A timestamp in RFC 3339 format + + - `string? ExternalID` + + - `string? NextPage` + +### Example + +```csharp +UserProfileListParams parameters = new(); + +var page = await client.Beta.UserProfiles.List(parameters); +await foreach (var item in page.Paginate()) +{ + Console.WriteLine(item); +} +``` diff --git a/content/en/api/csharp/beta/user_profiles/retrieve.md b/content/en/api/csharp/beta/user_profiles/retrieve.md new file mode 100644 index 000000000..b85c75644 --- /dev/null +++ b/content/en/api/csharp/beta/user_profiles/retrieve.md @@ -0,0 +1,97 @@ +## Retrieve + +`BetaUserProfile Beta.UserProfiles.Retrieve(UserProfileRetrieveParamsparameters, CancellationTokencancellationToken = default)` + +**get** `/v1/user_profiles/{id}` + +Get User Profile + +### Parameters + +- `UserProfileRetrieveParams parameters` + + - `required string id` + + Path parameter id + + - `IReadOnlyList betas` + + Optional header to specify the beta version(s) you want to use. + + - `"message-batches-2024-09-24"MessageBatches2024_09_24` + + - `"prompt-caching-2024-07-31"PromptCaching2024_07_31` + + - `"computer-use-2024-10-22"ComputerUse2024_10_22` + + - `"computer-use-2025-01-24"ComputerUse2025_01_24` + + - `"pdfs-2024-09-25"Pdfs2024_09_25` + + - `"token-counting-2024-11-01"TokenCounting2024_11_01` + + - `"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19` + + - `"output-128k-2025-02-19"Output128k2025_02_19` + + - `"files-api-2025-04-14"FilesApi2025_04_14` + + - `"mcp-client-2025-04-04"McpClient2025_04_04` + + - `"mcp-client-2025-11-20"McpClient2025_11_20` + + - `"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14` + + - `"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14` + + - `"code-execution-2025-05-22"CodeExecution2025_05_22` + + - `"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11` + + - `"context-1m-2025-08-07"Context1m2025_08_07` + + - `"context-management-2025-06-27"ContextManagement2025_06_27` + + - `"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26` + + - `"skills-2025-10-02"Skills2025_10_02` + + - `"fast-mode-2026-02-01"FastMode2026_02_01` + + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + +### Returns + +- `class BetaUserProfile:` + + - `required string ID` + + - `required DateTimeOffset CreatedAt` + + A timestamp in RFC 3339 format + + - `required IReadOnlyDictionary Metadata` + + - `required IReadOnlyDictionary TrustGrants` + + - `required string Status` + + - `required string Type` + + - `required DateTimeOffset UpdatedAt` + + A timestamp in RFC 3339 format + + - `string? ExternalID` + +### Example + +```csharp +UserProfileRetrieveParams parameters = new() { ID = "id" }; + +var betaUserProfile = await client.Beta.UserProfiles.Retrieve(parameters); + +Console.WriteLine(betaUserProfile); +``` diff --git a/content/en/api/csharp/beta/user_profiles/update.md b/content/en/api/csharp/beta/user_profiles/update.md new file mode 100644 index 000000000..53af6d559 --- /dev/null +++ b/content/en/api/csharp/beta/user_profiles/update.md @@ -0,0 +1,105 @@ +## Update + +`BetaUserProfile Beta.UserProfiles.Update(UserProfileUpdateParamsparameters, CancellationTokencancellationToken = default)` + +**post** `/v1/user_profiles/{id}` + +Update User Profile + +### Parameters + +- `UserProfileUpdateParams parameters` + + - `required string id` + + Path param: Path parameter id + + - `string? externalID` + + Body param + + - `IReadOnlyDictionary metadata` + + Body param: Key-value pairs to merge into the stored metadata. Keys provided overwrite existing values. To remove a key, set its value to an empty string. Keys not provided are left unchanged. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. + + - `IReadOnlyList betas` + + Header param: Optional header to specify the beta version(s) you want to use. + + - `"message-batches-2024-09-24"MessageBatches2024_09_24` + + - `"prompt-caching-2024-07-31"PromptCaching2024_07_31` + + - `"computer-use-2024-10-22"ComputerUse2024_10_22` + + - `"computer-use-2025-01-24"ComputerUse2025_01_24` + + - `"pdfs-2024-09-25"Pdfs2024_09_25` + + - `"token-counting-2024-11-01"TokenCounting2024_11_01` + + - `"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19` + + - `"output-128k-2025-02-19"Output128k2025_02_19` + + - `"files-api-2025-04-14"FilesApi2025_04_14` + + - `"mcp-client-2025-04-04"McpClient2025_04_04` + + - `"mcp-client-2025-11-20"McpClient2025_11_20` + + - `"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14` + + - `"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14` + + - `"code-execution-2025-05-22"CodeExecution2025_05_22` + + - `"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11` + + - `"context-1m-2025-08-07"Context1m2025_08_07` + + - `"context-management-2025-06-27"ContextManagement2025_06_27` + + - `"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26` + + - `"skills-2025-10-02"Skills2025_10_02` + + - `"fast-mode-2026-02-01"FastMode2026_02_01` + + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + +### Returns + +- `class BetaUserProfile:` + + - `required string ID` + + - `required DateTimeOffset CreatedAt` + + A timestamp in RFC 3339 format + + - `required IReadOnlyDictionary Metadata` + + - `required IReadOnlyDictionary TrustGrants` + + - `required string Status` + + - `required string Type` + + - `required DateTimeOffset UpdatedAt` + + A timestamp in RFC 3339 format + + - `string? ExternalID` + +### Example + +```csharp +UserProfileUpdateParams parameters = new() { ID = "id" }; + +var betaUserProfile = await client.Beta.UserProfiles.Update(parameters); + +Console.WriteLine(betaUserProfile); +``` diff --git a/content/en/api/csharp/messages.md b/content/en/api/csharp/messages.md index 4d4c7d605..7afe48264 100644 --- a/content/en/api/csharp/messages.md +++ b/content/en/api/csharp/messages.md @@ -3861,6 +3861,28 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en This will always be `"assistant"`. + - `required RefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required StopReason? StopReason` The reason that we stopped. @@ -12099,6 +12121,28 @@ Console.WriteLine(messageTokensCount); This will always be `"assistant"`. + - `required RefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required StopReason? StopReason` The reason that we stopped. @@ -15976,6 +16020,28 @@ Console.WriteLine(messageTokensCount); The time at which the container will expire. + - `required RefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required StopReason? StopReason` - `"end_turn"EndTurn` @@ -16709,6 +16775,28 @@ Console.WriteLine(messageTokensCount); This will always be `"assistant"`. + - `required RefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required StopReason? StopReason` The reason that we stopped. @@ -17499,6 +17587,28 @@ Console.WriteLine(messageTokensCount); This will always be `"assistant"`. + - `required RefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required StopReason? StopReason` The reason that we stopped. @@ -17622,6 +17732,28 @@ Console.WriteLine(messageTokensCount); The time at which the container will expire. + - `required RefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required StopReason? StopReason` - `"end_turn"EndTurn` @@ -18380,6 +18512,30 @@ Console.WriteLine(messageTokensCount); - `JsonElement Type "redacted_thinking"constant` +### Refusal Stop Details + +- `class RefusalStopDetails:` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + ### Search Result Block Param - `class SearchResultBlockParam:` @@ -28071,6 +28227,28 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude This will always be `"assistant"`. + - `required RefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required StopReason? StopReason` The reason that we stopped. @@ -29138,6 +29316,28 @@ await foreach (var messageBatchIndividualResponse in client.Messages.Batches.Res This will always be `"assistant"`. + - `required RefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required StopReason? StopReason` The reason that we stopped. @@ -30032,6 +30232,28 @@ await foreach (var messageBatchIndividualResponse in client.Messages.Batches.Res This will always be `"assistant"`. + - `required RefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required StopReason? StopReason` The reason that we stopped. @@ -30888,6 +31110,28 @@ await foreach (var messageBatchIndividualResponse in client.Messages.Batches.Res This will always be `"assistant"`. + - `required RefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required StopReason? StopReason` The reason that we stopped. diff --git a/content/en/api/csharp/messages/batches.md b/content/en/api/csharp/messages/batches.md index e0d7a5cca..042d7258a 100644 --- a/content/en/api/csharp/messages/batches.md +++ b/content/en/api/csharp/messages/batches.md @@ -4740,6 +4740,28 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude This will always be `"assistant"`. + - `required RefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required StopReason? StopReason` The reason that we stopped. @@ -5807,6 +5829,28 @@ await foreach (var messageBatchIndividualResponse in client.Messages.Batches.Res This will always be `"assistant"`. + - `required RefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required StopReason? StopReason` The reason that we stopped. @@ -6701,6 +6745,28 @@ await foreach (var messageBatchIndividualResponse in client.Messages.Batches.Res This will always be `"assistant"`. + - `required RefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required StopReason? StopReason` The reason that we stopped. @@ -7557,6 +7623,28 @@ await foreach (var messageBatchIndividualResponse in client.Messages.Batches.Res This will always be `"assistant"`. + - `required RefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required StopReason? StopReason` The reason that we stopped. diff --git a/content/en/api/csharp/messages/batches/results.md b/content/en/api/csharp/messages/batches/results.md index 1edb65e60..f4be58ea3 100644 --- a/content/en/api/csharp/messages/batches/results.md +++ b/content/en/api/csharp/messages/batches/results.md @@ -709,6 +709,28 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude This will always be `"assistant"`. + - `required RefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required StopReason? StopReason` The reason that we stopped. diff --git a/content/en/api/csharp/messages/create.md b/content/en/api/csharp/messages/create.md index 31fe99ed0..bb797667e 100644 --- a/content/en/api/csharp/messages/create.md +++ b/content/en/api/csharp/messages/create.md @@ -3859,6 +3859,28 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en This will always be `"assistant"`. + - `required RefusalStopDetails? StopDetails` + + Structured information about a refusal. + + - `required Category? Category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"Cyber` + + - `"bio"Bio` + + - `required string? Explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonElement Type "refusal"constant` + - `required StopReason? StopReason` The reason that we stopped. diff --git a/content/en/api/csharp/models.md b/content/en/api/csharp/models.md index c15e80cfc..019b011a8 100644 --- a/content/en/api/csharp/models.md +++ b/content/en/api/csharp/models.md @@ -72,6 +72,10 @@ The Models API response can be used to determine which models are available for - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class ModelListPageResponse:` @@ -342,6 +346,10 @@ The Models API response can be used to determine information about a specific mo - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class ModelInfo:` diff --git a/content/en/api/csharp/models/list.md b/content/en/api/csharp/models/list.md index 9ff68a4b7..c7e5767cc 100644 --- a/content/en/api/csharp/models/list.md +++ b/content/en/api/csharp/models/list.md @@ -70,6 +70,10 @@ The Models API response can be used to determine which models are available for - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class ModelListPageResponse:` diff --git a/content/en/api/csharp/models/retrieve.md b/content/en/api/csharp/models/retrieve.md index 6da516fcc..006d3be5f 100644 --- a/content/en/api/csharp/models/retrieve.md +++ b/content/en/api/csharp/models/retrieve.md @@ -60,6 +60,10 @@ The Models API response can be used to determine information about a specific mo - `"fast-mode-2026-02-01"FastMode2026_02_01` + - `"output-300k-2026-03-24"Output300k2026_03_24` + + - `"user-profiles-2026-03-24"UserProfiles2026_03_24` + ### Returns - `class ModelInfo:` diff --git a/content/en/api/errors.md b/content/en/api/errors.md index 27c736ef0..41ab7bf23 100644 --- a/content/en/api/errors.md +++ b/content/en/api/errors.md @@ -14,6 +14,7 @@ The API follows a predictable HTTP error code format: * 413 - `request_too_large`: Request exceeds the maximum allowed number of bytes. The maximum request size is 32 MB for standard API endpoints. * 429 - `rate_limit_error`: Your account has hit a rate limit. * 500 - `api_error`: An unexpected error has occurred internal to Anthropic's systems. +* 504 - `timeout_error`: The request timed out while processing. Consider using [streaming](/docs/en/build-with-claude/streaming) for long-running requests. * 529 - `overloaded_error`: The API is temporarily overloaded. @@ -135,7 +136,7 @@ See [Streaming Messages](/docs/en/build-with-claude/streaming#get-the-final-mess ### Prefill not supported -Claude Opus 4.6 does not support prefilling assistant messages. Sending a request with a prefilled last assistant message to this model returns a 400 `invalid_request_error`: +[Claude Mythos Preview](https://anthropic.com/glasswing) and Claude Opus 4.6 do not support prefilling assistant messages. Sending a request with a prefilled last assistant message to either model returns a 400 `invalid_request_error`: ```json { diff --git a/content/en/api/go/beta.md b/content/en/api/go/beta.md index 7e1005b97..3fc56ff41 100644 --- a/content/en/api/go/beta.md +++ b/content/en/api/go/beta.md @@ -50,6 +50,10 @@ - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Beta API Error - `type BetaAPIError struct{…}` @@ -378,6 +382,10 @@ The Models API response can be used to determine which models are available for - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaModelInfo struct{…}` @@ -655,6 +663,10 @@ The Models API response can be used to determine information about a specific mo - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaModelInfo struct{…}` @@ -5681,6 +5693,10 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en Recommended for advanced use cases only. You usually only need to use `temperature`. + - `UserProfileID param.Field[string]` + + Body param: The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + - `Betas param.Field[[]AnthropicBeta]` Header param: Optional header to specify the beta version(s) you want to use. @@ -5729,6 +5745,10 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaMessage struct{…}` @@ -6728,6 +6748,30 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails BetaRefusalStopDetails` + + Structured information about a refusal. + + - `Category BetaRefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const BetaRefusalStopDetailsCategoryCyber BetaRefusalStopDetailsCategory = "cyber"` + + - `const BetaRefusalStopDetailsCategoryBio BetaRefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason BetaStopReason` The reason that we stopped. @@ -11256,6 +11300,10 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaMessageTokensCount struct{…}` @@ -18566,6 +18614,30 @@ func main() { - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails BetaRefusalStopDetails` + + Structured information about a refusal. + + - `Category BetaRefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const BetaRefusalStopDetailsCategoryCyber BetaRefusalStopDetailsCategory = "cyber"` + + - `const BetaRefusalStopDetailsCategoryBio BetaRefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason BetaStopReason` The reason that we stopped. @@ -22707,6 +22779,30 @@ func main() { Skill version or 'latest' for most recent version + - `StopDetails BetaRefusalStopDetails` + + Structured information about a refusal. + + - `Category BetaRefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const BetaRefusalStopDetailsCategoryCyber BetaRefusalStopDetailsCategory = "cyber"` + + - `const BetaRefusalStopDetailsCategoryBio BetaRefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason BetaStopReason` - `const BetaStopReasonEndTurn BetaStopReason = "end_turn"` @@ -23858,6 +23954,30 @@ func main() { - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails BetaRefusalStopDetails` + + Structured information about a refusal. + + - `Category BetaRefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const BetaRefusalStopDetailsCategoryCyber BetaRefusalStopDetailsCategory = "cyber"` + + - `const BetaRefusalStopDetailsCategoryBio BetaRefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason BetaStopReason` The reason that we stopped. @@ -25078,6 +25198,30 @@ func main() { - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails BetaRefusalStopDetails` + + Structured information about a refusal. + + - `Category BetaRefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const BetaRefusalStopDetailsCategoryCyber BetaRefusalStopDetailsCategory = "cyber"` + + - `const BetaRefusalStopDetailsCategoryBio BetaRefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason BetaStopReason` The reason that we stopped. @@ -25363,6 +25507,30 @@ func main() { Skill version or 'latest' for most recent version + - `StopDetails BetaRefusalStopDetails` + + Structured information about a refusal. + + - `Category BetaRefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const BetaRefusalStopDetailsCategoryCyber BetaRefusalStopDetailsCategory = "cyber"` + + - `const BetaRefusalStopDetailsCategoryBio BetaRefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason BetaStopReason` - `const BetaStopReasonEndTurn BetaStopReason = "end_turn"` @@ -26507,6 +26675,32 @@ func main() { - `const RedactedThinkingRedactedThinking RedactedThinking = "redacted_thinking"` +### Beta Refusal Stop Details + +- `type BetaRefusalStopDetails struct{…}` + + Structured information about a refusal. + + - `Category BetaRefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const BetaRefusalStopDetailsCategoryCyber BetaRefusalStopDetailsCategory = "cyber"` + + - `const BetaRefusalStopDetailsCategoryBio BetaRefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + ### Beta Request Document Block - `type BetaRequestDocumentBlock struct{…}` @@ -38139,6 +38333,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Recommended for advanced use cases only. You usually only need to use `temperature`. + - `UserProfileID string` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + - `Betas param.Field[[]AnthropicBeta]` Header param: Optional header to specify the beta version(s) you want to use. @@ -38187,6 +38385,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaMessageBatch struct{…}` @@ -38384,6 +38586,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaMessageBatch struct{…}` @@ -38581,190 +38787,198 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` -### Returns - -- `type BetaMessageBatch struct{…}` - - - `ID string` - - Unique object identifier. - - The format and length of IDs may change over time. - - - `ArchivedAt Time` - - RFC 3339 datetime string representing the time at which the Message Batch was archived and its results became unavailable. - - - `CancelInitiatedAt Time` - - RFC 3339 datetime string representing the time at which cancellation was initiated for the Message Batch. Specified only if cancellation was initiated. - - - `CreatedAt Time` - - RFC 3339 datetime string representing the time at which the Message Batch was created. - - - `EndedAt Time` - - RFC 3339 datetime string representing the time at which processing for the Message Batch ended. Specified only once processing ends. - - Processing ends when every request in a Message Batch has either succeeded, errored, canceled, or expired. - - - `ExpiresAt Time` - - RFC 3339 datetime string representing the time at which the Message Batch will expire and end processing, which is 24 hours after creation. - - - `ProcessingStatus BetaMessageBatchProcessingStatus` - - Processing status of the Message Batch. - - - `const BetaMessageBatchProcessingStatusInProgress BetaMessageBatchProcessingStatus = "in_progress"` - - - `const BetaMessageBatchProcessingStatusCanceling BetaMessageBatchProcessingStatus = "canceling"` - - - `const BetaMessageBatchProcessingStatusEnded BetaMessageBatchProcessingStatus = "ended"` - - - `RequestCounts BetaMessageBatchRequestCounts` - - Tallies requests within the Message Batch, categorized by their status. - - Requests start as `processing` and move to one of the other statuses only once processing of the entire batch ends. The sum of all values always matches the total number of requests in the batch. - - - `Canceled int64` - - Number of requests in the Message Batch that have been canceled. - - This is zero until processing of the entire Message Batch has ended. - - - `Errored int64` - - Number of requests in the Message Batch that encountered an error. - - This is zero until processing of the entire Message Batch has ended. - - - `Expired int64` - - Number of requests in the Message Batch that have expired. - - This is zero until processing of the entire Message Batch has ended. - - - `Processing int64` - - Number of requests in the Message Batch that are processing. - - - `Succeeded int64` - - Number of requests in the Message Batch that have completed successfully. - - This is zero until processing of the entire Message Batch has ended. - - - `ResultsURL string` - - URL to a `.jsonl` file containing the results of the Message Batch requests. Specified only once processing ends. - - Results in the file are not guaranteed to be in the same order as requests. Use the `custom_id` field to match results to requests. - - - `Type MessageBatch` - - Object type. - - For Message Batches, this is always `"message_batch"`. - - - `const MessageBatchMessageBatch MessageBatch = "message_batch"` - -### Example - -```go -package main + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` -import ( - "context" - "fmt" - - "github.com/anthropics/anthropic-sdk-go" - "github.com/anthropics/anthropic-sdk-go/option" -) - -func main() { - client := anthropic.NewClient( - option.WithAPIKey("my-anthropic-api-key"), - ) - page, err := client.Beta.Messages.Batches.List(context.TODO(), anthropic.BetaMessageBatchListParams{ - - }) - if err != nil { - panic(err.Error()) - } - fmt.Printf("%+v\n", page) -} -``` - -## Cancel - -`client.Beta.Messages.Batches.Cancel(ctx, messageBatchID, body) (*BetaMessageBatch, error)` - -**post** `/v1/messages/batches/{message_batch_id}/cancel` - -Batches may be canceled any time before processing ends. Once cancellation is initiated, the batch enters a `canceling` state, at which time the system may complete any in-progress, non-interruptible requests before finalizing cancellation. - -The number of canceled requests is specified in `request_counts`. To determine which requests were canceled, check the individual results within the batch. Note that cancellation may not result in any canceled requests if they were non-interruptible. - -Learn more about the Message Batches API in our [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing) - -### Parameters - -- `messageBatchID string` - - ID of the Message Batch. - -- `body BetaMessageBatchCancelParams` - - - `Betas param.Field[[]AnthropicBeta]` - - Optional header to specify the beta version(s) you want to use. - - - `string` - - - `type AnthropicBeta string` - - - `const AnthropicBetaMessageBatches2024_09_24 AnthropicBeta = "message-batches-2024-09-24"` - - - `const AnthropicBetaPromptCaching2024_07_31 AnthropicBeta = "prompt-caching-2024-07-31"` - - - `const AnthropicBetaComputerUse2024_10_22 AnthropicBeta = "computer-use-2024-10-22"` - - - `const AnthropicBetaComputerUse2025_01_24 AnthropicBeta = "computer-use-2025-01-24"` - - - `const AnthropicBetaPDFs2024_09_25 AnthropicBeta = "pdfs-2024-09-25"` - - - `const AnthropicBetaTokenCounting2024_11_01 AnthropicBeta = "token-counting-2024-11-01"` - - - `const AnthropicBetaTokenEfficientTools2025_02_19 AnthropicBeta = "token-efficient-tools-2025-02-19"` - - - `const AnthropicBetaOutput128k2025_02_19 AnthropicBeta = "output-128k-2025-02-19"` - - - `const AnthropicBetaFilesAPI2025_04_14 AnthropicBeta = "files-api-2025-04-14"` - - - `const AnthropicBetaMCPClient2025_04_04 AnthropicBeta = "mcp-client-2025-04-04"` - - - `const AnthropicBetaMCPClient2025_11_20 AnthropicBeta = "mcp-client-2025-11-20"` - - - `const AnthropicBetaDevFullThinking2025_05_14 AnthropicBeta = "dev-full-thinking-2025-05-14"` - - - `const AnthropicBetaInterleavedThinking2025_05_14 AnthropicBeta = "interleaved-thinking-2025-05-14"` - - - `const AnthropicBetaCodeExecution2025_05_22 AnthropicBeta = "code-execution-2025-05-22"` - - - `const AnthropicBetaExtendedCacheTTL2025_04_11 AnthropicBeta = "extended-cache-ttl-2025-04-11"` - - - `const AnthropicBetaContext1m2025_08_07 AnthropicBeta = "context-1m-2025-08-07"` - - - `const AnthropicBetaContextManagement2025_06_27 AnthropicBeta = "context-management-2025-06-27"` - - - `const AnthropicBetaModelContextWindowExceeded2025_08_26 AnthropicBeta = "model-context-window-exceeded-2025-08-26"` - - - `const AnthropicBetaSkills2025_10_02 AnthropicBeta = "skills-2025-10-02"` - - - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + +### Returns + +- `type BetaMessageBatch struct{…}` + + - `ID string` + + Unique object identifier. + + The format and length of IDs may change over time. + + - `ArchivedAt Time` + + RFC 3339 datetime string representing the time at which the Message Batch was archived and its results became unavailable. + + - `CancelInitiatedAt Time` + + RFC 3339 datetime string representing the time at which cancellation was initiated for the Message Batch. Specified only if cancellation was initiated. + + - `CreatedAt Time` + + RFC 3339 datetime string representing the time at which the Message Batch was created. + + - `EndedAt Time` + + RFC 3339 datetime string representing the time at which processing for the Message Batch ended. Specified only once processing ends. + + Processing ends when every request in a Message Batch has either succeeded, errored, canceled, or expired. + + - `ExpiresAt Time` + + RFC 3339 datetime string representing the time at which the Message Batch will expire and end processing, which is 24 hours after creation. + + - `ProcessingStatus BetaMessageBatchProcessingStatus` + + Processing status of the Message Batch. + + - `const BetaMessageBatchProcessingStatusInProgress BetaMessageBatchProcessingStatus = "in_progress"` + + - `const BetaMessageBatchProcessingStatusCanceling BetaMessageBatchProcessingStatus = "canceling"` + + - `const BetaMessageBatchProcessingStatusEnded BetaMessageBatchProcessingStatus = "ended"` + + - `RequestCounts BetaMessageBatchRequestCounts` + + Tallies requests within the Message Batch, categorized by their status. + + Requests start as `processing` and move to one of the other statuses only once processing of the entire batch ends. The sum of all values always matches the total number of requests in the batch. + + - `Canceled int64` + + Number of requests in the Message Batch that have been canceled. + + This is zero until processing of the entire Message Batch has ended. + + - `Errored int64` + + Number of requests in the Message Batch that encountered an error. + + This is zero until processing of the entire Message Batch has ended. + + - `Expired int64` + + Number of requests in the Message Batch that have expired. + + This is zero until processing of the entire Message Batch has ended. + + - `Processing int64` + + Number of requests in the Message Batch that are processing. + + - `Succeeded int64` + + Number of requests in the Message Batch that have completed successfully. + + This is zero until processing of the entire Message Batch has ended. + + - `ResultsURL string` + + URL to a `.jsonl` file containing the results of the Message Batch requests. Specified only once processing ends. + + Results in the file are not guaranteed to be in the same order as requests. Use the `custom_id` field to match results to requests. + + - `Type MessageBatch` + + Object type. + + For Message Batches, this is always `"message_batch"`. + + - `const MessageBatchMessageBatch MessageBatch = "message_batch"` + +### Example + +```go +package main + +import ( + "context" + "fmt" + + "github.com/anthropics/anthropic-sdk-go" + "github.com/anthropics/anthropic-sdk-go/option" +) + +func main() { + client := anthropic.NewClient( + option.WithAPIKey("my-anthropic-api-key"), + ) + page, err := client.Beta.Messages.Batches.List(context.TODO(), anthropic.BetaMessageBatchListParams{ + + }) + if err != nil { + panic(err.Error()) + } + fmt.Printf("%+v\n", page) +} +``` + +## Cancel + +`client.Beta.Messages.Batches.Cancel(ctx, messageBatchID, body) (*BetaMessageBatch, error)` + +**post** `/v1/messages/batches/{message_batch_id}/cancel` + +Batches may be canceled any time before processing ends. Once cancellation is initiated, the batch enters a `canceling` state, at which time the system may complete any in-progress, non-interruptible requests before finalizing cancellation. + +The number of canceled requests is specified in `request_counts`. To determine which requests were canceled, check the individual results within the batch. Note that cancellation may not result in any canceled requests if they were non-interruptible. + +Learn more about the Message Batches API in our [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing) + +### Parameters + +- `messageBatchID string` + + ID of the Message Batch. + +- `body BetaMessageBatchCancelParams` + + - `Betas param.Field[[]AnthropicBeta]` + + Optional header to specify the beta version(s) you want to use. + + - `string` + + - `type AnthropicBeta string` + + - `const AnthropicBetaMessageBatches2024_09_24 AnthropicBeta = "message-batches-2024-09-24"` + + - `const AnthropicBetaPromptCaching2024_07_31 AnthropicBeta = "prompt-caching-2024-07-31"` + + - `const AnthropicBetaComputerUse2024_10_22 AnthropicBeta = "computer-use-2024-10-22"` + + - `const AnthropicBetaComputerUse2025_01_24 AnthropicBeta = "computer-use-2025-01-24"` + + - `const AnthropicBetaPDFs2024_09_25 AnthropicBeta = "pdfs-2024-09-25"` + + - `const AnthropicBetaTokenCounting2024_11_01 AnthropicBeta = "token-counting-2024-11-01"` + + - `const AnthropicBetaTokenEfficientTools2025_02_19 AnthropicBeta = "token-efficient-tools-2025-02-19"` + + - `const AnthropicBetaOutput128k2025_02_19 AnthropicBeta = "output-128k-2025-02-19"` + + - `const AnthropicBetaFilesAPI2025_04_14 AnthropicBeta = "files-api-2025-04-14"` + + - `const AnthropicBetaMCPClient2025_04_04 AnthropicBeta = "mcp-client-2025-04-04"` + + - `const AnthropicBetaMCPClient2025_11_20 AnthropicBeta = "mcp-client-2025-11-20"` + + - `const AnthropicBetaDevFullThinking2025_05_14 AnthropicBeta = "dev-full-thinking-2025-05-14"` + + - `const AnthropicBetaInterleavedThinking2025_05_14 AnthropicBeta = "interleaved-thinking-2025-05-14"` + + - `const AnthropicBetaCodeExecution2025_05_22 AnthropicBeta = "code-execution-2025-05-22"` + + - `const AnthropicBetaExtendedCacheTTL2025_04_11 AnthropicBeta = "extended-cache-ttl-2025-04-11"` + + - `const AnthropicBetaContext1m2025_08_07 AnthropicBeta = "context-1m-2025-08-07"` + + - `const AnthropicBetaContextManagement2025_06_27 AnthropicBeta = "context-management-2025-06-27"` + + - `const AnthropicBetaModelContextWindowExceeded2025_08_26 AnthropicBeta = "model-context-window-exceeded-2025-08-26"` + + - `const AnthropicBetaSkills2025_10_02 AnthropicBeta = "skills-2025-10-02"` + + - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` ### Returns @@ -38955,6 +39169,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaDeletedMessageBatch struct{…}` @@ -39070,6 +39288,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaMessageBatchIndividualResponse struct{…}` @@ -40087,6 +40309,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails BetaRefusalStopDetails` + + Structured information about a refusal. + + - `Category BetaRefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const BetaRefusalStopDetailsCategoryCyber BetaRefusalStopDetailsCategory = "cyber"` + + - `const BetaRefusalStopDetailsCategoryBio BetaRefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason BetaStopReason` The reason that we stopped. @@ -41661,6 +41907,30 @@ func main() { - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails BetaRefusalStopDetails` + + Structured information about a refusal. + + - `Category BetaRefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const BetaRefusalStopDetailsCategoryCyber BetaRefusalStopDetailsCategory = "cyber"` + + - `const BetaRefusalStopDetailsCategoryBio BetaRefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason BetaStopReason` The reason that we stopped. @@ -43009,6 +43279,30 @@ func main() { - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails BetaRefusalStopDetails` + + Structured information about a refusal. + + - `Category BetaRefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const BetaRefusalStopDetailsCategoryCyber BetaRefusalStopDetailsCategory = "cyber"` + + - `const BetaRefusalStopDetailsCategoryBio BetaRefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason BetaStopReason` The reason that we stopped. @@ -44319,6 +44613,30 @@ func main() { - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails BetaRefusalStopDetails` + + Structured information about a refusal. + + - `Category BetaRefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const BetaRefusalStopDetailsCategoryCyber BetaRefusalStopDetailsCategory = "cyber"` + + - `const BetaRefusalStopDetailsCategoryBio BetaRefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason BetaStopReason` The reason that we stopped. @@ -44594,6 +44912,10 @@ Upload File - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type FileMetadata struct{…}` @@ -44735,6 +45057,10 @@ List Files - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type FileMetadata struct{…}` @@ -44864,6 +45190,10 @@ Download File - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaFileDownloadResponse interface{…}` @@ -44963,6 +45293,10 @@ Get File Metadata - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type FileMetadata struct{…}` @@ -45096,6 +45430,10 @@ Delete File - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type DeletedFile struct{…}` @@ -45273,6 +45611,10 @@ Create Skill - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaSkillNewResponse struct{…}` @@ -45426,6 +45768,10 @@ List Skills - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaSkillListResponse struct{…}` @@ -45564,6 +45910,10 @@ Get Skill - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaSkillGetResponse struct{…}` @@ -45706,6 +46056,10 @@ Delete Skill - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaSkillDeleteResponse struct{…}` @@ -45827,6 +46181,10 @@ Create Skill Version - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaSkillVersionNewResponse struct{…}` @@ -45982,6 +46340,10 @@ List Skill Versions - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaSkillVersionListResponse struct{…}` @@ -46133,6 +46495,10 @@ Get Skill Version - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaSkillVersionGetResponse struct{…}` @@ -46284,6 +46650,10 @@ Delete Skill Version - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaSkillVersionDeleteResponse struct{…}` @@ -46330,3 +46700,662 @@ func main() { fmt.Printf("%+v\n", version.ID) } ``` + +# User Profiles + +## Create + +`client.Beta.UserProfiles.New(ctx, params) (*BetaUserProfile, error)` + +**post** `/v1/user_profiles` + +Create User Profile + +### Parameters + +- `params BetaUserProfileNewParams` + + - `ExternalID param.Field[string]` + + Body param + + - `Metadata param.Field[map[string, string]]` + + Body param: Free-form key-value data to attach to this user profile. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. Values must be non-empty strings. + + - `Betas param.Field[[]AnthropicBeta]` + + Header param: Optional header to specify the beta version(s) you want to use. + + - `string` + + - `type AnthropicBeta string` + + - `const AnthropicBetaMessageBatches2024_09_24 AnthropicBeta = "message-batches-2024-09-24"` + + - `const AnthropicBetaPromptCaching2024_07_31 AnthropicBeta = "prompt-caching-2024-07-31"` + + - `const AnthropicBetaComputerUse2024_10_22 AnthropicBeta = "computer-use-2024-10-22"` + + - `const AnthropicBetaComputerUse2025_01_24 AnthropicBeta = "computer-use-2025-01-24"` + + - `const AnthropicBetaPDFs2024_09_25 AnthropicBeta = "pdfs-2024-09-25"` + + - `const AnthropicBetaTokenCounting2024_11_01 AnthropicBeta = "token-counting-2024-11-01"` + + - `const AnthropicBetaTokenEfficientTools2025_02_19 AnthropicBeta = "token-efficient-tools-2025-02-19"` + + - `const AnthropicBetaOutput128k2025_02_19 AnthropicBeta = "output-128k-2025-02-19"` + + - `const AnthropicBetaFilesAPI2025_04_14 AnthropicBeta = "files-api-2025-04-14"` + + - `const AnthropicBetaMCPClient2025_04_04 AnthropicBeta = "mcp-client-2025-04-04"` + + - `const AnthropicBetaMCPClient2025_11_20 AnthropicBeta = "mcp-client-2025-11-20"` + + - `const AnthropicBetaDevFullThinking2025_05_14 AnthropicBeta = "dev-full-thinking-2025-05-14"` + + - `const AnthropicBetaInterleavedThinking2025_05_14 AnthropicBeta = "interleaved-thinking-2025-05-14"` + + - `const AnthropicBetaCodeExecution2025_05_22 AnthropicBeta = "code-execution-2025-05-22"` + + - `const AnthropicBetaExtendedCacheTTL2025_04_11 AnthropicBeta = "extended-cache-ttl-2025-04-11"` + + - `const AnthropicBetaContext1m2025_08_07 AnthropicBeta = "context-1m-2025-08-07"` + + - `const AnthropicBetaContextManagement2025_06_27 AnthropicBeta = "context-management-2025-06-27"` + + - `const AnthropicBetaModelContextWindowExceeded2025_08_26 AnthropicBeta = "model-context-window-exceeded-2025-08-26"` + + - `const AnthropicBetaSkills2025_10_02 AnthropicBeta = "skills-2025-10-02"` + + - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + +### Returns + +- `type BetaUserProfile struct{…}` + + - `ID string` + + - `CreatedAt Time` + + A timestamp in RFC 3339 format + + - `Metadata map[string, string]` + + - `TrustGrants map[string, BetaUserProfileTrustGrant]` + + - `Status string` + + - `Type string` + + - `UpdatedAt Time` + + A timestamp in RFC 3339 format + + - `ExternalID string` + +### Example + +```go +package main + +import ( + "context" + "fmt" + + "github.com/anthropics/anthropic-sdk-go" + "github.com/anthropics/anthropic-sdk-go/option" +) + +func main() { + client := anthropic.NewClient( + option.WithAPIKey("my-anthropic-api-key"), + ) + betaUserProfile, err := client.Beta.UserProfiles.New(context.TODO(), anthropic.BetaUserProfileNewParams{ + + }) + if err != nil { + panic(err.Error()) + } + fmt.Printf("%+v\n", betaUserProfile.ID) +} +``` + +## List + +`client.Beta.UserProfiles.List(ctx, params) (*PageCursorV2[BetaUserProfile], error)` + +**get** `/v1/user_profiles` + +List User Profiles + +### Parameters + +- `params BetaUserProfileListParams` + + - `Limit param.Field[int64]` + + Query param: Query parameter for limit + + - `Order param.Field[BetaUserProfileListParamsOrder]` + + Query param: Query parameter for order + + - `const BetaUserProfileListParamsOrderAsc BetaUserProfileListParamsOrder = "asc"` + + - `const BetaUserProfileListParamsOrderDesc BetaUserProfileListParamsOrder = "desc"` + + - `Page param.Field[string]` + + Query param: Query parameter for page + + - `Betas param.Field[[]AnthropicBeta]` + + Header param: Optional header to specify the beta version(s) you want to use. + + - `string` + + - `type AnthropicBeta string` + + - `const AnthropicBetaMessageBatches2024_09_24 AnthropicBeta = "message-batches-2024-09-24"` + + - `const AnthropicBetaPromptCaching2024_07_31 AnthropicBeta = "prompt-caching-2024-07-31"` + + - `const AnthropicBetaComputerUse2024_10_22 AnthropicBeta = "computer-use-2024-10-22"` + + - `const AnthropicBetaComputerUse2025_01_24 AnthropicBeta = "computer-use-2025-01-24"` + + - `const AnthropicBetaPDFs2024_09_25 AnthropicBeta = "pdfs-2024-09-25"` + + - `const AnthropicBetaTokenCounting2024_11_01 AnthropicBeta = "token-counting-2024-11-01"` + + - `const AnthropicBetaTokenEfficientTools2025_02_19 AnthropicBeta = "token-efficient-tools-2025-02-19"` + + - `const AnthropicBetaOutput128k2025_02_19 AnthropicBeta = "output-128k-2025-02-19"` + + - `const AnthropicBetaFilesAPI2025_04_14 AnthropicBeta = "files-api-2025-04-14"` + + - `const AnthropicBetaMCPClient2025_04_04 AnthropicBeta = "mcp-client-2025-04-04"` + + - `const AnthropicBetaMCPClient2025_11_20 AnthropicBeta = "mcp-client-2025-11-20"` + + - `const AnthropicBetaDevFullThinking2025_05_14 AnthropicBeta = "dev-full-thinking-2025-05-14"` + + - `const AnthropicBetaInterleavedThinking2025_05_14 AnthropicBeta = "interleaved-thinking-2025-05-14"` + + - `const AnthropicBetaCodeExecution2025_05_22 AnthropicBeta = "code-execution-2025-05-22"` + + - `const AnthropicBetaExtendedCacheTTL2025_04_11 AnthropicBeta = "extended-cache-ttl-2025-04-11"` + + - `const AnthropicBetaContext1m2025_08_07 AnthropicBeta = "context-1m-2025-08-07"` + + - `const AnthropicBetaContextManagement2025_06_27 AnthropicBeta = "context-management-2025-06-27"` + + - `const AnthropicBetaModelContextWindowExceeded2025_08_26 AnthropicBeta = "model-context-window-exceeded-2025-08-26"` + + - `const AnthropicBetaSkills2025_10_02 AnthropicBeta = "skills-2025-10-02"` + + - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + +### Returns + +- `type BetaUserProfile struct{…}` + + - `ID string` + + - `CreatedAt Time` + + A timestamp in RFC 3339 format + + - `Metadata map[string, string]` + + - `TrustGrants map[string, BetaUserProfileTrustGrant]` + + - `Status string` + + - `Type string` + + - `UpdatedAt Time` + + A timestamp in RFC 3339 format + + - `ExternalID string` + +### Example + +```go +package main + +import ( + "context" + "fmt" + + "github.com/anthropics/anthropic-sdk-go" + "github.com/anthropics/anthropic-sdk-go/option" +) + +func main() { + client := anthropic.NewClient( + option.WithAPIKey("my-anthropic-api-key"), + ) + page, err := client.Beta.UserProfiles.List(context.TODO(), anthropic.BetaUserProfileListParams{ + + }) + if err != nil { + panic(err.Error()) + } + fmt.Printf("%+v\n", page) +} +``` + +## Retrieve + +`client.Beta.UserProfiles.Get(ctx, id, query) (*BetaUserProfile, error)` + +**get** `/v1/user_profiles/{id}` + +Get User Profile + +### Parameters + +- `id string` + +- `query BetaUserProfileGetParams` + + - `Betas param.Field[[]AnthropicBeta]` + + Optional header to specify the beta version(s) you want to use. + + - `string` + + - `type AnthropicBeta string` + + - `const AnthropicBetaMessageBatches2024_09_24 AnthropicBeta = "message-batches-2024-09-24"` + + - `const AnthropicBetaPromptCaching2024_07_31 AnthropicBeta = "prompt-caching-2024-07-31"` + + - `const AnthropicBetaComputerUse2024_10_22 AnthropicBeta = "computer-use-2024-10-22"` + + - `const AnthropicBetaComputerUse2025_01_24 AnthropicBeta = "computer-use-2025-01-24"` + + - `const AnthropicBetaPDFs2024_09_25 AnthropicBeta = "pdfs-2024-09-25"` + + - `const AnthropicBetaTokenCounting2024_11_01 AnthropicBeta = "token-counting-2024-11-01"` + + - `const AnthropicBetaTokenEfficientTools2025_02_19 AnthropicBeta = "token-efficient-tools-2025-02-19"` + + - `const AnthropicBetaOutput128k2025_02_19 AnthropicBeta = "output-128k-2025-02-19"` + + - `const AnthropicBetaFilesAPI2025_04_14 AnthropicBeta = "files-api-2025-04-14"` + + - `const AnthropicBetaMCPClient2025_04_04 AnthropicBeta = "mcp-client-2025-04-04"` + + - `const AnthropicBetaMCPClient2025_11_20 AnthropicBeta = "mcp-client-2025-11-20"` + + - `const AnthropicBetaDevFullThinking2025_05_14 AnthropicBeta = "dev-full-thinking-2025-05-14"` + + - `const AnthropicBetaInterleavedThinking2025_05_14 AnthropicBeta = "interleaved-thinking-2025-05-14"` + + - `const AnthropicBetaCodeExecution2025_05_22 AnthropicBeta = "code-execution-2025-05-22"` + + - `const AnthropicBetaExtendedCacheTTL2025_04_11 AnthropicBeta = "extended-cache-ttl-2025-04-11"` + + - `const AnthropicBetaContext1m2025_08_07 AnthropicBeta = "context-1m-2025-08-07"` + + - `const AnthropicBetaContextManagement2025_06_27 AnthropicBeta = "context-management-2025-06-27"` + + - `const AnthropicBetaModelContextWindowExceeded2025_08_26 AnthropicBeta = "model-context-window-exceeded-2025-08-26"` + + - `const AnthropicBetaSkills2025_10_02 AnthropicBeta = "skills-2025-10-02"` + + - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + +### Returns + +- `type BetaUserProfile struct{…}` + + - `ID string` + + - `CreatedAt Time` + + A timestamp in RFC 3339 format + + - `Metadata map[string, string]` + + - `TrustGrants map[string, BetaUserProfileTrustGrant]` + + - `Status string` + + - `Type string` + + - `UpdatedAt Time` + + A timestamp in RFC 3339 format + + - `ExternalID string` + +### Example + +```go +package main + +import ( + "context" + "fmt" + + "github.com/anthropics/anthropic-sdk-go" + "github.com/anthropics/anthropic-sdk-go/option" +) + +func main() { + client := anthropic.NewClient( + option.WithAPIKey("my-anthropic-api-key"), + ) + betaUserProfile, err := client.Beta.UserProfiles.Get( + context.TODO(), + "id", + anthropic.BetaUserProfileGetParams{ + + }, + ) + if err != nil { + panic(err.Error()) + } + fmt.Printf("%+v\n", betaUserProfile.ID) +} +``` + +## Update + +`client.Beta.UserProfiles.Update(ctx, id, params) (*BetaUserProfile, error)` + +**post** `/v1/user_profiles/{id}` + +Update User Profile + +### Parameters + +- `id string` + +- `params BetaUserProfileUpdateParams` + + - `ExternalID param.Field[string]` + + Body param + + - `Metadata param.Field[map[string, string]]` + + Body param: Key-value pairs to merge into the stored metadata. Keys provided overwrite existing values. To remove a key, set its value to an empty string. Keys not provided are left unchanged. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. + + - `Betas param.Field[[]AnthropicBeta]` + + Header param: Optional header to specify the beta version(s) you want to use. + + - `string` + + - `type AnthropicBeta string` + + - `const AnthropicBetaMessageBatches2024_09_24 AnthropicBeta = "message-batches-2024-09-24"` + + - `const AnthropicBetaPromptCaching2024_07_31 AnthropicBeta = "prompt-caching-2024-07-31"` + + - `const AnthropicBetaComputerUse2024_10_22 AnthropicBeta = "computer-use-2024-10-22"` + + - `const AnthropicBetaComputerUse2025_01_24 AnthropicBeta = "computer-use-2025-01-24"` + + - `const AnthropicBetaPDFs2024_09_25 AnthropicBeta = "pdfs-2024-09-25"` + + - `const AnthropicBetaTokenCounting2024_11_01 AnthropicBeta = "token-counting-2024-11-01"` + + - `const AnthropicBetaTokenEfficientTools2025_02_19 AnthropicBeta = "token-efficient-tools-2025-02-19"` + + - `const AnthropicBetaOutput128k2025_02_19 AnthropicBeta = "output-128k-2025-02-19"` + + - `const AnthropicBetaFilesAPI2025_04_14 AnthropicBeta = "files-api-2025-04-14"` + + - `const AnthropicBetaMCPClient2025_04_04 AnthropicBeta = "mcp-client-2025-04-04"` + + - `const AnthropicBetaMCPClient2025_11_20 AnthropicBeta = "mcp-client-2025-11-20"` + + - `const AnthropicBetaDevFullThinking2025_05_14 AnthropicBeta = "dev-full-thinking-2025-05-14"` + + - `const AnthropicBetaInterleavedThinking2025_05_14 AnthropicBeta = "interleaved-thinking-2025-05-14"` + + - `const AnthropicBetaCodeExecution2025_05_22 AnthropicBeta = "code-execution-2025-05-22"` + + - `const AnthropicBetaExtendedCacheTTL2025_04_11 AnthropicBeta = "extended-cache-ttl-2025-04-11"` + + - `const AnthropicBetaContext1m2025_08_07 AnthropicBeta = "context-1m-2025-08-07"` + + - `const AnthropicBetaContextManagement2025_06_27 AnthropicBeta = "context-management-2025-06-27"` + + - `const AnthropicBetaModelContextWindowExceeded2025_08_26 AnthropicBeta = "model-context-window-exceeded-2025-08-26"` + + - `const AnthropicBetaSkills2025_10_02 AnthropicBeta = "skills-2025-10-02"` + + - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + +### Returns + +- `type BetaUserProfile struct{…}` + + - `ID string` + + - `CreatedAt Time` + + A timestamp in RFC 3339 format + + - `Metadata map[string, string]` + + - `TrustGrants map[string, BetaUserProfileTrustGrant]` + + - `Status string` + + - `Type string` + + - `UpdatedAt Time` + + A timestamp in RFC 3339 format + + - `ExternalID string` + +### Example + +```go +package main + +import ( + "context" + "fmt" + + "github.com/anthropics/anthropic-sdk-go" + "github.com/anthropics/anthropic-sdk-go/option" +) + +func main() { + client := anthropic.NewClient( + option.WithAPIKey("my-anthropic-api-key"), + ) + betaUserProfile, err := client.Beta.UserProfiles.Update( + context.TODO(), + "id", + anthropic.BetaUserProfileUpdateParams{ + + }, + ) + if err != nil { + panic(err.Error()) + } + fmt.Printf("%+v\n", betaUserProfile.ID) +} +``` + +## Create Enrollment URL + +`client.Beta.UserProfiles.NewEnrollmentURL(ctx, id, body) (*BetaUserProfileEnrollmentURL, error)` + +**post** `/v1/user_profiles/{id}/enrollment_url` + +Create Enrollment URL + +### Parameters + +- `id string` + +- `body BetaUserProfileNewEnrollmentURLParams` + + - `Betas param.Field[[]AnthropicBeta]` + + Optional header to specify the beta version(s) you want to use. + + - `string` + + - `type AnthropicBeta string` + + - `const AnthropicBetaMessageBatches2024_09_24 AnthropicBeta = "message-batches-2024-09-24"` + + - `const AnthropicBetaPromptCaching2024_07_31 AnthropicBeta = "prompt-caching-2024-07-31"` + + - `const AnthropicBetaComputerUse2024_10_22 AnthropicBeta = "computer-use-2024-10-22"` + + - `const AnthropicBetaComputerUse2025_01_24 AnthropicBeta = "computer-use-2025-01-24"` + + - `const AnthropicBetaPDFs2024_09_25 AnthropicBeta = "pdfs-2024-09-25"` + + - `const AnthropicBetaTokenCounting2024_11_01 AnthropicBeta = "token-counting-2024-11-01"` + + - `const AnthropicBetaTokenEfficientTools2025_02_19 AnthropicBeta = "token-efficient-tools-2025-02-19"` + + - `const AnthropicBetaOutput128k2025_02_19 AnthropicBeta = "output-128k-2025-02-19"` + + - `const AnthropicBetaFilesAPI2025_04_14 AnthropicBeta = "files-api-2025-04-14"` + + - `const AnthropicBetaMCPClient2025_04_04 AnthropicBeta = "mcp-client-2025-04-04"` + + - `const AnthropicBetaMCPClient2025_11_20 AnthropicBeta = "mcp-client-2025-11-20"` + + - `const AnthropicBetaDevFullThinking2025_05_14 AnthropicBeta = "dev-full-thinking-2025-05-14"` + + - `const AnthropicBetaInterleavedThinking2025_05_14 AnthropicBeta = "interleaved-thinking-2025-05-14"` + + - `const AnthropicBetaCodeExecution2025_05_22 AnthropicBeta = "code-execution-2025-05-22"` + + - `const AnthropicBetaExtendedCacheTTL2025_04_11 AnthropicBeta = "extended-cache-ttl-2025-04-11"` + + - `const AnthropicBetaContext1m2025_08_07 AnthropicBeta = "context-1m-2025-08-07"` + + - `const AnthropicBetaContextManagement2025_06_27 AnthropicBeta = "context-management-2025-06-27"` + + - `const AnthropicBetaModelContextWindowExceeded2025_08_26 AnthropicBeta = "model-context-window-exceeded-2025-08-26"` + + - `const AnthropicBetaSkills2025_10_02 AnthropicBeta = "skills-2025-10-02"` + + - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + +### Returns + +- `type BetaUserProfileEnrollmentURL struct{…}` + + - `ExpiresAt Time` + + A timestamp in RFC 3339 format + + - `Type string` + + - `URL string` + +### Example + +```go +package main + +import ( + "context" + "fmt" + + "github.com/anthropics/anthropic-sdk-go" + "github.com/anthropics/anthropic-sdk-go/option" +) + +func main() { + client := anthropic.NewClient( + option.WithAPIKey("my-anthropic-api-key"), + ) + betaUserProfileEnrollmentURL, err := client.Beta.UserProfiles.NewEnrollmentURL( + context.TODO(), + "id", + anthropic.BetaUserProfileNewEnrollmentURLParams{ + + }, + ) + if err != nil { + panic(err.Error()) + } + fmt.Printf("%+v\n", betaUserProfileEnrollmentURL.ExpiresAt) +} +``` + +## Domain Types + +### Beta User Profile + +- `type BetaUserProfile struct{…}` + + - `ID string` + + - `CreatedAt Time` + + A timestamp in RFC 3339 format + + - `Metadata map[string, string]` + + - `TrustGrants map[string, BetaUserProfileTrustGrant]` + + - `Status string` + + - `Type string` + + - `UpdatedAt Time` + + A timestamp in RFC 3339 format + + - `ExternalID string` + +### Beta User Profile Enrollment URL + +- `type BetaUserProfileEnrollmentURL struct{…}` + + - `ExpiresAt Time` + + A timestamp in RFC 3339 format + + - `Type string` + + - `URL string` + +### Beta User Profile Trust Grant + +- `type BetaUserProfileTrustGrant struct{…}` + + - `Status string` diff --git a/content/en/api/go/beta/files.md b/content/en/api/go/beta/files.md index d94a72715..43ad241f9 100644 --- a/content/en/api/go/beta/files.md +++ b/content/en/api/go/beta/files.md @@ -64,6 +64,10 @@ Upload File - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type FileMetadata struct{…}` @@ -205,6 +209,10 @@ List Files - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type FileMetadata struct{…}` @@ -334,6 +342,10 @@ Download File - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaFileDownloadResponse interface{…}` @@ -433,6 +445,10 @@ Get File Metadata - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type FileMetadata struct{…}` @@ -566,6 +582,10 @@ Delete File - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type DeletedFile struct{…}` diff --git a/content/en/api/go/beta/files/delete.md b/content/en/api/go/beta/files/delete.md index 6a68c4c3a..fa30d0218 100644 --- a/content/en/api/go/beta/files/delete.md +++ b/content/en/api/go/beta/files/delete.md @@ -62,6 +62,10 @@ Delete File - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type DeletedFile struct{…}` diff --git a/content/en/api/go/beta/files/download.md b/content/en/api/go/beta/files/download.md index 0391a35c9..bed6d1295 100644 --- a/content/en/api/go/beta/files/download.md +++ b/content/en/api/go/beta/files/download.md @@ -62,6 +62,10 @@ Download File - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaFileDownloadResponse interface{…}` diff --git a/content/en/api/go/beta/files/list.md b/content/en/api/go/beta/files/list.md index f3b443578..4d5e2250e 100644 --- a/content/en/api/go/beta/files/list.md +++ b/content/en/api/go/beta/files/list.md @@ -72,6 +72,10 @@ List Files - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type FileMetadata struct{…}` diff --git a/content/en/api/go/beta/files/retrieve_metadata.md b/content/en/api/go/beta/files/retrieve_metadata.md index 9fa573345..3d71ea0a3 100644 --- a/content/en/api/go/beta/files/retrieve_metadata.md +++ b/content/en/api/go/beta/files/retrieve_metadata.md @@ -62,6 +62,10 @@ Get File Metadata - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type FileMetadata struct{…}` diff --git a/content/en/api/go/beta/files/upload.md b/content/en/api/go/beta/files/upload.md index b6e22c527..e7886123e 100644 --- a/content/en/api/go/beta/files/upload.md +++ b/content/en/api/go/beta/files/upload.md @@ -62,6 +62,10 @@ Upload File - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type FileMetadata struct{…}` diff --git a/content/en/api/go/beta/messages.md b/content/en/api/go/beta/messages.md index 56d17664b..bfaa98b05 100644 --- a/content/en/api/go/beta/messages.md +++ b/content/en/api/go/beta/messages.md @@ -4331,6 +4331,10 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en Recommended for advanced use cases only. You usually only need to use `temperature`. + - `UserProfileID param.Field[string]` + + Body param: The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + - `Betas param.Field[[]AnthropicBeta]` Header param: Optional header to specify the beta version(s) you want to use. @@ -4379,6 +4383,10 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaMessage struct{…}` @@ -5378,6 +5386,30 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails BetaRefusalStopDetails` + + Structured information about a refusal. + + - `Category BetaRefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const BetaRefusalStopDetailsCategoryCyber BetaRefusalStopDetailsCategory = "cyber"` + + - `const BetaRefusalStopDetailsCategoryBio BetaRefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason BetaStopReason` The reason that we stopped. @@ -9906,6 +9938,10 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaMessageTokensCount struct{…}` @@ -17216,6 +17252,30 @@ func main() { - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails BetaRefusalStopDetails` + + Structured information about a refusal. + + - `Category BetaRefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const BetaRefusalStopDetailsCategoryCyber BetaRefusalStopDetailsCategory = "cyber"` + + - `const BetaRefusalStopDetailsCategoryBio BetaRefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason BetaStopReason` The reason that we stopped. @@ -21357,6 +21417,30 @@ func main() { Skill version or 'latest' for most recent version + - `StopDetails BetaRefusalStopDetails` + + Structured information about a refusal. + + - `Category BetaRefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const BetaRefusalStopDetailsCategoryCyber BetaRefusalStopDetailsCategory = "cyber"` + + - `const BetaRefusalStopDetailsCategoryBio BetaRefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason BetaStopReason` - `const BetaStopReasonEndTurn BetaStopReason = "end_turn"` @@ -22508,6 +22592,30 @@ func main() { - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails BetaRefusalStopDetails` + + Structured information about a refusal. + + - `Category BetaRefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const BetaRefusalStopDetailsCategoryCyber BetaRefusalStopDetailsCategory = "cyber"` + + - `const BetaRefusalStopDetailsCategoryBio BetaRefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason BetaStopReason` The reason that we stopped. @@ -23728,6 +23836,30 @@ func main() { - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails BetaRefusalStopDetails` + + Structured information about a refusal. + + - `Category BetaRefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const BetaRefusalStopDetailsCategoryCyber BetaRefusalStopDetailsCategory = "cyber"` + + - `const BetaRefusalStopDetailsCategoryBio BetaRefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason BetaStopReason` The reason that we stopped. @@ -24013,6 +24145,30 @@ func main() { Skill version or 'latest' for most recent version + - `StopDetails BetaRefusalStopDetails` + + Structured information about a refusal. + + - `Category BetaRefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const BetaRefusalStopDetailsCategoryCyber BetaRefusalStopDetailsCategory = "cyber"` + + - `const BetaRefusalStopDetailsCategoryBio BetaRefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason BetaStopReason` - `const BetaStopReasonEndTurn BetaStopReason = "end_turn"` @@ -25157,6 +25313,32 @@ func main() { - `const RedactedThinkingRedactedThinking RedactedThinking = "redacted_thinking"` +### Beta Refusal Stop Details + +- `type BetaRefusalStopDetails struct{…}` + + Structured information about a refusal. + + - `Category BetaRefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const BetaRefusalStopDetailsCategoryCyber BetaRefusalStopDetailsCategory = "cyber"` + + - `const BetaRefusalStopDetailsCategoryBio BetaRefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + ### Beta Request Document Block - `type BetaRequestDocumentBlock struct{…}` @@ -36789,6 +36971,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Recommended for advanced use cases only. You usually only need to use `temperature`. + - `UserProfileID string` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + - `Betas param.Field[[]AnthropicBeta]` Header param: Optional header to specify the beta version(s) you want to use. @@ -36837,6 +37023,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaMessageBatch struct{…}` @@ -37034,6 +37224,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaMessageBatch struct{…}` @@ -37231,6 +37425,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaMessageBatch struct{…}` @@ -37416,6 +37614,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaMessageBatch struct{…}` @@ -37605,6 +37807,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaDeletedMessageBatch struct{…}` @@ -37720,6 +37926,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaMessageBatchIndividualResponse struct{…}` @@ -38737,6 +38947,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails BetaRefusalStopDetails` + + Structured information about a refusal. + + - `Category BetaRefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const BetaRefusalStopDetailsCategoryCyber BetaRefusalStopDetailsCategory = "cyber"` + + - `const BetaRefusalStopDetailsCategoryBio BetaRefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason BetaStopReason` The reason that we stopped. @@ -40311,6 +40545,30 @@ func main() { - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails BetaRefusalStopDetails` + + Structured information about a refusal. + + - `Category BetaRefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const BetaRefusalStopDetailsCategoryCyber BetaRefusalStopDetailsCategory = "cyber"` + + - `const BetaRefusalStopDetailsCategoryBio BetaRefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason BetaStopReason` The reason that we stopped. @@ -41659,6 +41917,30 @@ func main() { - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails BetaRefusalStopDetails` + + Structured information about a refusal. + + - `Category BetaRefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const BetaRefusalStopDetailsCategoryCyber BetaRefusalStopDetailsCategory = "cyber"` + + - `const BetaRefusalStopDetailsCategoryBio BetaRefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason BetaStopReason` The reason that we stopped. @@ -42969,6 +43251,30 @@ func main() { - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails BetaRefusalStopDetails` + + Structured information about a refusal. + + - `Category BetaRefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const BetaRefusalStopDetailsCategoryCyber BetaRefusalStopDetailsCategory = "cyber"` + + - `const BetaRefusalStopDetailsCategoryBio BetaRefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason BetaStopReason` The reason that we stopped. diff --git a/content/en/api/go/beta/messages/batches.md b/content/en/api/go/beta/messages/batches.md index bd864e592..4df802bbe 100644 --- a/content/en/api/go/beta/messages/batches.md +++ b/content/en/api/go/beta/messages/batches.md @@ -4688,6 +4688,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Recommended for advanced use cases only. You usually only need to use `temperature`. + - `UserProfileID string` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + - `Betas param.Field[[]AnthropicBeta]` Header param: Optional header to specify the beta version(s) you want to use. @@ -4736,6 +4740,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaMessageBatch struct{…}` @@ -4933,6 +4941,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaMessageBatch struct{…}` @@ -5130,6 +5142,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaMessageBatch struct{…}` @@ -5315,6 +5331,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaMessageBatch struct{…}` @@ -5504,6 +5524,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaDeletedMessageBatch struct{…}` @@ -5619,6 +5643,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaMessageBatchIndividualResponse struct{…}` @@ -6636,6 +6664,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails BetaRefusalStopDetails` + + Structured information about a refusal. + + - `Category BetaRefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const BetaRefusalStopDetailsCategoryCyber BetaRefusalStopDetailsCategory = "cyber"` + + - `const BetaRefusalStopDetailsCategoryBio BetaRefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason BetaStopReason` The reason that we stopped. @@ -8210,6 +8262,30 @@ func main() { - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails BetaRefusalStopDetails` + + Structured information about a refusal. + + - `Category BetaRefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const BetaRefusalStopDetailsCategoryCyber BetaRefusalStopDetailsCategory = "cyber"` + + - `const BetaRefusalStopDetailsCategoryBio BetaRefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason BetaStopReason` The reason that we stopped. @@ -9558,6 +9634,30 @@ func main() { - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails BetaRefusalStopDetails` + + Structured information about a refusal. + + - `Category BetaRefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const BetaRefusalStopDetailsCategoryCyber BetaRefusalStopDetailsCategory = "cyber"` + + - `const BetaRefusalStopDetailsCategoryBio BetaRefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason BetaStopReason` The reason that we stopped. @@ -10868,6 +10968,30 @@ func main() { - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails BetaRefusalStopDetails` + + Structured information about a refusal. + + - `Category BetaRefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const BetaRefusalStopDetailsCategoryCyber BetaRefusalStopDetailsCategory = "cyber"` + + - `const BetaRefusalStopDetailsCategoryBio BetaRefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason BetaStopReason` The reason that we stopped. diff --git a/content/en/api/go/beta/messages/batches/cancel.md b/content/en/api/go/beta/messages/batches/cancel.md index 7d86abcb9..2501ff86e 100644 --- a/content/en/api/go/beta/messages/batches/cancel.md +++ b/content/en/api/go/beta/messages/batches/cancel.md @@ -66,6 +66,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaMessageBatch struct{…}` diff --git a/content/en/api/go/beta/messages/batches/create.md b/content/en/api/go/beta/messages/batches/create.md index 4f8b20c6d..f0d53bb45 100644 --- a/content/en/api/go/beta/messages/batches/create.md +++ b/content/en/api/go/beta/messages/batches/create.md @@ -4686,6 +4686,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Recommended for advanced use cases only. You usually only need to use `temperature`. + - `UserProfileID string` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + - `Betas param.Field[[]AnthropicBeta]` Header param: Optional header to specify the beta version(s) you want to use. @@ -4734,6 +4738,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaMessageBatch struct{…}` diff --git a/content/en/api/go/beta/messages/batches/delete.md b/content/en/api/go/beta/messages/batches/delete.md index 793801c7c..5ed4a2d2e 100644 --- a/content/en/api/go/beta/messages/batches/delete.md +++ b/content/en/api/go/beta/messages/batches/delete.md @@ -66,6 +66,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaDeletedMessageBatch struct{…}` diff --git a/content/en/api/go/beta/messages/batches/list.md b/content/en/api/go/beta/messages/batches/list.md index c19a48469..645e402a0 100644 --- a/content/en/api/go/beta/messages/batches/list.md +++ b/content/en/api/go/beta/messages/batches/list.md @@ -74,6 +74,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaMessageBatch struct{…}` diff --git a/content/en/api/go/beta/messages/batches/results.md b/content/en/api/go/beta/messages/batches/results.md index 8cc8eadad..238d86746 100644 --- a/content/en/api/go/beta/messages/batches/results.md +++ b/content/en/api/go/beta/messages/batches/results.md @@ -66,6 +66,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaMessageBatchIndividualResponse struct{…}` @@ -1083,6 +1087,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails BetaRefusalStopDetails` + + Structured information about a refusal. + + - `Category BetaRefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const BetaRefusalStopDetailsCategoryCyber BetaRefusalStopDetailsCategory = "cyber"` + + - `const BetaRefusalStopDetailsCategoryBio BetaRefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason BetaStopReason` The reason that we stopped. diff --git a/content/en/api/go/beta/messages/batches/retrieve.md b/content/en/api/go/beta/messages/batches/retrieve.md index 4d2bb8cb8..e88f7a42d 100644 --- a/content/en/api/go/beta/messages/batches/retrieve.md +++ b/content/en/api/go/beta/messages/batches/retrieve.md @@ -64,6 +64,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaMessageBatch struct{…}` diff --git a/content/en/api/go/beta/messages/count_tokens.md b/content/en/api/go/beta/messages/count_tokens.md index 350ccd52e..c68362934 100644 --- a/content/en/api/go/beta/messages/count_tokens.md +++ b/content/en/api/go/beta/messages/count_tokens.md @@ -4285,6 +4285,10 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaMessageTokensCount struct{…}` diff --git a/content/en/api/go/beta/messages/create.md b/content/en/api/go/beta/messages/create.md index 18bdc1382..e8778c7aa 100644 --- a/content/en/api/go/beta/messages/create.md +++ b/content/en/api/go/beta/messages/create.md @@ -4329,6 +4329,10 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en Recommended for advanced use cases only. You usually only need to use `temperature`. + - `UserProfileID param.Field[string]` + + Body param: The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + - `Betas param.Field[[]AnthropicBeta]` Header param: Optional header to specify the beta version(s) you want to use. @@ -4377,6 +4381,10 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaMessage struct{…}` @@ -5376,6 +5384,30 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails BetaRefusalStopDetails` + + Structured information about a refusal. + + - `Category BetaRefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const BetaRefusalStopDetailsCategoryCyber BetaRefusalStopDetailsCategory = "cyber"` + + - `const BetaRefusalStopDetailsCategoryBio BetaRefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason BetaStopReason` The reason that we stopped. diff --git a/content/en/api/go/beta/models.md b/content/en/api/go/beta/models.md index 508ac8163..d8956f5a7 100644 --- a/content/en/api/go/beta/models.md +++ b/content/en/api/go/beta/models.md @@ -76,6 +76,10 @@ The Models API response can be used to determine which models are available for - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaModelInfo struct{…}` @@ -353,6 +357,10 @@ The Models API response can be used to determine information about a specific mo - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaModelInfo struct{…}` diff --git a/content/en/api/go/beta/models/list.md b/content/en/api/go/beta/models/list.md index 8e13c1481..c5a5b8051 100644 --- a/content/en/api/go/beta/models/list.md +++ b/content/en/api/go/beta/models/list.md @@ -74,6 +74,10 @@ The Models API response can be used to determine which models are available for - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaModelInfo struct{…}` diff --git a/content/en/api/go/beta/models/retrieve.md b/content/en/api/go/beta/models/retrieve.md index 3470a3ff2..f438e496a 100644 --- a/content/en/api/go/beta/models/retrieve.md +++ b/content/en/api/go/beta/models/retrieve.md @@ -64,6 +64,10 @@ The Models API response can be used to determine information about a specific mo - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaModelInfo struct{…}` diff --git a/content/en/api/go/beta/skills.md b/content/en/api/go/beta/skills.md index 293108aa9..e104f2dd6 100644 --- a/content/en/api/go/beta/skills.md +++ b/content/en/api/go/beta/skills.md @@ -72,6 +72,10 @@ Create Skill - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaSkillNewResponse struct{…}` @@ -225,6 +229,10 @@ List Skills - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaSkillListResponse struct{…}` @@ -363,6 +371,10 @@ Get Skill - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaSkillGetResponse struct{…}` @@ -505,6 +517,10 @@ Delete Skill - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaSkillDeleteResponse struct{…}` @@ -626,6 +642,10 @@ Create Skill Version - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaSkillVersionNewResponse struct{…}` @@ -781,6 +801,10 @@ List Skill Versions - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaSkillVersionListResponse struct{…}` @@ -932,6 +956,10 @@ Get Skill Version - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaSkillVersionGetResponse struct{…}` @@ -1083,6 +1111,10 @@ Delete Skill Version - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaSkillVersionDeleteResponse struct{…}` diff --git a/content/en/api/go/beta/skills/create.md b/content/en/api/go/beta/skills/create.md index bd6669985..367ffa1e3 100644 --- a/content/en/api/go/beta/skills/create.md +++ b/content/en/api/go/beta/skills/create.md @@ -70,6 +70,10 @@ Create Skill - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaSkillNewResponse struct{…}` diff --git a/content/en/api/go/beta/skills/delete.md b/content/en/api/go/beta/skills/delete.md index 8764e078b..d63fefd3b 100644 --- a/content/en/api/go/beta/skills/delete.md +++ b/content/en/api/go/beta/skills/delete.md @@ -64,6 +64,10 @@ Delete Skill - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaSkillDeleteResponse struct{…}` diff --git a/content/en/api/go/beta/skills/list.md b/content/en/api/go/beta/skills/list.md index 450235dbf..cf9bb27de 100644 --- a/content/en/api/go/beta/skills/list.md +++ b/content/en/api/go/beta/skills/list.md @@ -79,6 +79,10 @@ List Skills - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaSkillListResponse struct{…}` diff --git a/content/en/api/go/beta/skills/retrieve.md b/content/en/api/go/beta/skills/retrieve.md index d58e2b60f..115d1ad55 100644 --- a/content/en/api/go/beta/skills/retrieve.md +++ b/content/en/api/go/beta/skills/retrieve.md @@ -64,6 +64,10 @@ Get Skill - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaSkillGetResponse struct{…}` diff --git a/content/en/api/go/beta/skills/versions.md b/content/en/api/go/beta/skills/versions.md index dc8e9391c..c59b92866 100644 --- a/content/en/api/go/beta/skills/versions.md +++ b/content/en/api/go/beta/skills/versions.md @@ -72,6 +72,10 @@ Create Skill Version - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaSkillVersionNewResponse struct{…}` @@ -227,6 +231,10 @@ List Skill Versions - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaSkillVersionListResponse struct{…}` @@ -378,6 +386,10 @@ Get Skill Version - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaSkillVersionGetResponse struct{…}` @@ -529,6 +541,10 @@ Delete Skill Version - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaSkillVersionDeleteResponse struct{…}` diff --git a/content/en/api/go/beta/skills/versions/create.md b/content/en/api/go/beta/skills/versions/create.md index fb0275723..3c339f30d 100644 --- a/content/en/api/go/beta/skills/versions/create.md +++ b/content/en/api/go/beta/skills/versions/create.md @@ -70,6 +70,10 @@ Create Skill Version - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaSkillVersionNewResponse struct{…}` diff --git a/content/en/api/go/beta/skills/versions/delete.md b/content/en/api/go/beta/skills/versions/delete.md index aa1c3a243..e7d734343 100644 --- a/content/en/api/go/beta/skills/versions/delete.md +++ b/content/en/api/go/beta/skills/versions/delete.md @@ -70,6 +70,10 @@ Delete Skill Version - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaSkillVersionDeleteResponse struct{…}` diff --git a/content/en/api/go/beta/skills/versions/list.md b/content/en/api/go/beta/skills/versions/list.md index 06d46e3e5..9d5920717 100644 --- a/content/en/api/go/beta/skills/versions/list.md +++ b/content/en/api/go/beta/skills/versions/list.md @@ -74,6 +74,10 @@ List Skill Versions - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaSkillVersionListResponse struct{…}` diff --git a/content/en/api/go/beta/skills/versions/retrieve.md b/content/en/api/go/beta/skills/versions/retrieve.md index a68b14a24..c95d9c73b 100644 --- a/content/en/api/go/beta/skills/versions/retrieve.md +++ b/content/en/api/go/beta/skills/versions/retrieve.md @@ -70,6 +70,10 @@ Get Skill Version - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type BetaSkillVersionGetResponse struct{…}` diff --git a/content/en/api/go/beta/user_profiles.md b/content/en/api/go/beta/user_profiles.md new file mode 100644 index 000000000..415175e7c --- /dev/null +++ b/content/en/api/go/beta/user_profiles.md @@ -0,0 +1,658 @@ +# User Profiles + +## Create + +`client.Beta.UserProfiles.New(ctx, params) (*BetaUserProfile, error)` + +**post** `/v1/user_profiles` + +Create User Profile + +### Parameters + +- `params BetaUserProfileNewParams` + + - `ExternalID param.Field[string]` + + Body param + + - `Metadata param.Field[map[string, string]]` + + Body param: Free-form key-value data to attach to this user profile. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. Values must be non-empty strings. + + - `Betas param.Field[[]AnthropicBeta]` + + Header param: Optional header to specify the beta version(s) you want to use. + + - `string` + + - `type AnthropicBeta string` + + - `const AnthropicBetaMessageBatches2024_09_24 AnthropicBeta = "message-batches-2024-09-24"` + + - `const AnthropicBetaPromptCaching2024_07_31 AnthropicBeta = "prompt-caching-2024-07-31"` + + - `const AnthropicBetaComputerUse2024_10_22 AnthropicBeta = "computer-use-2024-10-22"` + + - `const AnthropicBetaComputerUse2025_01_24 AnthropicBeta = "computer-use-2025-01-24"` + + - `const AnthropicBetaPDFs2024_09_25 AnthropicBeta = "pdfs-2024-09-25"` + + - `const AnthropicBetaTokenCounting2024_11_01 AnthropicBeta = "token-counting-2024-11-01"` + + - `const AnthropicBetaTokenEfficientTools2025_02_19 AnthropicBeta = "token-efficient-tools-2025-02-19"` + + - `const AnthropicBetaOutput128k2025_02_19 AnthropicBeta = "output-128k-2025-02-19"` + + - `const AnthropicBetaFilesAPI2025_04_14 AnthropicBeta = "files-api-2025-04-14"` + + - `const AnthropicBetaMCPClient2025_04_04 AnthropicBeta = "mcp-client-2025-04-04"` + + - `const AnthropicBetaMCPClient2025_11_20 AnthropicBeta = "mcp-client-2025-11-20"` + + - `const AnthropicBetaDevFullThinking2025_05_14 AnthropicBeta = "dev-full-thinking-2025-05-14"` + + - `const AnthropicBetaInterleavedThinking2025_05_14 AnthropicBeta = "interleaved-thinking-2025-05-14"` + + - `const AnthropicBetaCodeExecution2025_05_22 AnthropicBeta = "code-execution-2025-05-22"` + + - `const AnthropicBetaExtendedCacheTTL2025_04_11 AnthropicBeta = "extended-cache-ttl-2025-04-11"` + + - `const AnthropicBetaContext1m2025_08_07 AnthropicBeta = "context-1m-2025-08-07"` + + - `const AnthropicBetaContextManagement2025_06_27 AnthropicBeta = "context-management-2025-06-27"` + + - `const AnthropicBetaModelContextWindowExceeded2025_08_26 AnthropicBeta = "model-context-window-exceeded-2025-08-26"` + + - `const AnthropicBetaSkills2025_10_02 AnthropicBeta = "skills-2025-10-02"` + + - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + +### Returns + +- `type BetaUserProfile struct{…}` + + - `ID string` + + - `CreatedAt Time` + + A timestamp in RFC 3339 format + + - `Metadata map[string, string]` + + - `TrustGrants map[string, BetaUserProfileTrustGrant]` + + - `Status string` + + - `Type string` + + - `UpdatedAt Time` + + A timestamp in RFC 3339 format + + - `ExternalID string` + +### Example + +```go +package main + +import ( + "context" + "fmt" + + "github.com/anthropics/anthropic-sdk-go" + "github.com/anthropics/anthropic-sdk-go/option" +) + +func main() { + client := anthropic.NewClient( + option.WithAPIKey("my-anthropic-api-key"), + ) + betaUserProfile, err := client.Beta.UserProfiles.New(context.TODO(), anthropic.BetaUserProfileNewParams{ + + }) + if err != nil { + panic(err.Error()) + } + fmt.Printf("%+v\n", betaUserProfile.ID) +} +``` + +## List + +`client.Beta.UserProfiles.List(ctx, params) (*PageCursorV2[BetaUserProfile], error)` + +**get** `/v1/user_profiles` + +List User Profiles + +### Parameters + +- `params BetaUserProfileListParams` + + - `Limit param.Field[int64]` + + Query param: Query parameter for limit + + - `Order param.Field[BetaUserProfileListParamsOrder]` + + Query param: Query parameter for order + + - `const BetaUserProfileListParamsOrderAsc BetaUserProfileListParamsOrder = "asc"` + + - `const BetaUserProfileListParamsOrderDesc BetaUserProfileListParamsOrder = "desc"` + + - `Page param.Field[string]` + + Query param: Query parameter for page + + - `Betas param.Field[[]AnthropicBeta]` + + Header param: Optional header to specify the beta version(s) you want to use. + + - `string` + + - `type AnthropicBeta string` + + - `const AnthropicBetaMessageBatches2024_09_24 AnthropicBeta = "message-batches-2024-09-24"` + + - `const AnthropicBetaPromptCaching2024_07_31 AnthropicBeta = "prompt-caching-2024-07-31"` + + - `const AnthropicBetaComputerUse2024_10_22 AnthropicBeta = "computer-use-2024-10-22"` + + - `const AnthropicBetaComputerUse2025_01_24 AnthropicBeta = "computer-use-2025-01-24"` + + - `const AnthropicBetaPDFs2024_09_25 AnthropicBeta = "pdfs-2024-09-25"` + + - `const AnthropicBetaTokenCounting2024_11_01 AnthropicBeta = "token-counting-2024-11-01"` + + - `const AnthropicBetaTokenEfficientTools2025_02_19 AnthropicBeta = "token-efficient-tools-2025-02-19"` + + - `const AnthropicBetaOutput128k2025_02_19 AnthropicBeta = "output-128k-2025-02-19"` + + - `const AnthropicBetaFilesAPI2025_04_14 AnthropicBeta = "files-api-2025-04-14"` + + - `const AnthropicBetaMCPClient2025_04_04 AnthropicBeta = "mcp-client-2025-04-04"` + + - `const AnthropicBetaMCPClient2025_11_20 AnthropicBeta = "mcp-client-2025-11-20"` + + - `const AnthropicBetaDevFullThinking2025_05_14 AnthropicBeta = "dev-full-thinking-2025-05-14"` + + - `const AnthropicBetaInterleavedThinking2025_05_14 AnthropicBeta = "interleaved-thinking-2025-05-14"` + + - `const AnthropicBetaCodeExecution2025_05_22 AnthropicBeta = "code-execution-2025-05-22"` + + - `const AnthropicBetaExtendedCacheTTL2025_04_11 AnthropicBeta = "extended-cache-ttl-2025-04-11"` + + - `const AnthropicBetaContext1m2025_08_07 AnthropicBeta = "context-1m-2025-08-07"` + + - `const AnthropicBetaContextManagement2025_06_27 AnthropicBeta = "context-management-2025-06-27"` + + - `const AnthropicBetaModelContextWindowExceeded2025_08_26 AnthropicBeta = "model-context-window-exceeded-2025-08-26"` + + - `const AnthropicBetaSkills2025_10_02 AnthropicBeta = "skills-2025-10-02"` + + - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + +### Returns + +- `type BetaUserProfile struct{…}` + + - `ID string` + + - `CreatedAt Time` + + A timestamp in RFC 3339 format + + - `Metadata map[string, string]` + + - `TrustGrants map[string, BetaUserProfileTrustGrant]` + + - `Status string` + + - `Type string` + + - `UpdatedAt Time` + + A timestamp in RFC 3339 format + + - `ExternalID string` + +### Example + +```go +package main + +import ( + "context" + "fmt" + + "github.com/anthropics/anthropic-sdk-go" + "github.com/anthropics/anthropic-sdk-go/option" +) + +func main() { + client := anthropic.NewClient( + option.WithAPIKey("my-anthropic-api-key"), + ) + page, err := client.Beta.UserProfiles.List(context.TODO(), anthropic.BetaUserProfileListParams{ + + }) + if err != nil { + panic(err.Error()) + } + fmt.Printf("%+v\n", page) +} +``` + +## Retrieve + +`client.Beta.UserProfiles.Get(ctx, id, query) (*BetaUserProfile, error)` + +**get** `/v1/user_profiles/{id}` + +Get User Profile + +### Parameters + +- `id string` + +- `query BetaUserProfileGetParams` + + - `Betas param.Field[[]AnthropicBeta]` + + Optional header to specify the beta version(s) you want to use. + + - `string` + + - `type AnthropicBeta string` + + - `const AnthropicBetaMessageBatches2024_09_24 AnthropicBeta = "message-batches-2024-09-24"` + + - `const AnthropicBetaPromptCaching2024_07_31 AnthropicBeta = "prompt-caching-2024-07-31"` + + - `const AnthropicBetaComputerUse2024_10_22 AnthropicBeta = "computer-use-2024-10-22"` + + - `const AnthropicBetaComputerUse2025_01_24 AnthropicBeta = "computer-use-2025-01-24"` + + - `const AnthropicBetaPDFs2024_09_25 AnthropicBeta = "pdfs-2024-09-25"` + + - `const AnthropicBetaTokenCounting2024_11_01 AnthropicBeta = "token-counting-2024-11-01"` + + - `const AnthropicBetaTokenEfficientTools2025_02_19 AnthropicBeta = "token-efficient-tools-2025-02-19"` + + - `const AnthropicBetaOutput128k2025_02_19 AnthropicBeta = "output-128k-2025-02-19"` + + - `const AnthropicBetaFilesAPI2025_04_14 AnthropicBeta = "files-api-2025-04-14"` + + - `const AnthropicBetaMCPClient2025_04_04 AnthropicBeta = "mcp-client-2025-04-04"` + + - `const AnthropicBetaMCPClient2025_11_20 AnthropicBeta = "mcp-client-2025-11-20"` + + - `const AnthropicBetaDevFullThinking2025_05_14 AnthropicBeta = "dev-full-thinking-2025-05-14"` + + - `const AnthropicBetaInterleavedThinking2025_05_14 AnthropicBeta = "interleaved-thinking-2025-05-14"` + + - `const AnthropicBetaCodeExecution2025_05_22 AnthropicBeta = "code-execution-2025-05-22"` + + - `const AnthropicBetaExtendedCacheTTL2025_04_11 AnthropicBeta = "extended-cache-ttl-2025-04-11"` + + - `const AnthropicBetaContext1m2025_08_07 AnthropicBeta = "context-1m-2025-08-07"` + + - `const AnthropicBetaContextManagement2025_06_27 AnthropicBeta = "context-management-2025-06-27"` + + - `const AnthropicBetaModelContextWindowExceeded2025_08_26 AnthropicBeta = "model-context-window-exceeded-2025-08-26"` + + - `const AnthropicBetaSkills2025_10_02 AnthropicBeta = "skills-2025-10-02"` + + - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + +### Returns + +- `type BetaUserProfile struct{…}` + + - `ID string` + + - `CreatedAt Time` + + A timestamp in RFC 3339 format + + - `Metadata map[string, string]` + + - `TrustGrants map[string, BetaUserProfileTrustGrant]` + + - `Status string` + + - `Type string` + + - `UpdatedAt Time` + + A timestamp in RFC 3339 format + + - `ExternalID string` + +### Example + +```go +package main + +import ( + "context" + "fmt" + + "github.com/anthropics/anthropic-sdk-go" + "github.com/anthropics/anthropic-sdk-go/option" +) + +func main() { + client := anthropic.NewClient( + option.WithAPIKey("my-anthropic-api-key"), + ) + betaUserProfile, err := client.Beta.UserProfiles.Get( + context.TODO(), + "id", + anthropic.BetaUserProfileGetParams{ + + }, + ) + if err != nil { + panic(err.Error()) + } + fmt.Printf("%+v\n", betaUserProfile.ID) +} +``` + +## Update + +`client.Beta.UserProfiles.Update(ctx, id, params) (*BetaUserProfile, error)` + +**post** `/v1/user_profiles/{id}` + +Update User Profile + +### Parameters + +- `id string` + +- `params BetaUserProfileUpdateParams` + + - `ExternalID param.Field[string]` + + Body param + + - `Metadata param.Field[map[string, string]]` + + Body param: Key-value pairs to merge into the stored metadata. Keys provided overwrite existing values. To remove a key, set its value to an empty string. Keys not provided are left unchanged. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. + + - `Betas param.Field[[]AnthropicBeta]` + + Header param: Optional header to specify the beta version(s) you want to use. + + - `string` + + - `type AnthropicBeta string` + + - `const AnthropicBetaMessageBatches2024_09_24 AnthropicBeta = "message-batches-2024-09-24"` + + - `const AnthropicBetaPromptCaching2024_07_31 AnthropicBeta = "prompt-caching-2024-07-31"` + + - `const AnthropicBetaComputerUse2024_10_22 AnthropicBeta = "computer-use-2024-10-22"` + + - `const AnthropicBetaComputerUse2025_01_24 AnthropicBeta = "computer-use-2025-01-24"` + + - `const AnthropicBetaPDFs2024_09_25 AnthropicBeta = "pdfs-2024-09-25"` + + - `const AnthropicBetaTokenCounting2024_11_01 AnthropicBeta = "token-counting-2024-11-01"` + + - `const AnthropicBetaTokenEfficientTools2025_02_19 AnthropicBeta = "token-efficient-tools-2025-02-19"` + + - `const AnthropicBetaOutput128k2025_02_19 AnthropicBeta = "output-128k-2025-02-19"` + + - `const AnthropicBetaFilesAPI2025_04_14 AnthropicBeta = "files-api-2025-04-14"` + + - `const AnthropicBetaMCPClient2025_04_04 AnthropicBeta = "mcp-client-2025-04-04"` + + - `const AnthropicBetaMCPClient2025_11_20 AnthropicBeta = "mcp-client-2025-11-20"` + + - `const AnthropicBetaDevFullThinking2025_05_14 AnthropicBeta = "dev-full-thinking-2025-05-14"` + + - `const AnthropicBetaInterleavedThinking2025_05_14 AnthropicBeta = "interleaved-thinking-2025-05-14"` + + - `const AnthropicBetaCodeExecution2025_05_22 AnthropicBeta = "code-execution-2025-05-22"` + + - `const AnthropicBetaExtendedCacheTTL2025_04_11 AnthropicBeta = "extended-cache-ttl-2025-04-11"` + + - `const AnthropicBetaContext1m2025_08_07 AnthropicBeta = "context-1m-2025-08-07"` + + - `const AnthropicBetaContextManagement2025_06_27 AnthropicBeta = "context-management-2025-06-27"` + + - `const AnthropicBetaModelContextWindowExceeded2025_08_26 AnthropicBeta = "model-context-window-exceeded-2025-08-26"` + + - `const AnthropicBetaSkills2025_10_02 AnthropicBeta = "skills-2025-10-02"` + + - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + +### Returns + +- `type BetaUserProfile struct{…}` + + - `ID string` + + - `CreatedAt Time` + + A timestamp in RFC 3339 format + + - `Metadata map[string, string]` + + - `TrustGrants map[string, BetaUserProfileTrustGrant]` + + - `Status string` + + - `Type string` + + - `UpdatedAt Time` + + A timestamp in RFC 3339 format + + - `ExternalID string` + +### Example + +```go +package main + +import ( + "context" + "fmt" + + "github.com/anthropics/anthropic-sdk-go" + "github.com/anthropics/anthropic-sdk-go/option" +) + +func main() { + client := anthropic.NewClient( + option.WithAPIKey("my-anthropic-api-key"), + ) + betaUserProfile, err := client.Beta.UserProfiles.Update( + context.TODO(), + "id", + anthropic.BetaUserProfileUpdateParams{ + + }, + ) + if err != nil { + panic(err.Error()) + } + fmt.Printf("%+v\n", betaUserProfile.ID) +} +``` + +## Create Enrollment URL + +`client.Beta.UserProfiles.NewEnrollmentURL(ctx, id, body) (*BetaUserProfileEnrollmentURL, error)` + +**post** `/v1/user_profiles/{id}/enrollment_url` + +Create Enrollment URL + +### Parameters + +- `id string` + +- `body BetaUserProfileNewEnrollmentURLParams` + + - `Betas param.Field[[]AnthropicBeta]` + + Optional header to specify the beta version(s) you want to use. + + - `string` + + - `type AnthropicBeta string` + + - `const AnthropicBetaMessageBatches2024_09_24 AnthropicBeta = "message-batches-2024-09-24"` + + - `const AnthropicBetaPromptCaching2024_07_31 AnthropicBeta = "prompt-caching-2024-07-31"` + + - `const AnthropicBetaComputerUse2024_10_22 AnthropicBeta = "computer-use-2024-10-22"` + + - `const AnthropicBetaComputerUse2025_01_24 AnthropicBeta = "computer-use-2025-01-24"` + + - `const AnthropicBetaPDFs2024_09_25 AnthropicBeta = "pdfs-2024-09-25"` + + - `const AnthropicBetaTokenCounting2024_11_01 AnthropicBeta = "token-counting-2024-11-01"` + + - `const AnthropicBetaTokenEfficientTools2025_02_19 AnthropicBeta = "token-efficient-tools-2025-02-19"` + + - `const AnthropicBetaOutput128k2025_02_19 AnthropicBeta = "output-128k-2025-02-19"` + + - `const AnthropicBetaFilesAPI2025_04_14 AnthropicBeta = "files-api-2025-04-14"` + + - `const AnthropicBetaMCPClient2025_04_04 AnthropicBeta = "mcp-client-2025-04-04"` + + - `const AnthropicBetaMCPClient2025_11_20 AnthropicBeta = "mcp-client-2025-11-20"` + + - `const AnthropicBetaDevFullThinking2025_05_14 AnthropicBeta = "dev-full-thinking-2025-05-14"` + + - `const AnthropicBetaInterleavedThinking2025_05_14 AnthropicBeta = "interleaved-thinking-2025-05-14"` + + - `const AnthropicBetaCodeExecution2025_05_22 AnthropicBeta = "code-execution-2025-05-22"` + + - `const AnthropicBetaExtendedCacheTTL2025_04_11 AnthropicBeta = "extended-cache-ttl-2025-04-11"` + + - `const AnthropicBetaContext1m2025_08_07 AnthropicBeta = "context-1m-2025-08-07"` + + - `const AnthropicBetaContextManagement2025_06_27 AnthropicBeta = "context-management-2025-06-27"` + + - `const AnthropicBetaModelContextWindowExceeded2025_08_26 AnthropicBeta = "model-context-window-exceeded-2025-08-26"` + + - `const AnthropicBetaSkills2025_10_02 AnthropicBeta = "skills-2025-10-02"` + + - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + +### Returns + +- `type BetaUserProfileEnrollmentURL struct{…}` + + - `ExpiresAt Time` + + A timestamp in RFC 3339 format + + - `Type string` + + - `URL string` + +### Example + +```go +package main + +import ( + "context" + "fmt" + + "github.com/anthropics/anthropic-sdk-go" + "github.com/anthropics/anthropic-sdk-go/option" +) + +func main() { + client := anthropic.NewClient( + option.WithAPIKey("my-anthropic-api-key"), + ) + betaUserProfileEnrollmentURL, err := client.Beta.UserProfiles.NewEnrollmentURL( + context.TODO(), + "id", + anthropic.BetaUserProfileNewEnrollmentURLParams{ + + }, + ) + if err != nil { + panic(err.Error()) + } + fmt.Printf("%+v\n", betaUserProfileEnrollmentURL.ExpiresAt) +} +``` + +## Domain Types + +### Beta User Profile + +- `type BetaUserProfile struct{…}` + + - `ID string` + + - `CreatedAt Time` + + A timestamp in RFC 3339 format + + - `Metadata map[string, string]` + + - `TrustGrants map[string, BetaUserProfileTrustGrant]` + + - `Status string` + + - `Type string` + + - `UpdatedAt Time` + + A timestamp in RFC 3339 format + + - `ExternalID string` + +### Beta User Profile Enrollment URL + +- `type BetaUserProfileEnrollmentURL struct{…}` + + - `ExpiresAt Time` + + A timestamp in RFC 3339 format + + - `Type string` + + - `URL string` + +### Beta User Profile Trust Grant + +- `type BetaUserProfileTrustGrant struct{…}` + + - `Status string` diff --git a/content/en/api/go/beta/user_profiles/create.md b/content/en/api/go/beta/user_profiles/create.md new file mode 100644 index 000000000..732858e78 --- /dev/null +++ b/content/en/api/go/beta/user_profiles/create.md @@ -0,0 +1,122 @@ +## Create + +`client.Beta.UserProfiles.New(ctx, params) (*BetaUserProfile, error)` + +**post** `/v1/user_profiles` + +Create User Profile + +### Parameters + +- `params BetaUserProfileNewParams` + + - `ExternalID param.Field[string]` + + Body param + + - `Metadata param.Field[map[string, string]]` + + Body param: Free-form key-value data to attach to this user profile. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. Values must be non-empty strings. + + - `Betas param.Field[[]AnthropicBeta]` + + Header param: Optional header to specify the beta version(s) you want to use. + + - `string` + + - `type AnthropicBeta string` + + - `const AnthropicBetaMessageBatches2024_09_24 AnthropicBeta = "message-batches-2024-09-24"` + + - `const AnthropicBetaPromptCaching2024_07_31 AnthropicBeta = "prompt-caching-2024-07-31"` + + - `const AnthropicBetaComputerUse2024_10_22 AnthropicBeta = "computer-use-2024-10-22"` + + - `const AnthropicBetaComputerUse2025_01_24 AnthropicBeta = "computer-use-2025-01-24"` + + - `const AnthropicBetaPDFs2024_09_25 AnthropicBeta = "pdfs-2024-09-25"` + + - `const AnthropicBetaTokenCounting2024_11_01 AnthropicBeta = "token-counting-2024-11-01"` + + - `const AnthropicBetaTokenEfficientTools2025_02_19 AnthropicBeta = "token-efficient-tools-2025-02-19"` + + - `const AnthropicBetaOutput128k2025_02_19 AnthropicBeta = "output-128k-2025-02-19"` + + - `const AnthropicBetaFilesAPI2025_04_14 AnthropicBeta = "files-api-2025-04-14"` + + - `const AnthropicBetaMCPClient2025_04_04 AnthropicBeta = "mcp-client-2025-04-04"` + + - `const AnthropicBetaMCPClient2025_11_20 AnthropicBeta = "mcp-client-2025-11-20"` + + - `const AnthropicBetaDevFullThinking2025_05_14 AnthropicBeta = "dev-full-thinking-2025-05-14"` + + - `const AnthropicBetaInterleavedThinking2025_05_14 AnthropicBeta = "interleaved-thinking-2025-05-14"` + + - `const AnthropicBetaCodeExecution2025_05_22 AnthropicBeta = "code-execution-2025-05-22"` + + - `const AnthropicBetaExtendedCacheTTL2025_04_11 AnthropicBeta = "extended-cache-ttl-2025-04-11"` + + - `const AnthropicBetaContext1m2025_08_07 AnthropicBeta = "context-1m-2025-08-07"` + + - `const AnthropicBetaContextManagement2025_06_27 AnthropicBeta = "context-management-2025-06-27"` + + - `const AnthropicBetaModelContextWindowExceeded2025_08_26 AnthropicBeta = "model-context-window-exceeded-2025-08-26"` + + - `const AnthropicBetaSkills2025_10_02 AnthropicBeta = "skills-2025-10-02"` + + - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + +### Returns + +- `type BetaUserProfile struct{…}` + + - `ID string` + + - `CreatedAt Time` + + A timestamp in RFC 3339 format + + - `Metadata map[string, string]` + + - `TrustGrants map[string, BetaUserProfileTrustGrant]` + + - `Status string` + + - `Type string` + + - `UpdatedAt Time` + + A timestamp in RFC 3339 format + + - `ExternalID string` + +### Example + +```go +package main + +import ( + "context" + "fmt" + + "github.com/anthropics/anthropic-sdk-go" + "github.com/anthropics/anthropic-sdk-go/option" +) + +func main() { + client := anthropic.NewClient( + option.WithAPIKey("my-anthropic-api-key"), + ) + betaUserProfile, err := client.Beta.UserProfiles.New(context.TODO(), anthropic.BetaUserProfileNewParams{ + + }) + if err != nil { + panic(err.Error()) + } + fmt.Printf("%+v\n", betaUserProfile.ID) +} +``` diff --git a/content/en/api/go/beta/user_profiles/create_enrollment_url.md b/content/en/api/go/beta/user_profiles/create_enrollment_url.md new file mode 100644 index 000000000..0c2613704 --- /dev/null +++ b/content/en/api/go/beta/user_profiles/create_enrollment_url.md @@ -0,0 +1,108 @@ +## Create Enrollment URL + +`client.Beta.UserProfiles.NewEnrollmentURL(ctx, id, body) (*BetaUserProfileEnrollmentURL, error)` + +**post** `/v1/user_profiles/{id}/enrollment_url` + +Create Enrollment URL + +### Parameters + +- `id string` + +- `body BetaUserProfileNewEnrollmentURLParams` + + - `Betas param.Field[[]AnthropicBeta]` + + Optional header to specify the beta version(s) you want to use. + + - `string` + + - `type AnthropicBeta string` + + - `const AnthropicBetaMessageBatches2024_09_24 AnthropicBeta = "message-batches-2024-09-24"` + + - `const AnthropicBetaPromptCaching2024_07_31 AnthropicBeta = "prompt-caching-2024-07-31"` + + - `const AnthropicBetaComputerUse2024_10_22 AnthropicBeta = "computer-use-2024-10-22"` + + - `const AnthropicBetaComputerUse2025_01_24 AnthropicBeta = "computer-use-2025-01-24"` + + - `const AnthropicBetaPDFs2024_09_25 AnthropicBeta = "pdfs-2024-09-25"` + + - `const AnthropicBetaTokenCounting2024_11_01 AnthropicBeta = "token-counting-2024-11-01"` + + - `const AnthropicBetaTokenEfficientTools2025_02_19 AnthropicBeta = "token-efficient-tools-2025-02-19"` + + - `const AnthropicBetaOutput128k2025_02_19 AnthropicBeta = "output-128k-2025-02-19"` + + - `const AnthropicBetaFilesAPI2025_04_14 AnthropicBeta = "files-api-2025-04-14"` + + - `const AnthropicBetaMCPClient2025_04_04 AnthropicBeta = "mcp-client-2025-04-04"` + + - `const AnthropicBetaMCPClient2025_11_20 AnthropicBeta = "mcp-client-2025-11-20"` + + - `const AnthropicBetaDevFullThinking2025_05_14 AnthropicBeta = "dev-full-thinking-2025-05-14"` + + - `const AnthropicBetaInterleavedThinking2025_05_14 AnthropicBeta = "interleaved-thinking-2025-05-14"` + + - `const AnthropicBetaCodeExecution2025_05_22 AnthropicBeta = "code-execution-2025-05-22"` + + - `const AnthropicBetaExtendedCacheTTL2025_04_11 AnthropicBeta = "extended-cache-ttl-2025-04-11"` + + - `const AnthropicBetaContext1m2025_08_07 AnthropicBeta = "context-1m-2025-08-07"` + + - `const AnthropicBetaContextManagement2025_06_27 AnthropicBeta = "context-management-2025-06-27"` + + - `const AnthropicBetaModelContextWindowExceeded2025_08_26 AnthropicBeta = "model-context-window-exceeded-2025-08-26"` + + - `const AnthropicBetaSkills2025_10_02 AnthropicBeta = "skills-2025-10-02"` + + - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + +### Returns + +- `type BetaUserProfileEnrollmentURL struct{…}` + + - `ExpiresAt Time` + + A timestamp in RFC 3339 format + + - `Type string` + + - `URL string` + +### Example + +```go +package main + +import ( + "context" + "fmt" + + "github.com/anthropics/anthropic-sdk-go" + "github.com/anthropics/anthropic-sdk-go/option" +) + +func main() { + client := anthropic.NewClient( + option.WithAPIKey("my-anthropic-api-key"), + ) + betaUserProfileEnrollmentURL, err := client.Beta.UserProfiles.NewEnrollmentURL( + context.TODO(), + "id", + anthropic.BetaUserProfileNewEnrollmentURLParams{ + + }, + ) + if err != nil { + panic(err.Error()) + } + fmt.Printf("%+v\n", betaUserProfileEnrollmentURL.ExpiresAt) +} +``` diff --git a/content/en/api/go/beta/user_profiles/list.md b/content/en/api/go/beta/user_profiles/list.md new file mode 100644 index 000000000..e6ecc8214 --- /dev/null +++ b/content/en/api/go/beta/user_profiles/list.md @@ -0,0 +1,130 @@ +## List + +`client.Beta.UserProfiles.List(ctx, params) (*PageCursorV2[BetaUserProfile], error)` + +**get** `/v1/user_profiles` + +List User Profiles + +### Parameters + +- `params BetaUserProfileListParams` + + - `Limit param.Field[int64]` + + Query param: Query parameter for limit + + - `Order param.Field[BetaUserProfileListParamsOrder]` + + Query param: Query parameter for order + + - `const BetaUserProfileListParamsOrderAsc BetaUserProfileListParamsOrder = "asc"` + + - `const BetaUserProfileListParamsOrderDesc BetaUserProfileListParamsOrder = "desc"` + + - `Page param.Field[string]` + + Query param: Query parameter for page + + - `Betas param.Field[[]AnthropicBeta]` + + Header param: Optional header to specify the beta version(s) you want to use. + + - `string` + + - `type AnthropicBeta string` + + - `const AnthropicBetaMessageBatches2024_09_24 AnthropicBeta = "message-batches-2024-09-24"` + + - `const AnthropicBetaPromptCaching2024_07_31 AnthropicBeta = "prompt-caching-2024-07-31"` + + - `const AnthropicBetaComputerUse2024_10_22 AnthropicBeta = "computer-use-2024-10-22"` + + - `const AnthropicBetaComputerUse2025_01_24 AnthropicBeta = "computer-use-2025-01-24"` + + - `const AnthropicBetaPDFs2024_09_25 AnthropicBeta = "pdfs-2024-09-25"` + + - `const AnthropicBetaTokenCounting2024_11_01 AnthropicBeta = "token-counting-2024-11-01"` + + - `const AnthropicBetaTokenEfficientTools2025_02_19 AnthropicBeta = "token-efficient-tools-2025-02-19"` + + - `const AnthropicBetaOutput128k2025_02_19 AnthropicBeta = "output-128k-2025-02-19"` + + - `const AnthropicBetaFilesAPI2025_04_14 AnthropicBeta = "files-api-2025-04-14"` + + - `const AnthropicBetaMCPClient2025_04_04 AnthropicBeta = "mcp-client-2025-04-04"` + + - `const AnthropicBetaMCPClient2025_11_20 AnthropicBeta = "mcp-client-2025-11-20"` + + - `const AnthropicBetaDevFullThinking2025_05_14 AnthropicBeta = "dev-full-thinking-2025-05-14"` + + - `const AnthropicBetaInterleavedThinking2025_05_14 AnthropicBeta = "interleaved-thinking-2025-05-14"` + + - `const AnthropicBetaCodeExecution2025_05_22 AnthropicBeta = "code-execution-2025-05-22"` + + - `const AnthropicBetaExtendedCacheTTL2025_04_11 AnthropicBeta = "extended-cache-ttl-2025-04-11"` + + - `const AnthropicBetaContext1m2025_08_07 AnthropicBeta = "context-1m-2025-08-07"` + + - `const AnthropicBetaContextManagement2025_06_27 AnthropicBeta = "context-management-2025-06-27"` + + - `const AnthropicBetaModelContextWindowExceeded2025_08_26 AnthropicBeta = "model-context-window-exceeded-2025-08-26"` + + - `const AnthropicBetaSkills2025_10_02 AnthropicBeta = "skills-2025-10-02"` + + - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + +### Returns + +- `type BetaUserProfile struct{…}` + + - `ID string` + + - `CreatedAt Time` + + A timestamp in RFC 3339 format + + - `Metadata map[string, string]` + + - `TrustGrants map[string, BetaUserProfileTrustGrant]` + + - `Status string` + + - `Type string` + + - `UpdatedAt Time` + + A timestamp in RFC 3339 format + + - `ExternalID string` + +### Example + +```go +package main + +import ( + "context" + "fmt" + + "github.com/anthropics/anthropic-sdk-go" + "github.com/anthropics/anthropic-sdk-go/option" +) + +func main() { + client := anthropic.NewClient( + option.WithAPIKey("my-anthropic-api-key"), + ) + page, err := client.Beta.UserProfiles.List(context.TODO(), anthropic.BetaUserProfileListParams{ + + }) + if err != nil { + panic(err.Error()) + } + fmt.Printf("%+v\n", page) +} +``` diff --git a/content/en/api/go/beta/user_profiles/retrieve.md b/content/en/api/go/beta/user_profiles/retrieve.md new file mode 100644 index 000000000..bccae142b --- /dev/null +++ b/content/en/api/go/beta/user_profiles/retrieve.md @@ -0,0 +1,120 @@ +## Retrieve + +`client.Beta.UserProfiles.Get(ctx, id, query) (*BetaUserProfile, error)` + +**get** `/v1/user_profiles/{id}` + +Get User Profile + +### Parameters + +- `id string` + +- `query BetaUserProfileGetParams` + + - `Betas param.Field[[]AnthropicBeta]` + + Optional header to specify the beta version(s) you want to use. + + - `string` + + - `type AnthropicBeta string` + + - `const AnthropicBetaMessageBatches2024_09_24 AnthropicBeta = "message-batches-2024-09-24"` + + - `const AnthropicBetaPromptCaching2024_07_31 AnthropicBeta = "prompt-caching-2024-07-31"` + + - `const AnthropicBetaComputerUse2024_10_22 AnthropicBeta = "computer-use-2024-10-22"` + + - `const AnthropicBetaComputerUse2025_01_24 AnthropicBeta = "computer-use-2025-01-24"` + + - `const AnthropicBetaPDFs2024_09_25 AnthropicBeta = "pdfs-2024-09-25"` + + - `const AnthropicBetaTokenCounting2024_11_01 AnthropicBeta = "token-counting-2024-11-01"` + + - `const AnthropicBetaTokenEfficientTools2025_02_19 AnthropicBeta = "token-efficient-tools-2025-02-19"` + + - `const AnthropicBetaOutput128k2025_02_19 AnthropicBeta = "output-128k-2025-02-19"` + + - `const AnthropicBetaFilesAPI2025_04_14 AnthropicBeta = "files-api-2025-04-14"` + + - `const AnthropicBetaMCPClient2025_04_04 AnthropicBeta = "mcp-client-2025-04-04"` + + - `const AnthropicBetaMCPClient2025_11_20 AnthropicBeta = "mcp-client-2025-11-20"` + + - `const AnthropicBetaDevFullThinking2025_05_14 AnthropicBeta = "dev-full-thinking-2025-05-14"` + + - `const AnthropicBetaInterleavedThinking2025_05_14 AnthropicBeta = "interleaved-thinking-2025-05-14"` + + - `const AnthropicBetaCodeExecution2025_05_22 AnthropicBeta = "code-execution-2025-05-22"` + + - `const AnthropicBetaExtendedCacheTTL2025_04_11 AnthropicBeta = "extended-cache-ttl-2025-04-11"` + + - `const AnthropicBetaContext1m2025_08_07 AnthropicBeta = "context-1m-2025-08-07"` + + - `const AnthropicBetaContextManagement2025_06_27 AnthropicBeta = "context-management-2025-06-27"` + + - `const AnthropicBetaModelContextWindowExceeded2025_08_26 AnthropicBeta = "model-context-window-exceeded-2025-08-26"` + + - `const AnthropicBetaSkills2025_10_02 AnthropicBeta = "skills-2025-10-02"` + + - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + +### Returns + +- `type BetaUserProfile struct{…}` + + - `ID string` + + - `CreatedAt Time` + + A timestamp in RFC 3339 format + + - `Metadata map[string, string]` + + - `TrustGrants map[string, BetaUserProfileTrustGrant]` + + - `Status string` + + - `Type string` + + - `UpdatedAt Time` + + A timestamp in RFC 3339 format + + - `ExternalID string` + +### Example + +```go +package main + +import ( + "context" + "fmt" + + "github.com/anthropics/anthropic-sdk-go" + "github.com/anthropics/anthropic-sdk-go/option" +) + +func main() { + client := anthropic.NewClient( + option.WithAPIKey("my-anthropic-api-key"), + ) + betaUserProfile, err := client.Beta.UserProfiles.Get( + context.TODO(), + "id", + anthropic.BetaUserProfileGetParams{ + + }, + ) + if err != nil { + panic(err.Error()) + } + fmt.Printf("%+v\n", betaUserProfile.ID) +} +``` diff --git a/content/en/api/go/beta/user_profiles/update.md b/content/en/api/go/beta/user_profiles/update.md new file mode 100644 index 000000000..b4f10060d --- /dev/null +++ b/content/en/api/go/beta/user_profiles/update.md @@ -0,0 +1,128 @@ +## Update + +`client.Beta.UserProfiles.Update(ctx, id, params) (*BetaUserProfile, error)` + +**post** `/v1/user_profiles/{id}` + +Update User Profile + +### Parameters + +- `id string` + +- `params BetaUserProfileUpdateParams` + + - `ExternalID param.Field[string]` + + Body param + + - `Metadata param.Field[map[string, string]]` + + Body param: Key-value pairs to merge into the stored metadata. Keys provided overwrite existing values. To remove a key, set its value to an empty string. Keys not provided are left unchanged. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. + + - `Betas param.Field[[]AnthropicBeta]` + + Header param: Optional header to specify the beta version(s) you want to use. + + - `string` + + - `type AnthropicBeta string` + + - `const AnthropicBetaMessageBatches2024_09_24 AnthropicBeta = "message-batches-2024-09-24"` + + - `const AnthropicBetaPromptCaching2024_07_31 AnthropicBeta = "prompt-caching-2024-07-31"` + + - `const AnthropicBetaComputerUse2024_10_22 AnthropicBeta = "computer-use-2024-10-22"` + + - `const AnthropicBetaComputerUse2025_01_24 AnthropicBeta = "computer-use-2025-01-24"` + + - `const AnthropicBetaPDFs2024_09_25 AnthropicBeta = "pdfs-2024-09-25"` + + - `const AnthropicBetaTokenCounting2024_11_01 AnthropicBeta = "token-counting-2024-11-01"` + + - `const AnthropicBetaTokenEfficientTools2025_02_19 AnthropicBeta = "token-efficient-tools-2025-02-19"` + + - `const AnthropicBetaOutput128k2025_02_19 AnthropicBeta = "output-128k-2025-02-19"` + + - `const AnthropicBetaFilesAPI2025_04_14 AnthropicBeta = "files-api-2025-04-14"` + + - `const AnthropicBetaMCPClient2025_04_04 AnthropicBeta = "mcp-client-2025-04-04"` + + - `const AnthropicBetaMCPClient2025_11_20 AnthropicBeta = "mcp-client-2025-11-20"` + + - `const AnthropicBetaDevFullThinking2025_05_14 AnthropicBeta = "dev-full-thinking-2025-05-14"` + + - `const AnthropicBetaInterleavedThinking2025_05_14 AnthropicBeta = "interleaved-thinking-2025-05-14"` + + - `const AnthropicBetaCodeExecution2025_05_22 AnthropicBeta = "code-execution-2025-05-22"` + + - `const AnthropicBetaExtendedCacheTTL2025_04_11 AnthropicBeta = "extended-cache-ttl-2025-04-11"` + + - `const AnthropicBetaContext1m2025_08_07 AnthropicBeta = "context-1m-2025-08-07"` + + - `const AnthropicBetaContextManagement2025_06_27 AnthropicBeta = "context-management-2025-06-27"` + + - `const AnthropicBetaModelContextWindowExceeded2025_08_26 AnthropicBeta = "model-context-window-exceeded-2025-08-26"` + + - `const AnthropicBetaSkills2025_10_02 AnthropicBeta = "skills-2025-10-02"` + + - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + +### Returns + +- `type BetaUserProfile struct{…}` + + - `ID string` + + - `CreatedAt Time` + + A timestamp in RFC 3339 format + + - `Metadata map[string, string]` + + - `TrustGrants map[string, BetaUserProfileTrustGrant]` + + - `Status string` + + - `Type string` + + - `UpdatedAt Time` + + A timestamp in RFC 3339 format + + - `ExternalID string` + +### Example + +```go +package main + +import ( + "context" + "fmt" + + "github.com/anthropics/anthropic-sdk-go" + "github.com/anthropics/anthropic-sdk-go/option" +) + +func main() { + client := anthropic.NewClient( + option.WithAPIKey("my-anthropic-api-key"), + ) + betaUserProfile, err := client.Beta.UserProfiles.Update( + context.TODO(), + "id", + anthropic.BetaUserProfileUpdateParams{ + + }, + ) + if err != nil { + panic(err.Error()) + } + fmt.Printf("%+v\n", betaUserProfile.ID) +} +``` diff --git a/content/en/api/go/completions.md b/content/en/api/go/completions.md index d45ab68cd..2fb67476d 100644 --- a/content/en/api/go/completions.md +++ b/content/en/api/go/completions.md @@ -134,6 +134,10 @@ Future models and features will not be compatible with Text Completions. See our - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type Completion struct{…}` diff --git a/content/en/api/go/completions/create.md b/content/en/api/go/completions/create.md index bd40f11e2..45ff14c51 100644 --- a/content/en/api/go/completions/create.md +++ b/content/en/api/go/completions/create.md @@ -132,6 +132,10 @@ Future models and features will not be compatible with Text Completions. See our - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type Completion struct{…}` diff --git a/content/en/api/go/messages.md b/content/en/api/go/messages.md index 6bd997446..27c60ff3f 100644 --- a/content/en/api/go/messages.md +++ b/content/en/api/go/messages.md @@ -4387,6 +4387,30 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails RefusalStopDetails` + + Structured information about a refusal. + + - `Category RefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const RefusalStopDetailsCategoryCyber RefusalStopDetailsCategory = "cyber"` + + - `const RefusalStopDetailsCategoryBio RefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason StopReason` The reason that we stopped. @@ -13873,6 +13897,30 @@ func main() { - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails RefusalStopDetails` + + Structured information about a refusal. + + - `Category RefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const RefusalStopDetailsCategoryCyber RefusalStopDetailsCategory = "cyber"` + + - `const RefusalStopDetailsCategoryBio RefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason StopReason` The reason that we stopped. @@ -18382,6 +18430,30 @@ func main() { The time at which the container will expire. + - `StopDetails RefusalStopDetails` + + Structured information about a refusal. + + - `Category RefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const RefusalStopDetailsCategoryCyber RefusalStopDetailsCategory = "cyber"` + + - `const RefusalStopDetailsCategoryBio RefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason StopReason` - `const StopReasonEndTurn StopReason = "end_turn"` @@ -19233,6 +19305,30 @@ func main() { - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails RefusalStopDetails` + + Structured information about a refusal. + + - `Category RefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const RefusalStopDetailsCategoryCyber RefusalStopDetailsCategory = "cyber"` + + - `const RefusalStopDetailsCategoryBio RefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason StopReason` The reason that we stopped. @@ -20145,6 +20241,30 @@ func main() { - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails RefusalStopDetails` + + Structured information about a refusal. + + - `Category RefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const RefusalStopDetailsCategoryCyber RefusalStopDetailsCategory = "cyber"` + + - `const RefusalStopDetailsCategoryBio RefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason StopReason` The reason that we stopped. @@ -20272,6 +20392,30 @@ func main() { The time at which the container will expire. + - `StopDetails RefusalStopDetails` + + Structured information about a refusal. + + - `Category RefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const RefusalStopDetailsCategoryCyber RefusalStopDetailsCategory = "cyber"` + + - `const RefusalStopDetailsCategoryBio RefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason StopReason` - `const StopReasonEndTurn StopReason = "end_turn"` @@ -21170,6 +21314,32 @@ func main() { - `const RedactedThinkingRedactedThinking RedactedThinking = "redacted_thinking"` +### Refusal Stop Details + +- `type RefusalStopDetails struct{…}` + + Structured information about a refusal. + + - `Category RefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const RefusalStopDetailsCategoryCyber RefusalStopDetailsCategory = "cyber"` + + - `const RefusalStopDetailsCategoryBio RefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + ### Search Result Block Param - `type SearchResultBlockParamResp struct{…}` @@ -32022,6 +32192,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails RefusalStopDetails` + + Structured information about a refusal. + + - `Category RefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const RefusalStopDetailsCategoryCyber RefusalStopDetailsCategory = "cyber"` + + - `const RefusalStopDetailsCategoryBio RefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason StopReason` The reason that we stopped. @@ -33282,6 +33476,30 @@ func main() { - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails RefusalStopDetails` + + Structured information about a refusal. + + - `Category RefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const RefusalStopDetailsCategoryCyber RefusalStopDetailsCategory = "cyber"` + + - `const RefusalStopDetailsCategoryBio RefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason StopReason` The reason that we stopped. @@ -34322,6 +34540,30 @@ func main() { - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails RefusalStopDetails` + + Structured information about a refusal. + + - `Category RefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const RefusalStopDetailsCategoryCyber RefusalStopDetailsCategory = "cyber"` + + - `const RefusalStopDetailsCategoryBio RefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason StopReason` The reason that we stopped. @@ -35324,6 +35566,30 @@ func main() { - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails RefusalStopDetails` + + Structured information about a refusal. + + - `Category RefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const RefusalStopDetailsCategoryCyber RefusalStopDetailsCategory = "cyber"` + + - `const RefusalStopDetailsCategoryBio RefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason StopReason` The reason that we stopped. diff --git a/content/en/api/go/messages/batches.md b/content/en/api/go/messages/batches.md index 7b7b954b0..85c72d7b1 100644 --- a/content/en/api/go/messages/batches.md +++ b/content/en/api/go/messages/batches.md @@ -5255,6 +5255,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails RefusalStopDetails` + + Structured information about a refusal. + + - `Category RefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const RefusalStopDetailsCategoryCyber RefusalStopDetailsCategory = "cyber"` + + - `const RefusalStopDetailsCategoryBio RefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason StopReason` The reason that we stopped. @@ -6515,6 +6539,30 @@ func main() { - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails RefusalStopDetails` + + Structured information about a refusal. + + - `Category RefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const RefusalStopDetailsCategoryCyber RefusalStopDetailsCategory = "cyber"` + + - `const RefusalStopDetailsCategoryBio RefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason StopReason` The reason that we stopped. @@ -7555,6 +7603,30 @@ func main() { - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails RefusalStopDetails` + + Structured information about a refusal. + + - `Category RefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const RefusalStopDetailsCategoryCyber RefusalStopDetailsCategory = "cyber"` + + - `const RefusalStopDetailsCategoryBio RefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason StopReason` The reason that we stopped. @@ -8557,6 +8629,30 @@ func main() { - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails RefusalStopDetails` + + Structured information about a refusal. + + - `Category RefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const RefusalStopDetailsCategoryCyber RefusalStopDetailsCategory = "cyber"` + + - `const RefusalStopDetailsCategoryBio RefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason StopReason` The reason that we stopped. diff --git a/content/en/api/go/messages/batches/results.md b/content/en/api/go/messages/batches/results.md index 1021116fe..95cf9c913 100644 --- a/content/en/api/go/messages/batches/results.md +++ b/content/en/api/go/messages/batches/results.md @@ -823,6 +823,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails RefusalStopDetails` + + Structured information about a refusal. + + - `Category RefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const RefusalStopDetailsCategoryCyber RefusalStopDetailsCategory = "cyber"` + + - `const RefusalStopDetailsCategoryBio RefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason StopReason` The reason that we stopped. diff --git a/content/en/api/go/messages/create.md b/content/en/api/go/messages/create.md index 205af1e0a..ac2aafb22 100644 --- a/content/en/api/go/messages/create.md +++ b/content/en/api/go/messages/create.md @@ -4385,6 +4385,30 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `const AssistantAssistant Assistant = "assistant"` + - `StopDetails RefusalStopDetails` + + Structured information about a refusal. + + - `Category RefusalStopDetailsCategory` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `const RefusalStopDetailsCategoryCyber RefusalStopDetailsCategory = "cyber"` + + - `const RefusalStopDetailsCategoryBio RefusalStopDetailsCategory = "bio"` + + - `Explanation string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `Type Refusal` + + - `const RefusalRefusal Refusal = "refusal"` + - `StopReason StopReason` The reason that we stopped. diff --git a/content/en/api/go/models.md b/content/en/api/go/models.md index 6948dc606..e50e746fc 100644 --- a/content/en/api/go/models.md +++ b/content/en/api/go/models.md @@ -76,6 +76,10 @@ The Models API response can be used to determine which models are available for - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type ModelInfo struct{…}` @@ -353,6 +357,10 @@ The Models API response can be used to determine information about a specific mo - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type ModelInfo struct{…}` diff --git a/content/en/api/go/models/list.md b/content/en/api/go/models/list.md index e95b95f55..44b5ed586 100644 --- a/content/en/api/go/models/list.md +++ b/content/en/api/go/models/list.md @@ -74,6 +74,10 @@ The Models API response can be used to determine which models are available for - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type ModelInfo struct{…}` diff --git a/content/en/api/go/models/retrieve.md b/content/en/api/go/models/retrieve.md index d62e0467e..df7ec9820 100644 --- a/content/en/api/go/models/retrieve.md +++ b/content/en/api/go/models/retrieve.md @@ -64,6 +64,10 @@ The Models API response can be used to determine information about a specific mo - `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"` + - `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"` + + - `const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"` + ### Returns - `type ModelInfo struct{…}` diff --git a/content/en/api/java/beta.md b/content/en/api/java/beta.md index 94a91d0c1..005ce79dd 100644 --- a/content/en/api/java/beta.md +++ b/content/en/api/java/beta.md @@ -326,6 +326,10 @@ The Models API response can be used to determine which models are available for - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class BetaModelInfo:` @@ -593,6 +597,10 @@ The Models API response can be used to determine information about a specific mo - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class BetaModelInfo:` @@ -1338,6 +1346,10 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + - `long maxTokens` The maximum number of tokens to generate before stopping. @@ -5657,6 +5669,10 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en Recommended for advanced use cases only. You usually only need to use `temperature`. + - `Optional userProfileId` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + ### Returns - `class BetaMessage:` @@ -6648,6 +6664,30 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. @@ -6940,6 +6980,10 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + - `List messages` Input messages. @@ -18374,6 +18418,30 @@ public final class Main { - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. @@ -22519,6 +22587,30 @@ public final class Main { Skill version or 'latest' for most recent version + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` - `END_TURN("end_turn")` @@ -23662,6 +23754,30 @@ public final class Main { - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. @@ -24874,6 +24990,30 @@ public final class Main { - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. @@ -25159,6 +25299,30 @@ public final class Main { Skill version or 'latest' for most recent version + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` - `END_TURN("end_turn")` @@ -26303,6 +26467,32 @@ public final class Main { - `REDACTED_THINKING("redacted_thinking")` +### Beta Refusal Stop Details + +- `class BetaRefusalStopDetails:` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + ### Beta Request Document Block - `class BetaRequestDocumentBlock:` @@ -33309,6 +33499,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + - `List requests` List of requests for prompt completion. Each is an individual request to create a Message. @@ -37979,6 +38173,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Recommended for advanced use cases only. You usually only need to use `temperature`. + - `Optional userProfileId` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + ### Returns - `class BetaMessageBatch:` @@ -38163,6 +38361,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class BetaMessageBatch:` @@ -38346,180 +38548,188 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` -### Returns - -- `class BetaMessageBatch:` - - - `String id` - - Unique object identifier. - - The format and length of IDs may change over time. - - - `Optional archivedAt` - - RFC 3339 datetime string representing the time at which the Message Batch was archived and its results became unavailable. - - - `Optional cancelInitiatedAt` - - RFC 3339 datetime string representing the time at which cancellation was initiated for the Message Batch. Specified only if cancellation was initiated. - - - `LocalDateTime createdAt` - - RFC 3339 datetime string representing the time at which the Message Batch was created. - - - `Optional endedAt` - - RFC 3339 datetime string representing the time at which processing for the Message Batch ended. Specified only once processing ends. - - Processing ends when every request in a Message Batch has either succeeded, errored, canceled, or expired. - - - `LocalDateTime expiresAt` - - RFC 3339 datetime string representing the time at which the Message Batch will expire and end processing, which is 24 hours after creation. - - - `ProcessingStatus processingStatus` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` - Processing status of the Message Batch. - - - `IN_PROGRESS("in_progress")` - - - `CANCELING("canceling")` - - - `ENDED("ended")` - - - `BetaMessageBatchRequestCounts requestCounts` - - Tallies requests within the Message Batch, categorized by their status. - - Requests start as `processing` and move to one of the other statuses only once processing of the entire batch ends. The sum of all values always matches the total number of requests in the batch. - - - `long canceled` - - Number of requests in the Message Batch that have been canceled. - - This is zero until processing of the entire Message Batch has ended. - - - `long errored` - - Number of requests in the Message Batch that encountered an error. - - This is zero until processing of the entire Message Batch has ended. - - - `long expired` - - Number of requests in the Message Batch that have expired. - - This is zero until processing of the entire Message Batch has ended. - - - `long processing` - - Number of requests in the Message Batch that are processing. - - - `long succeeded` - - Number of requests in the Message Batch that have completed successfully. - - This is zero until processing of the entire Message Batch has ended. - - - `Optional resultsUrl` - - URL to a `.jsonl` file containing the results of the Message Batch requests. Specified only once processing ends. - - Results in the file are not guaranteed to be in the same order as requests. Use the `custom_id` field to match results to requests. - - - `JsonValue; type "message_batch"constant` - - Object type. - - For Message Batches, this is always `"message_batch"`. - - - `MESSAGE_BATCH("message_batch")` - -### Example - -```java -package com.anthropic.example; - -import com.anthropic.client.AnthropicClient; -import com.anthropic.client.okhttp.AnthropicOkHttpClient; -import com.anthropic.models.beta.messages.batches.BatchListPage; -import com.anthropic.models.beta.messages.batches.BatchListParams; - -public final class Main { - private Main() {} - - public static void main(String[] args) { - AnthropicClient client = AnthropicOkHttpClient.fromEnv(); - - BatchListPage page = client.beta().messages().batches().list(); - } -} -``` - -## Cancel - -`BetaMessageBatch beta().messages().batches().cancel(BatchCancelParamsparams = BatchCancelParams.none(), RequestOptionsrequestOptions = RequestOptions.none())` - -**post** `/v1/messages/batches/{message_batch_id}/cancel` - -Batches may be canceled any time before processing ends. Once cancellation is initiated, the batch enters a `canceling` state, at which time the system may complete any in-progress, non-interruptible requests before finalizing cancellation. - -The number of canceled requests is specified in `request_counts`. To determine which requests were canceled, check the individual results within the batch. Note that cancellation may not result in any canceled requests if they were non-interruptible. - -Learn more about the Message Batches API in our [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing) - -### Parameters - -- `BatchCancelParams params` - - - `Optional messageBatchId` - - ID of the Message Batch. - - - `Optional> betas` - - Optional header to specify the beta version(s) you want to use. - - - `MESSAGE_BATCHES_2024_09_24("message-batches-2024-09-24")` - - - `PROMPT_CACHING_2024_07_31("prompt-caching-2024-07-31")` - - - `COMPUTER_USE_2024_10_22("computer-use-2024-10-22")` - - - `COMPUTER_USE_2025_01_24("computer-use-2025-01-24")` - - - `PDFS_2024_09_25("pdfs-2024-09-25")` - - - `TOKEN_COUNTING_2024_11_01("token-counting-2024-11-01")` - - - `TOKEN_EFFICIENT_TOOLS_2025_02_19("token-efficient-tools-2025-02-19")` - - - `OUTPUT_128K_2025_02_19("output-128k-2025-02-19")` - - - `FILES_API_2025_04_14("files-api-2025-04-14")` - - - `MCP_CLIENT_2025_04_04("mcp-client-2025-04-04")` - - - `MCP_CLIENT_2025_11_20("mcp-client-2025-11-20")` - - - `DEV_FULL_THINKING_2025_05_14("dev-full-thinking-2025-05-14")` - - - `INTERLEAVED_THINKING_2025_05_14("interleaved-thinking-2025-05-14")` - - - `CODE_EXECUTION_2025_05_22("code-execution-2025-05-22")` - - - `EXTENDED_CACHE_TTL_2025_04_11("extended-cache-ttl-2025-04-11")` - - - `CONTEXT_1M_2025_08_07("context-1m-2025-08-07")` - - - `CONTEXT_MANAGEMENT_2025_06_27("context-management-2025-06-27")` - - - `MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26("model-context-window-exceeded-2025-08-26")` - - - `SKILLS_2025_10_02("skills-2025-10-02")` - - - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + +### Returns + +- `class BetaMessageBatch:` + + - `String id` + + Unique object identifier. + + The format and length of IDs may change over time. + + - `Optional archivedAt` + + RFC 3339 datetime string representing the time at which the Message Batch was archived and its results became unavailable. + + - `Optional cancelInitiatedAt` + + RFC 3339 datetime string representing the time at which cancellation was initiated for the Message Batch. Specified only if cancellation was initiated. + + - `LocalDateTime createdAt` + + RFC 3339 datetime string representing the time at which the Message Batch was created. + + - `Optional endedAt` + + RFC 3339 datetime string representing the time at which processing for the Message Batch ended. Specified only once processing ends. + + Processing ends when every request in a Message Batch has either succeeded, errored, canceled, or expired. + + - `LocalDateTime expiresAt` + + RFC 3339 datetime string representing the time at which the Message Batch will expire and end processing, which is 24 hours after creation. + + - `ProcessingStatus processingStatus` + + Processing status of the Message Batch. + + - `IN_PROGRESS("in_progress")` + + - `CANCELING("canceling")` + + - `ENDED("ended")` + + - `BetaMessageBatchRequestCounts requestCounts` + + Tallies requests within the Message Batch, categorized by their status. + + Requests start as `processing` and move to one of the other statuses only once processing of the entire batch ends. The sum of all values always matches the total number of requests in the batch. + + - `long canceled` + + Number of requests in the Message Batch that have been canceled. + + This is zero until processing of the entire Message Batch has ended. + + - `long errored` + + Number of requests in the Message Batch that encountered an error. + + This is zero until processing of the entire Message Batch has ended. + + - `long expired` + + Number of requests in the Message Batch that have expired. + + This is zero until processing of the entire Message Batch has ended. + + - `long processing` + + Number of requests in the Message Batch that are processing. + + - `long succeeded` + + Number of requests in the Message Batch that have completed successfully. + + This is zero until processing of the entire Message Batch has ended. + + - `Optional resultsUrl` + + URL to a `.jsonl` file containing the results of the Message Batch requests. Specified only once processing ends. + + Results in the file are not guaranteed to be in the same order as requests. Use the `custom_id` field to match results to requests. + + - `JsonValue; type "message_batch"constant` + + Object type. + + For Message Batches, this is always `"message_batch"`. + + - `MESSAGE_BATCH("message_batch")` + +### Example + +```java +package com.anthropic.example; + +import com.anthropic.client.AnthropicClient; +import com.anthropic.client.okhttp.AnthropicOkHttpClient; +import com.anthropic.models.beta.messages.batches.BatchListPage; +import com.anthropic.models.beta.messages.batches.BatchListParams; + +public final class Main { + private Main() {} + + public static void main(String[] args) { + AnthropicClient client = AnthropicOkHttpClient.fromEnv(); + + BatchListPage page = client.beta().messages().batches().list(); + } +} +``` + +## Cancel + +`BetaMessageBatch beta().messages().batches().cancel(BatchCancelParamsparams = BatchCancelParams.none(), RequestOptionsrequestOptions = RequestOptions.none())` + +**post** `/v1/messages/batches/{message_batch_id}/cancel` + +Batches may be canceled any time before processing ends. Once cancellation is initiated, the batch enters a `canceling` state, at which time the system may complete any in-progress, non-interruptible requests before finalizing cancellation. + +The number of canceled requests is specified in `request_counts`. To determine which requests were canceled, check the individual results within the batch. Note that cancellation may not result in any canceled requests if they were non-interruptible. + +Learn more about the Message Batches API in our [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing) + +### Parameters + +- `BatchCancelParams params` + + - `Optional messageBatchId` + + ID of the Message Batch. + + - `Optional> betas` + + Optional header to specify the beta version(s) you want to use. + + - `MESSAGE_BATCHES_2024_09_24("message-batches-2024-09-24")` + + - `PROMPT_CACHING_2024_07_31("prompt-caching-2024-07-31")` + + - `COMPUTER_USE_2024_10_22("computer-use-2024-10-22")` + + - `COMPUTER_USE_2025_01_24("computer-use-2025-01-24")` + + - `PDFS_2024_09_25("pdfs-2024-09-25")` + + - `TOKEN_COUNTING_2024_11_01("token-counting-2024-11-01")` + + - `TOKEN_EFFICIENT_TOOLS_2025_02_19("token-efficient-tools-2025-02-19")` + + - `OUTPUT_128K_2025_02_19("output-128k-2025-02-19")` + + - `FILES_API_2025_04_14("files-api-2025-04-14")` + + - `MCP_CLIENT_2025_04_04("mcp-client-2025-04-04")` + + - `MCP_CLIENT_2025_11_20("mcp-client-2025-11-20")` + + - `DEV_FULL_THINKING_2025_05_14("dev-full-thinking-2025-05-14")` + + - `INTERLEAVED_THINKING_2025_05_14("interleaved-thinking-2025-05-14")` + + - `CODE_EXECUTION_2025_05_22("code-execution-2025-05-22")` + + - `EXTENDED_CACHE_TTL_2025_04_11("extended-cache-ttl-2025-04-11")` + + - `CONTEXT_1M_2025_08_07("context-1m-2025-08-07")` + + - `CONTEXT_MANAGEMENT_2025_06_27("context-management-2025-06-27")` + + - `MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26("model-context-window-exceeded-2025-08-26")` + + - `SKILLS_2025_10_02("skills-2025-10-02")` + + - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` ### Returns @@ -38696,6 +38906,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class BetaDeletedMessageBatch:` @@ -38797,6 +39011,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class BetaMessageBatchIndividualResponse:` @@ -39806,6 +40024,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. @@ -41360,6 +41602,30 @@ public final class Main { - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. @@ -42700,6 +42966,30 @@ public final class Main { - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. @@ -44002,6 +44292,30 @@ public final class Main { - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. @@ -44269,6 +44583,10 @@ Upload File - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + - `String file` The file to upload @@ -44329,7 +44647,7 @@ public final class Main { AnthropicClient client = AnthropicOkHttpClient.fromEnv(); FileUploadParams params = FileUploadParams.builder() - .file(ByteArrayInputStream("Example data".getBytes())) + .file(new ByteArrayInputStream("Example data".getBytes())) .build(); FileMetadata fileMetadata = client.beta().files().upload(params); } @@ -44406,6 +44724,10 @@ List Files - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class FileMetadata:` @@ -44525,6 +44847,10 @@ Download File - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Example ```java @@ -44606,6 +44932,10 @@ Get File Metadata - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class FileMetadata:` @@ -44725,6 +45055,10 @@ Delete File - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class DeletedFile:` @@ -44876,6 +45210,10 @@ Create Skill - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + - `Optional displayTitle` Display title for the skill. @@ -45031,6 +45369,10 @@ List Skills - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class SkillListResponse:` @@ -45159,6 +45501,10 @@ Get Skill - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class SkillRetrieveResponse:` @@ -45287,6 +45633,10 @@ Delete Skill - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class SkillDeleteResponse:` @@ -45388,6 +45738,10 @@ Create Skill Version - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + - `Optional> files` Files to upload for the skill. @@ -45535,6 +45889,10 @@ List Skill Versions - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class VersionListResponse:` @@ -45672,6 +46030,10 @@ Get Skill Version - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class VersionRetrieveResponse:` @@ -45813,6 +46175,10 @@ Delete Skill Version - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class VersionDeleteResponse:` @@ -45853,3 +46219,596 @@ public final class Main { } } ``` + +# User Profiles + +## Create + +`BetaUserProfile beta().userProfiles().create(UserProfileCreateParamsparams = UserProfileCreateParams.none(), RequestOptionsrequestOptions = RequestOptions.none())` + +**post** `/v1/user_profiles` + +Create User Profile + +### Parameters + +- `UserProfileCreateParams params` + + - `Optional> betas` + + Optional header to specify the beta version(s) you want to use. + + - `MESSAGE_BATCHES_2024_09_24("message-batches-2024-09-24")` + + - `PROMPT_CACHING_2024_07_31("prompt-caching-2024-07-31")` + + - `COMPUTER_USE_2024_10_22("computer-use-2024-10-22")` + + - `COMPUTER_USE_2025_01_24("computer-use-2025-01-24")` + + - `PDFS_2024_09_25("pdfs-2024-09-25")` + + - `TOKEN_COUNTING_2024_11_01("token-counting-2024-11-01")` + + - `TOKEN_EFFICIENT_TOOLS_2025_02_19("token-efficient-tools-2025-02-19")` + + - `OUTPUT_128K_2025_02_19("output-128k-2025-02-19")` + + - `FILES_API_2025_04_14("files-api-2025-04-14")` + + - `MCP_CLIENT_2025_04_04("mcp-client-2025-04-04")` + + - `MCP_CLIENT_2025_11_20("mcp-client-2025-11-20")` + + - `DEV_FULL_THINKING_2025_05_14("dev-full-thinking-2025-05-14")` + + - `INTERLEAVED_THINKING_2025_05_14("interleaved-thinking-2025-05-14")` + + - `CODE_EXECUTION_2025_05_22("code-execution-2025-05-22")` + + - `EXTENDED_CACHE_TTL_2025_04_11("extended-cache-ttl-2025-04-11")` + + - `CONTEXT_1M_2025_08_07("context-1m-2025-08-07")` + + - `CONTEXT_MANAGEMENT_2025_06_27("context-management-2025-06-27")` + + - `MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26("model-context-window-exceeded-2025-08-26")` + + - `SKILLS_2025_10_02("skills-2025-10-02")` + + - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + + - `Optional externalId` + + - `Optional metadata` + + Free-form key-value data to attach to this user profile. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. Values must be non-empty strings. + +### Returns + +- `class BetaUserProfile:` + + - `String id` + + - `LocalDateTime createdAt` + + A timestamp in RFC 3339 format + + - `Metadata metadata` + + - `TrustGrants trustGrants` + + - `String status` + + - `String type` + + - `LocalDateTime updatedAt` + + A timestamp in RFC 3339 format + + - `Optional externalId` + +### Example + +```java +package com.anthropic.example; + +import com.anthropic.client.AnthropicClient; +import com.anthropic.client.okhttp.AnthropicOkHttpClient; +import com.anthropic.models.beta.userprofiles.BetaUserProfile; +import com.anthropic.models.beta.userprofiles.UserProfileCreateParams; + +public final class Main { + private Main() {} + + public static void main(String[] args) { + AnthropicClient client = AnthropicOkHttpClient.fromEnv(); + + BetaUserProfile betaUserProfile = client.beta().userProfiles().create(); + } +} +``` + +## List + +`UserProfileListPage beta().userProfiles().list(UserProfileListParamsparams = UserProfileListParams.none(), RequestOptionsrequestOptions = RequestOptions.none())` + +**get** `/v1/user_profiles` + +List User Profiles + +### Parameters + +- `UserProfileListParams params` + + - `Optional limit` + + Query parameter for limit + + - `Optional order` + + Query parameter for order + + - `ASC("asc")` + + - `DESC("desc")` + + - `Optional page` + + Query parameter for page + + - `Optional> betas` + + Optional header to specify the beta version(s) you want to use. + + - `MESSAGE_BATCHES_2024_09_24("message-batches-2024-09-24")` + + - `PROMPT_CACHING_2024_07_31("prompt-caching-2024-07-31")` + + - `COMPUTER_USE_2024_10_22("computer-use-2024-10-22")` + + - `COMPUTER_USE_2025_01_24("computer-use-2025-01-24")` + + - `PDFS_2024_09_25("pdfs-2024-09-25")` + + - `TOKEN_COUNTING_2024_11_01("token-counting-2024-11-01")` + + - `TOKEN_EFFICIENT_TOOLS_2025_02_19("token-efficient-tools-2025-02-19")` + + - `OUTPUT_128K_2025_02_19("output-128k-2025-02-19")` + + - `FILES_API_2025_04_14("files-api-2025-04-14")` + + - `MCP_CLIENT_2025_04_04("mcp-client-2025-04-04")` + + - `MCP_CLIENT_2025_11_20("mcp-client-2025-11-20")` + + - `DEV_FULL_THINKING_2025_05_14("dev-full-thinking-2025-05-14")` + + - `INTERLEAVED_THINKING_2025_05_14("interleaved-thinking-2025-05-14")` + + - `CODE_EXECUTION_2025_05_22("code-execution-2025-05-22")` + + - `EXTENDED_CACHE_TTL_2025_04_11("extended-cache-ttl-2025-04-11")` + + - `CONTEXT_1M_2025_08_07("context-1m-2025-08-07")` + + - `CONTEXT_MANAGEMENT_2025_06_27("context-management-2025-06-27")` + + - `MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26("model-context-window-exceeded-2025-08-26")` + + - `SKILLS_2025_10_02("skills-2025-10-02")` + + - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + +### Returns + +- `class BetaUserProfile:` + + - `String id` + + - `LocalDateTime createdAt` + + A timestamp in RFC 3339 format + + - `Metadata metadata` + + - `TrustGrants trustGrants` + + - `String status` + + - `String type` + + - `LocalDateTime updatedAt` + + A timestamp in RFC 3339 format + + - `Optional externalId` + +### Example + +```java +package com.anthropic.example; + +import com.anthropic.client.AnthropicClient; +import com.anthropic.client.okhttp.AnthropicOkHttpClient; +import com.anthropic.models.beta.userprofiles.UserProfileListPage; +import com.anthropic.models.beta.userprofiles.UserProfileListParams; + +public final class Main { + private Main() {} + + public static void main(String[] args) { + AnthropicClient client = AnthropicOkHttpClient.fromEnv(); + + UserProfileListPage page = client.beta().userProfiles().list(); + } +} +``` + +## Retrieve + +`BetaUserProfile beta().userProfiles().retrieve(UserProfileRetrieveParamsparams = UserProfileRetrieveParams.none(), RequestOptionsrequestOptions = RequestOptions.none())` + +**get** `/v1/user_profiles/{id}` + +Get User Profile + +### Parameters + +- `UserProfileRetrieveParams params` + + - `Optional id` + + - `Optional> betas` + + Optional header to specify the beta version(s) you want to use. + + - `MESSAGE_BATCHES_2024_09_24("message-batches-2024-09-24")` + + - `PROMPT_CACHING_2024_07_31("prompt-caching-2024-07-31")` + + - `COMPUTER_USE_2024_10_22("computer-use-2024-10-22")` + + - `COMPUTER_USE_2025_01_24("computer-use-2025-01-24")` + + - `PDFS_2024_09_25("pdfs-2024-09-25")` + + - `TOKEN_COUNTING_2024_11_01("token-counting-2024-11-01")` + + - `TOKEN_EFFICIENT_TOOLS_2025_02_19("token-efficient-tools-2025-02-19")` + + - `OUTPUT_128K_2025_02_19("output-128k-2025-02-19")` + + - `FILES_API_2025_04_14("files-api-2025-04-14")` + + - `MCP_CLIENT_2025_04_04("mcp-client-2025-04-04")` + + - `MCP_CLIENT_2025_11_20("mcp-client-2025-11-20")` + + - `DEV_FULL_THINKING_2025_05_14("dev-full-thinking-2025-05-14")` + + - `INTERLEAVED_THINKING_2025_05_14("interleaved-thinking-2025-05-14")` + + - `CODE_EXECUTION_2025_05_22("code-execution-2025-05-22")` + + - `EXTENDED_CACHE_TTL_2025_04_11("extended-cache-ttl-2025-04-11")` + + - `CONTEXT_1M_2025_08_07("context-1m-2025-08-07")` + + - `CONTEXT_MANAGEMENT_2025_06_27("context-management-2025-06-27")` + + - `MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26("model-context-window-exceeded-2025-08-26")` + + - `SKILLS_2025_10_02("skills-2025-10-02")` + + - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + +### Returns + +- `class BetaUserProfile:` + + - `String id` + + - `LocalDateTime createdAt` + + A timestamp in RFC 3339 format + + - `Metadata metadata` + + - `TrustGrants trustGrants` + + - `String status` + + - `String type` + + - `LocalDateTime updatedAt` + + A timestamp in RFC 3339 format + + - `Optional externalId` + +### Example + +```java +package com.anthropic.example; + +import com.anthropic.client.AnthropicClient; +import com.anthropic.client.okhttp.AnthropicOkHttpClient; +import com.anthropic.models.beta.userprofiles.BetaUserProfile; +import com.anthropic.models.beta.userprofiles.UserProfileRetrieveParams; + +public final class Main { + private Main() {} + + public static void main(String[] args) { + AnthropicClient client = AnthropicOkHttpClient.fromEnv(); + + BetaUserProfile betaUserProfile = client.beta().userProfiles().retrieve("id"); + } +} +``` + +## Update + +`BetaUserProfile beta().userProfiles().update(UserProfileUpdateParamsparams = UserProfileUpdateParams.none(), RequestOptionsrequestOptions = RequestOptions.none())` + +**post** `/v1/user_profiles/{id}` + +Update User Profile + +### Parameters + +- `UserProfileUpdateParams params` + + - `Optional id` + + - `Optional> betas` + + Optional header to specify the beta version(s) you want to use. + + - `MESSAGE_BATCHES_2024_09_24("message-batches-2024-09-24")` + + - `PROMPT_CACHING_2024_07_31("prompt-caching-2024-07-31")` + + - `COMPUTER_USE_2024_10_22("computer-use-2024-10-22")` + + - `COMPUTER_USE_2025_01_24("computer-use-2025-01-24")` + + - `PDFS_2024_09_25("pdfs-2024-09-25")` + + - `TOKEN_COUNTING_2024_11_01("token-counting-2024-11-01")` + + - `TOKEN_EFFICIENT_TOOLS_2025_02_19("token-efficient-tools-2025-02-19")` + + - `OUTPUT_128K_2025_02_19("output-128k-2025-02-19")` + + - `FILES_API_2025_04_14("files-api-2025-04-14")` + + - `MCP_CLIENT_2025_04_04("mcp-client-2025-04-04")` + + - `MCP_CLIENT_2025_11_20("mcp-client-2025-11-20")` + + - `DEV_FULL_THINKING_2025_05_14("dev-full-thinking-2025-05-14")` + + - `INTERLEAVED_THINKING_2025_05_14("interleaved-thinking-2025-05-14")` + + - `CODE_EXECUTION_2025_05_22("code-execution-2025-05-22")` + + - `EXTENDED_CACHE_TTL_2025_04_11("extended-cache-ttl-2025-04-11")` + + - `CONTEXT_1M_2025_08_07("context-1m-2025-08-07")` + + - `CONTEXT_MANAGEMENT_2025_06_27("context-management-2025-06-27")` + + - `MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26("model-context-window-exceeded-2025-08-26")` + + - `SKILLS_2025_10_02("skills-2025-10-02")` + + - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + + - `Optional externalId` + + - `Optional metadata` + + Key-value pairs to merge into the stored metadata. Keys provided overwrite existing values. To remove a key, set its value to an empty string. Keys not provided are left unchanged. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. + +### Returns + +- `class BetaUserProfile:` + + - `String id` + + - `LocalDateTime createdAt` + + A timestamp in RFC 3339 format + + - `Metadata metadata` + + - `TrustGrants trustGrants` + + - `String status` + + - `String type` + + - `LocalDateTime updatedAt` + + A timestamp in RFC 3339 format + + - `Optional externalId` + +### Example + +```java +package com.anthropic.example; + +import com.anthropic.client.AnthropicClient; +import com.anthropic.client.okhttp.AnthropicOkHttpClient; +import com.anthropic.models.beta.userprofiles.BetaUserProfile; +import com.anthropic.models.beta.userprofiles.UserProfileUpdateParams; + +public final class Main { + private Main() {} + + public static void main(String[] args) { + AnthropicClient client = AnthropicOkHttpClient.fromEnv(); + + BetaUserProfile betaUserProfile = client.beta().userProfiles().update("id"); + } +} +``` + +## Create Enrollment URL + +`BetaUserProfileEnrollmentUrl beta().userProfiles().createEnrollmentUrl(UserProfileCreateEnrollmentUrlParamsparams = UserProfileCreateEnrollmentUrlParams.none(), RequestOptionsrequestOptions = RequestOptions.none())` + +**post** `/v1/user_profiles/{id}/enrollment_url` + +Create Enrollment URL + +### Parameters + +- `UserProfileCreateEnrollmentUrlParams params` + + - `Optional id` + + - `Optional> betas` + + Optional header to specify the beta version(s) you want to use. + + - `MESSAGE_BATCHES_2024_09_24("message-batches-2024-09-24")` + + - `PROMPT_CACHING_2024_07_31("prompt-caching-2024-07-31")` + + - `COMPUTER_USE_2024_10_22("computer-use-2024-10-22")` + + - `COMPUTER_USE_2025_01_24("computer-use-2025-01-24")` + + - `PDFS_2024_09_25("pdfs-2024-09-25")` + + - `TOKEN_COUNTING_2024_11_01("token-counting-2024-11-01")` + + - `TOKEN_EFFICIENT_TOOLS_2025_02_19("token-efficient-tools-2025-02-19")` + + - `OUTPUT_128K_2025_02_19("output-128k-2025-02-19")` + + - `FILES_API_2025_04_14("files-api-2025-04-14")` + + - `MCP_CLIENT_2025_04_04("mcp-client-2025-04-04")` + + - `MCP_CLIENT_2025_11_20("mcp-client-2025-11-20")` + + - `DEV_FULL_THINKING_2025_05_14("dev-full-thinking-2025-05-14")` + + - `INTERLEAVED_THINKING_2025_05_14("interleaved-thinking-2025-05-14")` + + - `CODE_EXECUTION_2025_05_22("code-execution-2025-05-22")` + + - `EXTENDED_CACHE_TTL_2025_04_11("extended-cache-ttl-2025-04-11")` + + - `CONTEXT_1M_2025_08_07("context-1m-2025-08-07")` + + - `CONTEXT_MANAGEMENT_2025_06_27("context-management-2025-06-27")` + + - `MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26("model-context-window-exceeded-2025-08-26")` + + - `SKILLS_2025_10_02("skills-2025-10-02")` + + - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + +### Returns + +- `class BetaUserProfileEnrollmentUrl:` + + - `LocalDateTime expiresAt` + + A timestamp in RFC 3339 format + + - `String type` + + - `String url` + +### Example + +```java +package com.anthropic.example; + +import com.anthropic.client.AnthropicClient; +import com.anthropic.client.okhttp.AnthropicOkHttpClient; +import com.anthropic.models.beta.userprofiles.BetaUserProfileEnrollmentUrl; +import com.anthropic.models.beta.userprofiles.UserProfileCreateEnrollmentUrlParams; + +public final class Main { + private Main() {} + + public static void main(String[] args) { + AnthropicClient client = AnthropicOkHttpClient.fromEnv(); + + BetaUserProfileEnrollmentUrl betaUserProfileEnrollmentUrl = client.beta().userProfiles().createEnrollmentUrl("id"); + } +} +``` + +## Domain Types + +### Beta User Profile + +- `class BetaUserProfile:` + + - `String id` + + - `LocalDateTime createdAt` + + A timestamp in RFC 3339 format + + - `Metadata metadata` + + - `TrustGrants trustGrants` + + - `String status` + + - `String type` + + - `LocalDateTime updatedAt` + + A timestamp in RFC 3339 format + + - `Optional externalId` + +### Beta User Profile Enrollment URL + +- `class BetaUserProfileEnrollmentUrl:` + + - `LocalDateTime expiresAt` + + A timestamp in RFC 3339 format + + - `String type` + + - `String url` + +### Beta User Profile Trust Grant + +- `class BetaUserProfileTrustGrant:` + + - `String status` diff --git a/content/en/api/java/beta/files.md b/content/en/api/java/beta/files.md index 0df7d5e8a..2095aef2a 100644 --- a/content/en/api/java/beta/files.md +++ b/content/en/api/java/beta/files.md @@ -56,6 +56,10 @@ Upload File - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + - `String file` The file to upload @@ -116,7 +120,7 @@ public final class Main { AnthropicClient client = AnthropicOkHttpClient.fromEnv(); FileUploadParams params = FileUploadParams.builder() - .file(ByteArrayInputStream("Example data".getBytes())) + .file(new ByteArrayInputStream("Example data".getBytes())) .build(); FileMetadata fileMetadata = client.beta().files().upload(params); } @@ -193,6 +197,10 @@ List Files - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class FileMetadata:` @@ -312,6 +320,10 @@ Download File - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Example ```java @@ -393,6 +405,10 @@ Get File Metadata - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class FileMetadata:` @@ -512,6 +528,10 @@ Delete File - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class DeletedFile:` diff --git a/content/en/api/java/beta/files/delete.md b/content/en/api/java/beta/files/delete.md index 877f27d43..c9243603b 100644 --- a/content/en/api/java/beta/files/delete.md +++ b/content/en/api/java/beta/files/delete.md @@ -58,6 +58,10 @@ Delete File - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class DeletedFile:` diff --git a/content/en/api/java/beta/files/download.md b/content/en/api/java/beta/files/download.md index 1f0161e75..297868e59 100644 --- a/content/en/api/java/beta/files/download.md +++ b/content/en/api/java/beta/files/download.md @@ -58,6 +58,10 @@ Download File - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Example ```java diff --git a/content/en/api/java/beta/files/list.md b/content/en/api/java/beta/files/list.md index 53aa51a5d..1af8c1548 100644 --- a/content/en/api/java/beta/files/list.md +++ b/content/en/api/java/beta/files/list.md @@ -68,6 +68,10 @@ List Files - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class FileMetadata:` diff --git a/content/en/api/java/beta/files/retrieve_metadata.md b/content/en/api/java/beta/files/retrieve_metadata.md index 0d2686bcb..1571dd4dc 100644 --- a/content/en/api/java/beta/files/retrieve_metadata.md +++ b/content/en/api/java/beta/files/retrieve_metadata.md @@ -58,6 +58,10 @@ Get File Metadata - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class FileMetadata:` diff --git a/content/en/api/java/beta/files/upload.md b/content/en/api/java/beta/files/upload.md index 933dc2286..ab1fc2461 100644 --- a/content/en/api/java/beta/files/upload.md +++ b/content/en/api/java/beta/files/upload.md @@ -54,6 +54,10 @@ Upload File - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + - `String file` The file to upload @@ -114,7 +118,7 @@ public final class Main { AnthropicClient client = AnthropicOkHttpClient.fromEnv(); FileUploadParams params = FileUploadParams.builder() - .file(ByteArrayInputStream("Example data".getBytes())) + .file(new ByteArrayInputStream("Example data".getBytes())) .build(); FileMetadata fileMetadata = client.beta().files().upload(params); } diff --git a/content/en/api/java/beta/messages.md b/content/en/api/java/beta/messages.md index 42c6267c6..3d48ad2db 100644 --- a/content/en/api/java/beta/messages.md +++ b/content/en/api/java/beta/messages.md @@ -60,6 +60,10 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + - `long maxTokens` The maximum number of tokens to generate before stopping. @@ -4379,6 +4383,10 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en Recommended for advanced use cases only. You usually only need to use `temperature`. + - `Optional userProfileId` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + ### Returns - `class BetaMessage:` @@ -5370,6 +5378,30 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. @@ -5662,6 +5694,10 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + - `List messages` Input messages. @@ -17096,6 +17132,30 @@ public final class Main { - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. @@ -21241,6 +21301,30 @@ public final class Main { Skill version or 'latest' for most recent version + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` - `END_TURN("end_turn")` @@ -22384,6 +22468,30 @@ public final class Main { - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. @@ -23596,6 +23704,30 @@ public final class Main { - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. @@ -23881,6 +24013,30 @@ public final class Main { Skill version or 'latest' for most recent version + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` - `END_TURN("end_turn")` @@ -25025,6 +25181,32 @@ public final class Main { - `REDACTED_THINKING("redacted_thinking")` +### Beta Refusal Stop Details + +- `class BetaRefusalStopDetails:` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + ### Beta Request Document Block - `class BetaRequestDocumentBlock:` @@ -32031,6 +32213,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + - `List requests` List of requests for prompt completion. Each is an individual request to create a Message. @@ -36701,6 +36887,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Recommended for advanced use cases only. You usually only need to use `temperature`. + - `Optional userProfileId` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + ### Returns - `class BetaMessageBatch:` @@ -36885,6 +37075,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class BetaMessageBatch:` @@ -37068,6 +37262,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class BetaMessageBatch:` @@ -37243,6 +37441,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class BetaMessageBatch:` @@ -37418,6 +37620,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class BetaDeletedMessageBatch:` @@ -37519,6 +37725,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class BetaMessageBatchIndividualResponse:` @@ -38528,6 +38738,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. @@ -40082,6 +40316,30 @@ public final class Main { - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. @@ -41422,6 +41680,30 @@ public final class Main { - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. @@ -42724,6 +43006,30 @@ public final class Main { - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. diff --git a/content/en/api/java/beta/messages/batches.md b/content/en/api/java/beta/messages/batches.md index 352ffc082..b740b9435 100644 --- a/content/en/api/java/beta/messages/batches.md +++ b/content/en/api/java/beta/messages/batches.md @@ -60,6 +60,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + - `List requests` List of requests for prompt completion. Each is an individual request to create a Message. @@ -4730,6 +4734,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Recommended for advanced use cases only. You usually only need to use `temperature`. + - `Optional userProfileId` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + ### Returns - `class BetaMessageBatch:` @@ -4914,6 +4922,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class BetaMessageBatch:` @@ -5097,6 +5109,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class BetaMessageBatch:` @@ -5272,6 +5288,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class BetaMessageBatch:` @@ -5447,6 +5467,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class BetaDeletedMessageBatch:` @@ -5548,6 +5572,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class BetaMessageBatchIndividualResponse:` @@ -6557,6 +6585,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. @@ -8111,6 +8163,30 @@ public final class Main { - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. @@ -9451,6 +9527,30 @@ public final class Main { - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. @@ -10753,6 +10853,30 @@ public final class Main { - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. diff --git a/content/en/api/java/beta/messages/batches/cancel.md b/content/en/api/java/beta/messages/batches/cancel.md index 23dfbf7fe..ec363bede 100644 --- a/content/en/api/java/beta/messages/batches/cancel.md +++ b/content/en/api/java/beta/messages/batches/cancel.md @@ -62,6 +62,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class BetaMessageBatch:` diff --git a/content/en/api/java/beta/messages/batches/create.md b/content/en/api/java/beta/messages/batches/create.md index 88fab2f89..100ea7d26 100644 --- a/content/en/api/java/beta/messages/batches/create.md +++ b/content/en/api/java/beta/messages/batches/create.md @@ -58,6 +58,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + - `List requests` List of requests for prompt completion. Each is an individual request to create a Message. @@ -4728,6 +4732,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Recommended for advanced use cases only. You usually only need to use `temperature`. + - `Optional userProfileId` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + ### Returns - `class BetaMessageBatch:` diff --git a/content/en/api/java/beta/messages/batches/delete.md b/content/en/api/java/beta/messages/batches/delete.md index f4a519525..cd99d4b22 100644 --- a/content/en/api/java/beta/messages/batches/delete.md +++ b/content/en/api/java/beta/messages/batches/delete.md @@ -62,6 +62,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class BetaDeletedMessageBatch:` diff --git a/content/en/api/java/beta/messages/batches/list.md b/content/en/api/java/beta/messages/batches/list.md index be095d724..5401a87bf 100644 --- a/content/en/api/java/beta/messages/batches/list.md +++ b/content/en/api/java/beta/messages/batches/list.md @@ -70,6 +70,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class BetaMessageBatch:` diff --git a/content/en/api/java/beta/messages/batches/results.md b/content/en/api/java/beta/messages/batches/results.md index 90ce15964..b9c88de2f 100644 --- a/content/en/api/java/beta/messages/batches/results.md +++ b/content/en/api/java/beta/messages/batches/results.md @@ -62,6 +62,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class BetaMessageBatchIndividualResponse:` @@ -1071,6 +1075,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. diff --git a/content/en/api/java/beta/messages/batches/retrieve.md b/content/en/api/java/beta/messages/batches/retrieve.md index ccc8128ec..bb4b2b5c7 100644 --- a/content/en/api/java/beta/messages/batches/retrieve.md +++ b/content/en/api/java/beta/messages/batches/retrieve.md @@ -60,6 +60,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class BetaMessageBatch:` diff --git a/content/en/api/java/beta/messages/count_tokens.md b/content/en/api/java/beta/messages/count_tokens.md index 94eae8710..7c9750a5a 100644 --- a/content/en/api/java/beta/messages/count_tokens.md +++ b/content/en/api/java/beta/messages/count_tokens.md @@ -58,6 +58,10 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + - `List messages` Input messages. diff --git a/content/en/api/java/beta/messages/create.md b/content/en/api/java/beta/messages/create.md index e7ebfa7f8..1612fdc4c 100644 --- a/content/en/api/java/beta/messages/create.md +++ b/content/en/api/java/beta/messages/create.md @@ -58,6 +58,10 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + - `long maxTokens` The maximum number of tokens to generate before stopping. @@ -4377,6 +4381,10 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en Recommended for advanced use cases only. You usually only need to use `temperature`. + - `Optional userProfileId` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + ### Returns - `class BetaMessage:` @@ -5368,6 +5376,30 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. diff --git a/content/en/api/java/beta/models.md b/content/en/api/java/beta/models.md index 901c1bf7a..78ad71410 100644 --- a/content/en/api/java/beta/models.md +++ b/content/en/api/java/beta/models.md @@ -72,6 +72,10 @@ The Models API response can be used to determine which models are available for - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class BetaModelInfo:` @@ -339,6 +343,10 @@ The Models API response can be used to determine information about a specific mo - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class BetaModelInfo:` diff --git a/content/en/api/java/beta/models/list.md b/content/en/api/java/beta/models/list.md index 2129dbd2f..537fdcb7a 100644 --- a/content/en/api/java/beta/models/list.md +++ b/content/en/api/java/beta/models/list.md @@ -70,6 +70,10 @@ The Models API response can be used to determine which models are available for - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class BetaModelInfo:` diff --git a/content/en/api/java/beta/models/retrieve.md b/content/en/api/java/beta/models/retrieve.md index ab93195ef..3943adfe2 100644 --- a/content/en/api/java/beta/models/retrieve.md +++ b/content/en/api/java/beta/models/retrieve.md @@ -60,6 +60,10 @@ The Models API response can be used to determine information about a specific mo - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class BetaModelInfo:` diff --git a/content/en/api/java/beta/skills.md b/content/en/api/java/beta/skills.md index 6e6df5f9d..59730d398 100644 --- a/content/en/api/java/beta/skills.md +++ b/content/en/api/java/beta/skills.md @@ -56,6 +56,10 @@ Create Skill - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + - `Optional displayTitle` Display title for the skill. @@ -211,6 +215,10 @@ List Skills - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class SkillListResponse:` @@ -339,6 +347,10 @@ Get Skill - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class SkillRetrieveResponse:` @@ -467,6 +479,10 @@ Delete Skill - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class SkillDeleteResponse:` @@ -568,6 +584,10 @@ Create Skill Version - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + - `Optional> files` Files to upload for the skill. @@ -715,6 +735,10 @@ List Skill Versions - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class VersionListResponse:` @@ -852,6 +876,10 @@ Get Skill Version - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class VersionRetrieveResponse:` @@ -993,6 +1021,10 @@ Delete Skill Version - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class VersionDeleteResponse:` diff --git a/content/en/api/java/beta/skills/create.md b/content/en/api/java/beta/skills/create.md index ff4713ebb..f552b64cb 100644 --- a/content/en/api/java/beta/skills/create.md +++ b/content/en/api/java/beta/skills/create.md @@ -54,6 +54,10 @@ Create Skill - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + - `Optional displayTitle` Display title for the skill. diff --git a/content/en/api/java/beta/skills/delete.md b/content/en/api/java/beta/skills/delete.md index f1e660170..5e811d0f7 100644 --- a/content/en/api/java/beta/skills/delete.md +++ b/content/en/api/java/beta/skills/delete.md @@ -60,6 +60,10 @@ Delete Skill - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class SkillDeleteResponse:` diff --git a/content/en/api/java/beta/skills/list.md b/content/en/api/java/beta/skills/list.md index 82255d366..9bb982240 100644 --- a/content/en/api/java/beta/skills/list.md +++ b/content/en/api/java/beta/skills/list.md @@ -75,6 +75,10 @@ List Skills - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class SkillListResponse:` diff --git a/content/en/api/java/beta/skills/retrieve.md b/content/en/api/java/beta/skills/retrieve.md index e3818a6e8..a18f09b5c 100644 --- a/content/en/api/java/beta/skills/retrieve.md +++ b/content/en/api/java/beta/skills/retrieve.md @@ -60,6 +60,10 @@ Get Skill - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class SkillRetrieveResponse:` diff --git a/content/en/api/java/beta/skills/versions.md b/content/en/api/java/beta/skills/versions.md index 5ad4cd15e..f45234940 100644 --- a/content/en/api/java/beta/skills/versions.md +++ b/content/en/api/java/beta/skills/versions.md @@ -62,6 +62,10 @@ Create Skill Version - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + - `Optional> files` Files to upload for the skill. @@ -209,6 +213,10 @@ List Skill Versions - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class VersionListResponse:` @@ -346,6 +354,10 @@ Get Skill Version - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class VersionRetrieveResponse:` @@ -487,6 +499,10 @@ Delete Skill Version - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class VersionDeleteResponse:` diff --git a/content/en/api/java/beta/skills/versions/create.md b/content/en/api/java/beta/skills/versions/create.md index 944f2e021..e15aadc33 100644 --- a/content/en/api/java/beta/skills/versions/create.md +++ b/content/en/api/java/beta/skills/versions/create.md @@ -60,6 +60,10 @@ Create Skill Version - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + - `Optional> files` Files to upload for the skill. diff --git a/content/en/api/java/beta/skills/versions/delete.md b/content/en/api/java/beta/skills/versions/delete.md index 2350eceac..07084e58a 100644 --- a/content/en/api/java/beta/skills/versions/delete.md +++ b/content/en/api/java/beta/skills/versions/delete.md @@ -66,6 +66,10 @@ Delete Skill Version - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class VersionDeleteResponse:` diff --git a/content/en/api/java/beta/skills/versions/list.md b/content/en/api/java/beta/skills/versions/list.md index 63b1d80e6..3eb9722d0 100644 --- a/content/en/api/java/beta/skills/versions/list.md +++ b/content/en/api/java/beta/skills/versions/list.md @@ -70,6 +70,10 @@ List Skill Versions - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class VersionListResponse:` diff --git a/content/en/api/java/beta/skills/versions/retrieve.md b/content/en/api/java/beta/skills/versions/retrieve.md index b45a94457..da3d7eaae 100644 --- a/content/en/api/java/beta/skills/versions/retrieve.md +++ b/content/en/api/java/beta/skills/versions/retrieve.md @@ -66,6 +66,10 @@ Get Skill Version - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class VersionRetrieveResponse:` diff --git a/content/en/api/java/beta/user_profiles.md b/content/en/api/java/beta/user_profiles.md new file mode 100644 index 000000000..77f12a0ef --- /dev/null +++ b/content/en/api/java/beta/user_profiles.md @@ -0,0 +1,592 @@ +# User Profiles + +## Create + +`BetaUserProfile beta().userProfiles().create(UserProfileCreateParamsparams = UserProfileCreateParams.none(), RequestOptionsrequestOptions = RequestOptions.none())` + +**post** `/v1/user_profiles` + +Create User Profile + +### Parameters + +- `UserProfileCreateParams params` + + - `Optional> betas` + + Optional header to specify the beta version(s) you want to use. + + - `MESSAGE_BATCHES_2024_09_24("message-batches-2024-09-24")` + + - `PROMPT_CACHING_2024_07_31("prompt-caching-2024-07-31")` + + - `COMPUTER_USE_2024_10_22("computer-use-2024-10-22")` + + - `COMPUTER_USE_2025_01_24("computer-use-2025-01-24")` + + - `PDFS_2024_09_25("pdfs-2024-09-25")` + + - `TOKEN_COUNTING_2024_11_01("token-counting-2024-11-01")` + + - `TOKEN_EFFICIENT_TOOLS_2025_02_19("token-efficient-tools-2025-02-19")` + + - `OUTPUT_128K_2025_02_19("output-128k-2025-02-19")` + + - `FILES_API_2025_04_14("files-api-2025-04-14")` + + - `MCP_CLIENT_2025_04_04("mcp-client-2025-04-04")` + + - `MCP_CLIENT_2025_11_20("mcp-client-2025-11-20")` + + - `DEV_FULL_THINKING_2025_05_14("dev-full-thinking-2025-05-14")` + + - `INTERLEAVED_THINKING_2025_05_14("interleaved-thinking-2025-05-14")` + + - `CODE_EXECUTION_2025_05_22("code-execution-2025-05-22")` + + - `EXTENDED_CACHE_TTL_2025_04_11("extended-cache-ttl-2025-04-11")` + + - `CONTEXT_1M_2025_08_07("context-1m-2025-08-07")` + + - `CONTEXT_MANAGEMENT_2025_06_27("context-management-2025-06-27")` + + - `MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26("model-context-window-exceeded-2025-08-26")` + + - `SKILLS_2025_10_02("skills-2025-10-02")` + + - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + + - `Optional externalId` + + - `Optional metadata` + + Free-form key-value data to attach to this user profile. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. Values must be non-empty strings. + +### Returns + +- `class BetaUserProfile:` + + - `String id` + + - `LocalDateTime createdAt` + + A timestamp in RFC 3339 format + + - `Metadata metadata` + + - `TrustGrants trustGrants` + + - `String status` + + - `String type` + + - `LocalDateTime updatedAt` + + A timestamp in RFC 3339 format + + - `Optional externalId` + +### Example + +```java +package com.anthropic.example; + +import com.anthropic.client.AnthropicClient; +import com.anthropic.client.okhttp.AnthropicOkHttpClient; +import com.anthropic.models.beta.userprofiles.BetaUserProfile; +import com.anthropic.models.beta.userprofiles.UserProfileCreateParams; + +public final class Main { + private Main() {} + + public static void main(String[] args) { + AnthropicClient client = AnthropicOkHttpClient.fromEnv(); + + BetaUserProfile betaUserProfile = client.beta().userProfiles().create(); + } +} +``` + +## List + +`UserProfileListPage beta().userProfiles().list(UserProfileListParamsparams = UserProfileListParams.none(), RequestOptionsrequestOptions = RequestOptions.none())` + +**get** `/v1/user_profiles` + +List User Profiles + +### Parameters + +- `UserProfileListParams params` + + - `Optional limit` + + Query parameter for limit + + - `Optional order` + + Query parameter for order + + - `ASC("asc")` + + - `DESC("desc")` + + - `Optional page` + + Query parameter for page + + - `Optional> betas` + + Optional header to specify the beta version(s) you want to use. + + - `MESSAGE_BATCHES_2024_09_24("message-batches-2024-09-24")` + + - `PROMPT_CACHING_2024_07_31("prompt-caching-2024-07-31")` + + - `COMPUTER_USE_2024_10_22("computer-use-2024-10-22")` + + - `COMPUTER_USE_2025_01_24("computer-use-2025-01-24")` + + - `PDFS_2024_09_25("pdfs-2024-09-25")` + + - `TOKEN_COUNTING_2024_11_01("token-counting-2024-11-01")` + + - `TOKEN_EFFICIENT_TOOLS_2025_02_19("token-efficient-tools-2025-02-19")` + + - `OUTPUT_128K_2025_02_19("output-128k-2025-02-19")` + + - `FILES_API_2025_04_14("files-api-2025-04-14")` + + - `MCP_CLIENT_2025_04_04("mcp-client-2025-04-04")` + + - `MCP_CLIENT_2025_11_20("mcp-client-2025-11-20")` + + - `DEV_FULL_THINKING_2025_05_14("dev-full-thinking-2025-05-14")` + + - `INTERLEAVED_THINKING_2025_05_14("interleaved-thinking-2025-05-14")` + + - `CODE_EXECUTION_2025_05_22("code-execution-2025-05-22")` + + - `EXTENDED_CACHE_TTL_2025_04_11("extended-cache-ttl-2025-04-11")` + + - `CONTEXT_1M_2025_08_07("context-1m-2025-08-07")` + + - `CONTEXT_MANAGEMENT_2025_06_27("context-management-2025-06-27")` + + - `MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26("model-context-window-exceeded-2025-08-26")` + + - `SKILLS_2025_10_02("skills-2025-10-02")` + + - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + +### Returns + +- `class BetaUserProfile:` + + - `String id` + + - `LocalDateTime createdAt` + + A timestamp in RFC 3339 format + + - `Metadata metadata` + + - `TrustGrants trustGrants` + + - `String status` + + - `String type` + + - `LocalDateTime updatedAt` + + A timestamp in RFC 3339 format + + - `Optional externalId` + +### Example + +```java +package com.anthropic.example; + +import com.anthropic.client.AnthropicClient; +import com.anthropic.client.okhttp.AnthropicOkHttpClient; +import com.anthropic.models.beta.userprofiles.UserProfileListPage; +import com.anthropic.models.beta.userprofiles.UserProfileListParams; + +public final class Main { + private Main() {} + + public static void main(String[] args) { + AnthropicClient client = AnthropicOkHttpClient.fromEnv(); + + UserProfileListPage page = client.beta().userProfiles().list(); + } +} +``` + +## Retrieve + +`BetaUserProfile beta().userProfiles().retrieve(UserProfileRetrieveParamsparams = UserProfileRetrieveParams.none(), RequestOptionsrequestOptions = RequestOptions.none())` + +**get** `/v1/user_profiles/{id}` + +Get User Profile + +### Parameters + +- `UserProfileRetrieveParams params` + + - `Optional id` + + - `Optional> betas` + + Optional header to specify the beta version(s) you want to use. + + - `MESSAGE_BATCHES_2024_09_24("message-batches-2024-09-24")` + + - `PROMPT_CACHING_2024_07_31("prompt-caching-2024-07-31")` + + - `COMPUTER_USE_2024_10_22("computer-use-2024-10-22")` + + - `COMPUTER_USE_2025_01_24("computer-use-2025-01-24")` + + - `PDFS_2024_09_25("pdfs-2024-09-25")` + + - `TOKEN_COUNTING_2024_11_01("token-counting-2024-11-01")` + + - `TOKEN_EFFICIENT_TOOLS_2025_02_19("token-efficient-tools-2025-02-19")` + + - `OUTPUT_128K_2025_02_19("output-128k-2025-02-19")` + + - `FILES_API_2025_04_14("files-api-2025-04-14")` + + - `MCP_CLIENT_2025_04_04("mcp-client-2025-04-04")` + + - `MCP_CLIENT_2025_11_20("mcp-client-2025-11-20")` + + - `DEV_FULL_THINKING_2025_05_14("dev-full-thinking-2025-05-14")` + + - `INTERLEAVED_THINKING_2025_05_14("interleaved-thinking-2025-05-14")` + + - `CODE_EXECUTION_2025_05_22("code-execution-2025-05-22")` + + - `EXTENDED_CACHE_TTL_2025_04_11("extended-cache-ttl-2025-04-11")` + + - `CONTEXT_1M_2025_08_07("context-1m-2025-08-07")` + + - `CONTEXT_MANAGEMENT_2025_06_27("context-management-2025-06-27")` + + - `MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26("model-context-window-exceeded-2025-08-26")` + + - `SKILLS_2025_10_02("skills-2025-10-02")` + + - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + +### Returns + +- `class BetaUserProfile:` + + - `String id` + + - `LocalDateTime createdAt` + + A timestamp in RFC 3339 format + + - `Metadata metadata` + + - `TrustGrants trustGrants` + + - `String status` + + - `String type` + + - `LocalDateTime updatedAt` + + A timestamp in RFC 3339 format + + - `Optional externalId` + +### Example + +```java +package com.anthropic.example; + +import com.anthropic.client.AnthropicClient; +import com.anthropic.client.okhttp.AnthropicOkHttpClient; +import com.anthropic.models.beta.userprofiles.BetaUserProfile; +import com.anthropic.models.beta.userprofiles.UserProfileRetrieveParams; + +public final class Main { + private Main() {} + + public static void main(String[] args) { + AnthropicClient client = AnthropicOkHttpClient.fromEnv(); + + BetaUserProfile betaUserProfile = client.beta().userProfiles().retrieve("id"); + } +} +``` + +## Update + +`BetaUserProfile beta().userProfiles().update(UserProfileUpdateParamsparams = UserProfileUpdateParams.none(), RequestOptionsrequestOptions = RequestOptions.none())` + +**post** `/v1/user_profiles/{id}` + +Update User Profile + +### Parameters + +- `UserProfileUpdateParams params` + + - `Optional id` + + - `Optional> betas` + + Optional header to specify the beta version(s) you want to use. + + - `MESSAGE_BATCHES_2024_09_24("message-batches-2024-09-24")` + + - `PROMPT_CACHING_2024_07_31("prompt-caching-2024-07-31")` + + - `COMPUTER_USE_2024_10_22("computer-use-2024-10-22")` + + - `COMPUTER_USE_2025_01_24("computer-use-2025-01-24")` + + - `PDFS_2024_09_25("pdfs-2024-09-25")` + + - `TOKEN_COUNTING_2024_11_01("token-counting-2024-11-01")` + + - `TOKEN_EFFICIENT_TOOLS_2025_02_19("token-efficient-tools-2025-02-19")` + + - `OUTPUT_128K_2025_02_19("output-128k-2025-02-19")` + + - `FILES_API_2025_04_14("files-api-2025-04-14")` + + - `MCP_CLIENT_2025_04_04("mcp-client-2025-04-04")` + + - `MCP_CLIENT_2025_11_20("mcp-client-2025-11-20")` + + - `DEV_FULL_THINKING_2025_05_14("dev-full-thinking-2025-05-14")` + + - `INTERLEAVED_THINKING_2025_05_14("interleaved-thinking-2025-05-14")` + + - `CODE_EXECUTION_2025_05_22("code-execution-2025-05-22")` + + - `EXTENDED_CACHE_TTL_2025_04_11("extended-cache-ttl-2025-04-11")` + + - `CONTEXT_1M_2025_08_07("context-1m-2025-08-07")` + + - `CONTEXT_MANAGEMENT_2025_06_27("context-management-2025-06-27")` + + - `MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26("model-context-window-exceeded-2025-08-26")` + + - `SKILLS_2025_10_02("skills-2025-10-02")` + + - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + + - `Optional externalId` + + - `Optional metadata` + + Key-value pairs to merge into the stored metadata. Keys provided overwrite existing values. To remove a key, set its value to an empty string. Keys not provided are left unchanged. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. + +### Returns + +- `class BetaUserProfile:` + + - `String id` + + - `LocalDateTime createdAt` + + A timestamp in RFC 3339 format + + - `Metadata metadata` + + - `TrustGrants trustGrants` + + - `String status` + + - `String type` + + - `LocalDateTime updatedAt` + + A timestamp in RFC 3339 format + + - `Optional externalId` + +### Example + +```java +package com.anthropic.example; + +import com.anthropic.client.AnthropicClient; +import com.anthropic.client.okhttp.AnthropicOkHttpClient; +import com.anthropic.models.beta.userprofiles.BetaUserProfile; +import com.anthropic.models.beta.userprofiles.UserProfileUpdateParams; + +public final class Main { + private Main() {} + + public static void main(String[] args) { + AnthropicClient client = AnthropicOkHttpClient.fromEnv(); + + BetaUserProfile betaUserProfile = client.beta().userProfiles().update("id"); + } +} +``` + +## Create Enrollment URL + +`BetaUserProfileEnrollmentUrl beta().userProfiles().createEnrollmentUrl(UserProfileCreateEnrollmentUrlParamsparams = UserProfileCreateEnrollmentUrlParams.none(), RequestOptionsrequestOptions = RequestOptions.none())` + +**post** `/v1/user_profiles/{id}/enrollment_url` + +Create Enrollment URL + +### Parameters + +- `UserProfileCreateEnrollmentUrlParams params` + + - `Optional id` + + - `Optional> betas` + + Optional header to specify the beta version(s) you want to use. + + - `MESSAGE_BATCHES_2024_09_24("message-batches-2024-09-24")` + + - `PROMPT_CACHING_2024_07_31("prompt-caching-2024-07-31")` + + - `COMPUTER_USE_2024_10_22("computer-use-2024-10-22")` + + - `COMPUTER_USE_2025_01_24("computer-use-2025-01-24")` + + - `PDFS_2024_09_25("pdfs-2024-09-25")` + + - `TOKEN_COUNTING_2024_11_01("token-counting-2024-11-01")` + + - `TOKEN_EFFICIENT_TOOLS_2025_02_19("token-efficient-tools-2025-02-19")` + + - `OUTPUT_128K_2025_02_19("output-128k-2025-02-19")` + + - `FILES_API_2025_04_14("files-api-2025-04-14")` + + - `MCP_CLIENT_2025_04_04("mcp-client-2025-04-04")` + + - `MCP_CLIENT_2025_11_20("mcp-client-2025-11-20")` + + - `DEV_FULL_THINKING_2025_05_14("dev-full-thinking-2025-05-14")` + + - `INTERLEAVED_THINKING_2025_05_14("interleaved-thinking-2025-05-14")` + + - `CODE_EXECUTION_2025_05_22("code-execution-2025-05-22")` + + - `EXTENDED_CACHE_TTL_2025_04_11("extended-cache-ttl-2025-04-11")` + + - `CONTEXT_1M_2025_08_07("context-1m-2025-08-07")` + + - `CONTEXT_MANAGEMENT_2025_06_27("context-management-2025-06-27")` + + - `MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26("model-context-window-exceeded-2025-08-26")` + + - `SKILLS_2025_10_02("skills-2025-10-02")` + + - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + +### Returns + +- `class BetaUserProfileEnrollmentUrl:` + + - `LocalDateTime expiresAt` + + A timestamp in RFC 3339 format + + - `String type` + + - `String url` + +### Example + +```java +package com.anthropic.example; + +import com.anthropic.client.AnthropicClient; +import com.anthropic.client.okhttp.AnthropicOkHttpClient; +import com.anthropic.models.beta.userprofiles.BetaUserProfileEnrollmentUrl; +import com.anthropic.models.beta.userprofiles.UserProfileCreateEnrollmentUrlParams; + +public final class Main { + private Main() {} + + public static void main(String[] args) { + AnthropicClient client = AnthropicOkHttpClient.fromEnv(); + + BetaUserProfileEnrollmentUrl betaUserProfileEnrollmentUrl = client.beta().userProfiles().createEnrollmentUrl("id"); + } +} +``` + +## Domain Types + +### Beta User Profile + +- `class BetaUserProfile:` + + - `String id` + + - `LocalDateTime createdAt` + + A timestamp in RFC 3339 format + + - `Metadata metadata` + + - `TrustGrants trustGrants` + + - `String status` + + - `String type` + + - `LocalDateTime updatedAt` + + A timestamp in RFC 3339 format + + - `Optional externalId` + +### Beta User Profile Enrollment URL + +- `class BetaUserProfileEnrollmentUrl:` + + - `LocalDateTime expiresAt` + + A timestamp in RFC 3339 format + + - `String type` + + - `String url` + +### Beta User Profile Trust Grant + +- `class BetaUserProfileTrustGrant:` + + - `String status` diff --git a/content/en/api/java/beta/user_profiles/create.md b/content/en/api/java/beta/user_profiles/create.md new file mode 100644 index 000000000..1d494a464 --- /dev/null +++ b/content/en/api/java/beta/user_profiles/create.md @@ -0,0 +1,110 @@ +## Create + +`BetaUserProfile beta().userProfiles().create(UserProfileCreateParamsparams = UserProfileCreateParams.none(), RequestOptionsrequestOptions = RequestOptions.none())` + +**post** `/v1/user_profiles` + +Create User Profile + +### Parameters + +- `UserProfileCreateParams params` + + - `Optional> betas` + + Optional header to specify the beta version(s) you want to use. + + - `MESSAGE_BATCHES_2024_09_24("message-batches-2024-09-24")` + + - `PROMPT_CACHING_2024_07_31("prompt-caching-2024-07-31")` + + - `COMPUTER_USE_2024_10_22("computer-use-2024-10-22")` + + - `COMPUTER_USE_2025_01_24("computer-use-2025-01-24")` + + - `PDFS_2024_09_25("pdfs-2024-09-25")` + + - `TOKEN_COUNTING_2024_11_01("token-counting-2024-11-01")` + + - `TOKEN_EFFICIENT_TOOLS_2025_02_19("token-efficient-tools-2025-02-19")` + + - `OUTPUT_128K_2025_02_19("output-128k-2025-02-19")` + + - `FILES_API_2025_04_14("files-api-2025-04-14")` + + - `MCP_CLIENT_2025_04_04("mcp-client-2025-04-04")` + + - `MCP_CLIENT_2025_11_20("mcp-client-2025-11-20")` + + - `DEV_FULL_THINKING_2025_05_14("dev-full-thinking-2025-05-14")` + + - `INTERLEAVED_THINKING_2025_05_14("interleaved-thinking-2025-05-14")` + + - `CODE_EXECUTION_2025_05_22("code-execution-2025-05-22")` + + - `EXTENDED_CACHE_TTL_2025_04_11("extended-cache-ttl-2025-04-11")` + + - `CONTEXT_1M_2025_08_07("context-1m-2025-08-07")` + + - `CONTEXT_MANAGEMENT_2025_06_27("context-management-2025-06-27")` + + - `MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26("model-context-window-exceeded-2025-08-26")` + + - `SKILLS_2025_10_02("skills-2025-10-02")` + + - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + + - `Optional externalId` + + - `Optional metadata` + + Free-form key-value data to attach to this user profile. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. Values must be non-empty strings. + +### Returns + +- `class BetaUserProfile:` + + - `String id` + + - `LocalDateTime createdAt` + + A timestamp in RFC 3339 format + + - `Metadata metadata` + + - `TrustGrants trustGrants` + + - `String status` + + - `String type` + + - `LocalDateTime updatedAt` + + A timestamp in RFC 3339 format + + - `Optional externalId` + +### Example + +```java +package com.anthropic.example; + +import com.anthropic.client.AnthropicClient; +import com.anthropic.client.okhttp.AnthropicOkHttpClient; +import com.anthropic.models.beta.userprofiles.BetaUserProfile; +import com.anthropic.models.beta.userprofiles.UserProfileCreateParams; + +public final class Main { + private Main() {} + + public static void main(String[] args) { + AnthropicClient client = AnthropicOkHttpClient.fromEnv(); + + BetaUserProfile betaUserProfile = client.beta().userProfiles().create(); + } +} +``` diff --git a/content/en/api/java/beta/user_profiles/create_enrollment_url.md b/content/en/api/java/beta/user_profiles/create_enrollment_url.md new file mode 100644 index 000000000..0acd95aab --- /dev/null +++ b/content/en/api/java/beta/user_profiles/create_enrollment_url.md @@ -0,0 +1,94 @@ +## Create Enrollment URL + +`BetaUserProfileEnrollmentUrl beta().userProfiles().createEnrollmentUrl(UserProfileCreateEnrollmentUrlParamsparams = UserProfileCreateEnrollmentUrlParams.none(), RequestOptionsrequestOptions = RequestOptions.none())` + +**post** `/v1/user_profiles/{id}/enrollment_url` + +Create Enrollment URL + +### Parameters + +- `UserProfileCreateEnrollmentUrlParams params` + + - `Optional id` + + - `Optional> betas` + + Optional header to specify the beta version(s) you want to use. + + - `MESSAGE_BATCHES_2024_09_24("message-batches-2024-09-24")` + + - `PROMPT_CACHING_2024_07_31("prompt-caching-2024-07-31")` + + - `COMPUTER_USE_2024_10_22("computer-use-2024-10-22")` + + - `COMPUTER_USE_2025_01_24("computer-use-2025-01-24")` + + - `PDFS_2024_09_25("pdfs-2024-09-25")` + + - `TOKEN_COUNTING_2024_11_01("token-counting-2024-11-01")` + + - `TOKEN_EFFICIENT_TOOLS_2025_02_19("token-efficient-tools-2025-02-19")` + + - `OUTPUT_128K_2025_02_19("output-128k-2025-02-19")` + + - `FILES_API_2025_04_14("files-api-2025-04-14")` + + - `MCP_CLIENT_2025_04_04("mcp-client-2025-04-04")` + + - `MCP_CLIENT_2025_11_20("mcp-client-2025-11-20")` + + - `DEV_FULL_THINKING_2025_05_14("dev-full-thinking-2025-05-14")` + + - `INTERLEAVED_THINKING_2025_05_14("interleaved-thinking-2025-05-14")` + + - `CODE_EXECUTION_2025_05_22("code-execution-2025-05-22")` + + - `EXTENDED_CACHE_TTL_2025_04_11("extended-cache-ttl-2025-04-11")` + + - `CONTEXT_1M_2025_08_07("context-1m-2025-08-07")` + + - `CONTEXT_MANAGEMENT_2025_06_27("context-management-2025-06-27")` + + - `MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26("model-context-window-exceeded-2025-08-26")` + + - `SKILLS_2025_10_02("skills-2025-10-02")` + + - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + +### Returns + +- `class BetaUserProfileEnrollmentUrl:` + + - `LocalDateTime expiresAt` + + A timestamp in RFC 3339 format + + - `String type` + + - `String url` + +### Example + +```java +package com.anthropic.example; + +import com.anthropic.client.AnthropicClient; +import com.anthropic.client.okhttp.AnthropicOkHttpClient; +import com.anthropic.models.beta.userprofiles.BetaUserProfileEnrollmentUrl; +import com.anthropic.models.beta.userprofiles.UserProfileCreateEnrollmentUrlParams; + +public final class Main { + private Main() {} + + public static void main(String[] args) { + AnthropicClient client = AnthropicOkHttpClient.fromEnv(); + + BetaUserProfileEnrollmentUrl betaUserProfileEnrollmentUrl = client.beta().userProfiles().createEnrollmentUrl("id"); + } +} +``` diff --git a/content/en/api/java/beta/user_profiles/list.md b/content/en/api/java/beta/user_profiles/list.md new file mode 100644 index 000000000..e266652ae --- /dev/null +++ b/content/en/api/java/beta/user_profiles/list.md @@ -0,0 +1,120 @@ +## List + +`UserProfileListPage beta().userProfiles().list(UserProfileListParamsparams = UserProfileListParams.none(), RequestOptionsrequestOptions = RequestOptions.none())` + +**get** `/v1/user_profiles` + +List User Profiles + +### Parameters + +- `UserProfileListParams params` + + - `Optional limit` + + Query parameter for limit + + - `Optional order` + + Query parameter for order + + - `ASC("asc")` + + - `DESC("desc")` + + - `Optional page` + + Query parameter for page + + - `Optional> betas` + + Optional header to specify the beta version(s) you want to use. + + - `MESSAGE_BATCHES_2024_09_24("message-batches-2024-09-24")` + + - `PROMPT_CACHING_2024_07_31("prompt-caching-2024-07-31")` + + - `COMPUTER_USE_2024_10_22("computer-use-2024-10-22")` + + - `COMPUTER_USE_2025_01_24("computer-use-2025-01-24")` + + - `PDFS_2024_09_25("pdfs-2024-09-25")` + + - `TOKEN_COUNTING_2024_11_01("token-counting-2024-11-01")` + + - `TOKEN_EFFICIENT_TOOLS_2025_02_19("token-efficient-tools-2025-02-19")` + + - `OUTPUT_128K_2025_02_19("output-128k-2025-02-19")` + + - `FILES_API_2025_04_14("files-api-2025-04-14")` + + - `MCP_CLIENT_2025_04_04("mcp-client-2025-04-04")` + + - `MCP_CLIENT_2025_11_20("mcp-client-2025-11-20")` + + - `DEV_FULL_THINKING_2025_05_14("dev-full-thinking-2025-05-14")` + + - `INTERLEAVED_THINKING_2025_05_14("interleaved-thinking-2025-05-14")` + + - `CODE_EXECUTION_2025_05_22("code-execution-2025-05-22")` + + - `EXTENDED_CACHE_TTL_2025_04_11("extended-cache-ttl-2025-04-11")` + + - `CONTEXT_1M_2025_08_07("context-1m-2025-08-07")` + + - `CONTEXT_MANAGEMENT_2025_06_27("context-management-2025-06-27")` + + - `MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26("model-context-window-exceeded-2025-08-26")` + + - `SKILLS_2025_10_02("skills-2025-10-02")` + + - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + +### Returns + +- `class BetaUserProfile:` + + - `String id` + + - `LocalDateTime createdAt` + + A timestamp in RFC 3339 format + + - `Metadata metadata` + + - `TrustGrants trustGrants` + + - `String status` + + - `String type` + + - `LocalDateTime updatedAt` + + A timestamp in RFC 3339 format + + - `Optional externalId` + +### Example + +```java +package com.anthropic.example; + +import com.anthropic.client.AnthropicClient; +import com.anthropic.client.okhttp.AnthropicOkHttpClient; +import com.anthropic.models.beta.userprofiles.UserProfileListPage; +import com.anthropic.models.beta.userprofiles.UserProfileListParams; + +public final class Main { + private Main() {} + + public static void main(String[] args) { + AnthropicClient client = AnthropicOkHttpClient.fromEnv(); + + UserProfileListPage page = client.beta().userProfiles().list(); + } +} +``` diff --git a/content/en/api/java/beta/user_profiles/retrieve.md b/content/en/api/java/beta/user_profiles/retrieve.md new file mode 100644 index 000000000..45c2fea67 --- /dev/null +++ b/content/en/api/java/beta/user_profiles/retrieve.md @@ -0,0 +1,106 @@ +## Retrieve + +`BetaUserProfile beta().userProfiles().retrieve(UserProfileRetrieveParamsparams = UserProfileRetrieveParams.none(), RequestOptionsrequestOptions = RequestOptions.none())` + +**get** `/v1/user_profiles/{id}` + +Get User Profile + +### Parameters + +- `UserProfileRetrieveParams params` + + - `Optional id` + + - `Optional> betas` + + Optional header to specify the beta version(s) you want to use. + + - `MESSAGE_BATCHES_2024_09_24("message-batches-2024-09-24")` + + - `PROMPT_CACHING_2024_07_31("prompt-caching-2024-07-31")` + + - `COMPUTER_USE_2024_10_22("computer-use-2024-10-22")` + + - `COMPUTER_USE_2025_01_24("computer-use-2025-01-24")` + + - `PDFS_2024_09_25("pdfs-2024-09-25")` + + - `TOKEN_COUNTING_2024_11_01("token-counting-2024-11-01")` + + - `TOKEN_EFFICIENT_TOOLS_2025_02_19("token-efficient-tools-2025-02-19")` + + - `OUTPUT_128K_2025_02_19("output-128k-2025-02-19")` + + - `FILES_API_2025_04_14("files-api-2025-04-14")` + + - `MCP_CLIENT_2025_04_04("mcp-client-2025-04-04")` + + - `MCP_CLIENT_2025_11_20("mcp-client-2025-11-20")` + + - `DEV_FULL_THINKING_2025_05_14("dev-full-thinking-2025-05-14")` + + - `INTERLEAVED_THINKING_2025_05_14("interleaved-thinking-2025-05-14")` + + - `CODE_EXECUTION_2025_05_22("code-execution-2025-05-22")` + + - `EXTENDED_CACHE_TTL_2025_04_11("extended-cache-ttl-2025-04-11")` + + - `CONTEXT_1M_2025_08_07("context-1m-2025-08-07")` + + - `CONTEXT_MANAGEMENT_2025_06_27("context-management-2025-06-27")` + + - `MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26("model-context-window-exceeded-2025-08-26")` + + - `SKILLS_2025_10_02("skills-2025-10-02")` + + - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + +### Returns + +- `class BetaUserProfile:` + + - `String id` + + - `LocalDateTime createdAt` + + A timestamp in RFC 3339 format + + - `Metadata metadata` + + - `TrustGrants trustGrants` + + - `String status` + + - `String type` + + - `LocalDateTime updatedAt` + + A timestamp in RFC 3339 format + + - `Optional externalId` + +### Example + +```java +package com.anthropic.example; + +import com.anthropic.client.AnthropicClient; +import com.anthropic.client.okhttp.AnthropicOkHttpClient; +import com.anthropic.models.beta.userprofiles.BetaUserProfile; +import com.anthropic.models.beta.userprofiles.UserProfileRetrieveParams; + +public final class Main { + private Main() {} + + public static void main(String[] args) { + AnthropicClient client = AnthropicOkHttpClient.fromEnv(); + + BetaUserProfile betaUserProfile = client.beta().userProfiles().retrieve("id"); + } +} +``` diff --git a/content/en/api/java/beta/user_profiles/update.md b/content/en/api/java/beta/user_profiles/update.md new file mode 100644 index 000000000..6ce5b48ba --- /dev/null +++ b/content/en/api/java/beta/user_profiles/update.md @@ -0,0 +1,112 @@ +## Update + +`BetaUserProfile beta().userProfiles().update(UserProfileUpdateParamsparams = UserProfileUpdateParams.none(), RequestOptionsrequestOptions = RequestOptions.none())` + +**post** `/v1/user_profiles/{id}` + +Update User Profile + +### Parameters + +- `UserProfileUpdateParams params` + + - `Optional id` + + - `Optional> betas` + + Optional header to specify the beta version(s) you want to use. + + - `MESSAGE_BATCHES_2024_09_24("message-batches-2024-09-24")` + + - `PROMPT_CACHING_2024_07_31("prompt-caching-2024-07-31")` + + - `COMPUTER_USE_2024_10_22("computer-use-2024-10-22")` + + - `COMPUTER_USE_2025_01_24("computer-use-2025-01-24")` + + - `PDFS_2024_09_25("pdfs-2024-09-25")` + + - `TOKEN_COUNTING_2024_11_01("token-counting-2024-11-01")` + + - `TOKEN_EFFICIENT_TOOLS_2025_02_19("token-efficient-tools-2025-02-19")` + + - `OUTPUT_128K_2025_02_19("output-128k-2025-02-19")` + + - `FILES_API_2025_04_14("files-api-2025-04-14")` + + - `MCP_CLIENT_2025_04_04("mcp-client-2025-04-04")` + + - `MCP_CLIENT_2025_11_20("mcp-client-2025-11-20")` + + - `DEV_FULL_THINKING_2025_05_14("dev-full-thinking-2025-05-14")` + + - `INTERLEAVED_THINKING_2025_05_14("interleaved-thinking-2025-05-14")` + + - `CODE_EXECUTION_2025_05_22("code-execution-2025-05-22")` + + - `EXTENDED_CACHE_TTL_2025_04_11("extended-cache-ttl-2025-04-11")` + + - `CONTEXT_1M_2025_08_07("context-1m-2025-08-07")` + + - `CONTEXT_MANAGEMENT_2025_06_27("context-management-2025-06-27")` + + - `MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26("model-context-window-exceeded-2025-08-26")` + + - `SKILLS_2025_10_02("skills-2025-10-02")` + + - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + + - `Optional externalId` + + - `Optional metadata` + + Key-value pairs to merge into the stored metadata. Keys provided overwrite existing values. To remove a key, set its value to an empty string. Keys not provided are left unchanged. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. + +### Returns + +- `class BetaUserProfile:` + + - `String id` + + - `LocalDateTime createdAt` + + A timestamp in RFC 3339 format + + - `Metadata metadata` + + - `TrustGrants trustGrants` + + - `String status` + + - `String type` + + - `LocalDateTime updatedAt` + + A timestamp in RFC 3339 format + + - `Optional externalId` + +### Example + +```java +package com.anthropic.example; + +import com.anthropic.client.AnthropicClient; +import com.anthropic.client.okhttp.AnthropicOkHttpClient; +import com.anthropic.models.beta.userprofiles.BetaUserProfile; +import com.anthropic.models.beta.userprofiles.UserProfileUpdateParams; + +public final class Main { + private Main() {} + + public static void main(String[] args) { + AnthropicClient client = AnthropicOkHttpClient.fromEnv(); + + BetaUserProfile betaUserProfile = client.beta().userProfiles().update("id"); + } +} +``` diff --git a/content/en/api/java/completions.md b/content/en/api/java/completions.md index 4348df055..913221e75 100644 --- a/content/en/api/java/completions.md +++ b/content/en/api/java/completions.md @@ -60,6 +60,10 @@ Future models and features will not be compatible with Text Completions. See our - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + - `long maxTokensToSample` The maximum number of tokens to generate before stopping. diff --git a/content/en/api/java/completions/create.md b/content/en/api/java/completions/create.md index 28fd9fbe1..b49aebd23 100644 --- a/content/en/api/java/completions/create.md +++ b/content/en/api/java/completions/create.md @@ -58,6 +58,10 @@ Future models and features will not be compatible with Text Completions. See our - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + - `long maxTokensToSample` The maximum number of tokens to generate before stopping. diff --git a/content/en/api/java/messages.md b/content/en/api/java/messages.md index f4f75f7d8..1408ca041 100644 --- a/content/en/api/java/messages.md +++ b/content/en/api/java/messages.md @@ -4383,6 +4383,30 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. @@ -13849,6 +13873,30 @@ public final class Main { - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. @@ -18286,6 +18334,30 @@ public final class Main { The time at which the container will expire. + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` - `END_TURN("end_turn")` @@ -19129,6 +19201,30 @@ public final class Main { - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. @@ -20033,6 +20129,30 @@ public final class Main { - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. @@ -20160,6 +20280,30 @@ public final class Main { The time at which the container will expire. + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` - `END_TURN("end_turn")` @@ -21058,6 +21202,32 @@ public final class Main { - `REDACTED_THINKING("redacted_thinking")` +### Refusal Stop Details + +- `class RefusalStopDetails:` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + ### Search Result Block Param - `class SearchResultBlockParam:` @@ -31883,6 +32053,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. @@ -33129,6 +33323,30 @@ public final class Main { - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. @@ -34161,6 +34379,30 @@ public final class Main { - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. @@ -35155,6 +35397,30 @@ public final class Main { - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. diff --git a/content/en/api/java/messages/batches.md b/content/en/api/java/messages/batches.md index 315c3d441..7515cc09c 100644 --- a/content/en/api/java/messages/batches.md +++ b/content/en/api/java/messages/batches.md @@ -5226,6 +5226,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. @@ -6472,6 +6496,30 @@ public final class Main { - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. @@ -7504,6 +7552,30 @@ public final class Main { - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. @@ -8498,6 +8570,30 @@ public final class Main { - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. diff --git a/content/en/api/java/messages/batches/results.md b/content/en/api/java/messages/batches/results.md index 1f7c1a5eb..2da46ca61 100644 --- a/content/en/api/java/messages/batches/results.md +++ b/content/en/api/java/messages/batches/results.md @@ -817,6 +817,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. diff --git a/content/en/api/java/messages/create.md b/content/en/api/java/messages/create.md index a6c500d56..a6516ff83 100644 --- a/content/en/api/java/messages/create.md +++ b/content/en/api/java/messages/create.md @@ -4381,6 +4381,30 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `ASSISTANT("assistant")` + - `Optional stopDetails` + + Structured information about a refusal. + + - `Optional category` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `CYBER("cyber")` + + - `BIO("bio")` + + - `Optional explanation` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `JsonValue; type "refusal"constant` + + - `REFUSAL("refusal")` + - `Optional stopReason` The reason that we stopped. diff --git a/content/en/api/java/models.md b/content/en/api/java/models.md index 7f29efae4..6c5304e02 100644 --- a/content/en/api/java/models.md +++ b/content/en/api/java/models.md @@ -72,6 +72,10 @@ The Models API response can be used to determine which models are available for - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class ModelInfo:` @@ -339,6 +343,10 @@ The Models API response can be used to determine information about a specific mo - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class ModelInfo:` diff --git a/content/en/api/java/models/list.md b/content/en/api/java/models/list.md index 9f6eb8db3..60c07fc8c 100644 --- a/content/en/api/java/models/list.md +++ b/content/en/api/java/models/list.md @@ -70,6 +70,10 @@ The Models API response can be used to determine which models are available for - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class ModelInfo:` diff --git a/content/en/api/java/models/retrieve.md b/content/en/api/java/models/retrieve.md index 21dfdab36..19cfb7e03 100644 --- a/content/en/api/java/models/retrieve.md +++ b/content/en/api/java/models/retrieve.md @@ -60,6 +60,10 @@ The Models API response can be used to determine information about a specific mo - `FAST_MODE_2026_02_01("fast-mode-2026-02-01")` + - `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")` + + - `USER_PROFILES_2026_03_24("user-profiles-2026-03-24")` + ### Returns - `class ModelInfo:` diff --git a/content/en/api/messages.md b/content/en/api/messages.md index 7285caa0a..c26e42149 100644 --- a/content/en/api/messages.md +++ b/content/en/api/messages.md @@ -3819,7 +3819,7 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en ### Returns -- `Message = object { id, container, content, 6 more }` +- `Message = object { id, container, content, 7 more }` - `id: string` @@ -4606,6 +4606,30 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `"assistant"` + - `stop_details: RefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: StopReason` The reason that we stopped. @@ -13481,7 +13505,7 @@ curl https://api.anthropic.com/v1/messages/count_tokens \ ### Message -- `Message = object { id, container, content, 6 more }` +- `Message = object { id, container, content, 7 more }` - `id: string` @@ -14268,6 +14292,30 @@ curl https://api.anthropic.com/v1/messages/count_tokens \ - `"assistant"` + - `stop_details: RefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: StopReason` The reason that we stopped. @@ -18767,7 +18815,7 @@ curl https://api.anthropic.com/v1/messages/count_tokens \ - `RawMessageDeltaEvent = object { delta, type, usage }` - - `delta: object { container, stop_reason, stop_sequence }` + - `delta: object { container, stop_details, stop_reason, stop_sequence }` - `container: Container` @@ -18781,6 +18829,30 @@ curl https://api.anthropic.com/v1/messages/count_tokens \ The time at which the container will expire. + - `stop_details: RefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: StopReason` - `"end_turn"` @@ -19632,6 +19704,30 @@ curl https://api.anthropic.com/v1/messages/count_tokens \ - `"assistant"` + - `stop_details: RefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: StopReason` The reason that we stopped. @@ -20544,6 +20640,30 @@ curl https://api.anthropic.com/v1/messages/count_tokens \ - `"assistant"` + - `stop_details: RefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: StopReason` The reason that we stopped. @@ -20657,7 +20777,7 @@ curl https://api.anthropic.com/v1/messages/count_tokens \ - `RawMessageDeltaEvent = object { delta, type, usage }` - - `delta: object { container, stop_reason, stop_sequence }` + - `delta: object { container, stop_details, stop_reason, stop_sequence }` - `container: Container` @@ -20671,6 +20791,30 @@ curl https://api.anthropic.com/v1/messages/count_tokens \ The time at which the container will expire. + - `stop_details: RefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: StopReason` - `"end_turn"` @@ -21569,6 +21713,32 @@ curl https://api.anthropic.com/v1/messages/count_tokens \ - `"redacted_thinking"` +### Refusal Stop Details + +- `RefusalStopDetails = object { category, explanation, type }` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + ### Search Result Block Param - `SearchResultBlockParam = object { content, source, title, 3 more }` @@ -32342,6 +32512,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"assistant"` + - `stop_details: RefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: StopReason` The reason that we stopped. @@ -33582,6 +33776,30 @@ curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID/results \ - `"assistant"` + - `stop_details: RefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: StopReason` The reason that we stopped. @@ -34622,6 +34840,30 @@ curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID/results \ - `"assistant"` + - `stop_details: RefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: StopReason` The reason that we stopped. @@ -35624,6 +35866,30 @@ curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID/results \ - `"assistant"` + - `stop_details: RefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: StopReason` The reason that we stopped. diff --git a/content/en/api/messages/batches.md b/content/en/api/messages/batches.md index b8ba25833..80b31374b 100644 --- a/content/en/api/messages/batches.md +++ b/content/en/api/messages/batches.md @@ -5174,6 +5174,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"assistant"` + - `stop_details: RefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: StopReason` The reason that we stopped. @@ -6414,6 +6438,30 @@ curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID/results \ - `"assistant"` + - `stop_details: RefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: StopReason` The reason that we stopped. @@ -7454,6 +7502,30 @@ curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID/results \ - `"assistant"` + - `stop_details: RefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: StopReason` The reason that we stopped. @@ -8456,6 +8528,30 @@ curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID/results \ - `"assistant"` + - `stop_details: RefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: StopReason` The reason that we stopped. diff --git a/content/en/api/messages/batches/results.md b/content/en/api/messages/batches/results.md index dd986d7fa..dfa847144 100644 --- a/content/en/api/messages/batches/results.md +++ b/content/en/api/messages/batches/results.md @@ -821,6 +821,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"assistant"` + - `stop_details: RefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: StopReason` The reason that we stopped. diff --git a/content/en/api/messages/create.md b/content/en/api/messages/create.md index 9111b176d..1dcad7039 100644 --- a/content/en/api/messages/create.md +++ b/content/en/api/messages/create.md @@ -3817,7 +3817,7 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en ### Returns -- `Message = object { id, container, content, 6 more }` +- `Message = object { id, container, content, 7 more }` - `id: string` @@ -4604,6 +4604,30 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `"assistant"` + - `stop_details: RefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" or "bio"` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: StopReason` The reason that we stopped. diff --git a/content/en/api/models.md b/content/en/api/models.md index 6dc81558c..a5459f9fe 100644 --- a/content/en/api/models.md +++ b/content/en/api/models.md @@ -32,7 +32,7 @@ The Models API response can be used to determine which models are available for - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -74,6 +74,10 @@ The Models API response can be used to determine which models are available for - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `data: array of ModelInfo` @@ -300,7 +304,7 @@ The Models API response can be used to determine information about a specific mo - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -342,6 +346,10 @@ The Models API response can be used to determine information about a specific mo - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `ModelInfo = object { id, capabilities, created_at, 4 more }` diff --git a/content/en/api/models/list.md b/content/en/api/models/list.md index 8ef15a953..def238a7b 100644 --- a/content/en/api/models/list.md +++ b/content/en/api/models/list.md @@ -30,7 +30,7 @@ The Models API response can be used to determine which models are available for - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -72,6 +72,10 @@ The Models API response can be used to determine which models are available for - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `data: array of ModelInfo` diff --git a/content/en/api/models/retrieve.md b/content/en/api/models/retrieve.md index 86b7b068a..f1f9ec547 100644 --- a/content/en/api/models/retrieve.md +++ b/content/en/api/models/retrieve.md @@ -20,7 +20,7 @@ The Models API response can be used to determine information about a specific mo - `UnionMember0 = string` - - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more` + - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more` - `"message-batches-2024-09-24"` @@ -62,6 +62,10 @@ The Models API response can be used to determine information about a specific mo - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `ModelInfo = object { id, capabilities, created_at, 4 more }` diff --git a/content/en/api/overview.md b/content/en/api/overview.md index 52778c5c2..9b3e66d98 100644 --- a/content/en/api/overview.md +++ b/content/en/api/overview.md @@ -95,7 +95,7 @@ Access Claude through AWS, Google Cloud, or Microsoft Azure: | Platform | Provider | Documentation | |----------|----------|---------------| -| Amazon Bedrock | AWS | [Claude on Amazon Bedrock](/docs/en/build-with-claude/claude-on-amazon-bedrock) | +| Amazon Bedrock | AWS | [Claude in Amazon Bedrock](/docs/en/build-with-claude/claude-in-amazon-bedrock) | | Vertex AI | Google Cloud | [Claude on Vertex AI](/docs/en/build-with-claude/claude-on-vertex-ai) | | Azure AI | Microsoft Azure | [Claude on Azure AI](/docs/en/build-with-claude/claude-in-microsoft-foundry) | diff --git a/content/en/api/php/beta.md b/content/en/api/php/beta.md index a09c5ecd1..0f1c2f42e 100644 --- a/content/en/api/php/beta.md +++ b/content/en/api/php/beta.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                    \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                      \ No newline at end of file diff --git a/content/en/api/php/beta/files.md b/content/en/api/php/beta/files.md index d39e5b4fe..2ae6834ce 100644 --- a/content/en/api/php/beta/files.md +++ b/content/en/api/php/beta/files.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                        \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                          \ No newline at end of file diff --git a/content/en/api/php/beta/files/delete.md b/content/en/api/php/beta/files/delete.md index 68c1913a0..34b1c0cb0 100644 --- a/content/en/api/php/beta/files/delete.md +++ b/content/en/api/php/beta/files/delete.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                            \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                              \ No newline at end of file diff --git a/content/en/api/php/beta/files/download.md b/content/en/api/php/beta/files/download.md index d5d217e9e..c13194408 100644 --- a/content/en/api/php/beta/files/download.md +++ b/content/en/api/php/beta/files/download.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                  \ No newline at end of file diff --git a/content/en/api/php/beta/files/list.md b/content/en/api/php/beta/files/list.md index fe4ec1567..c80b52d30 100644 --- a/content/en/api/php/beta/files/list.md +++ b/content/en/api/php/beta/files/list.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                    \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                      \ No newline at end of file diff --git a/content/en/api/php/beta/files/retrieve_metadata.md b/content/en/api/php/beta/files/retrieve_metadata.md index 9293bd3b9..9b54ada1e 100644 --- a/content/en/api/php/beta/files/retrieve_metadata.md +++ b/content/en/api/php/beta/files/retrieve_metadata.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                        \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                          \ No newline at end of file diff --git a/content/en/api/php/beta/files/upload.md b/content/en/api/php/beta/files/upload.md index 31ab47dfc..2d457caa3 100644 --- a/content/en/api/php/beta/files/upload.md +++ b/content/en/api/php/beta/files/upload.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                            \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                              \ No newline at end of file diff --git a/content/en/api/php/beta/messages.md b/content/en/api/php/beta/messages.md index bf5031d6d..56603ebb9 100644 --- a/content/en/api/php/beta/messages.md +++ b/content/en/api/php/beta/messages.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                  \ No newline at end of file diff --git a/content/en/api/php/beta/messages/batches.md b/content/en/api/php/beta/messages/batches.md index 6e977e2f3..1bf2266b1 100644 --- a/content/en/api/php/beta/messages/batches.md +++ b/content/en/api/php/beta/messages/batches.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                    \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                      \ No newline at end of file diff --git a/content/en/api/php/beta/messages/batches/cancel.md b/content/en/api/php/beta/messages/batches/cancel.md index fc75be412..c5cf4e971 100644 --- a/content/en/api/php/beta/messages/batches/cancel.md +++ b/content/en/api/php/beta/messages/batches/cancel.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                        \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                          \ No newline at end of file diff --git a/content/en/api/php/beta/messages/batches/create.md b/content/en/api/php/beta/messages/batches/create.md index 6a55afd8c..f8d00abfa 100644 --- a/content/en/api/php/beta/messages/batches/create.md +++ b/content/en/api/php/beta/messages/batches/create.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                            \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                              \ No newline at end of file diff --git a/content/en/api/php/beta/messages/batches/delete.md b/content/en/api/php/beta/messages/batches/delete.md index 09fd962a7..bee3be146 100644 --- a/content/en/api/php/beta/messages/batches/delete.md +++ b/content/en/api/php/beta/messages/batches/delete.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                  \ No newline at end of file diff --git a/content/en/api/php/beta/messages/batches/list.md b/content/en/api/php/beta/messages/batches/list.md index 5ee3b58af..b8be02177 100644 --- a/content/en/api/php/beta/messages/batches/list.md +++ b/content/en/api/php/beta/messages/batches/list.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                    \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                      \ No newline at end of file diff --git a/content/en/api/php/beta/messages/batches/results.md b/content/en/api/php/beta/messages/batches/results.md index 01ee5fee1..4548aa51b 100644 --- a/content/en/api/php/beta/messages/batches/results.md +++ b/content/en/api/php/beta/messages/batches/results.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                        \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                          \ No newline at end of file diff --git a/content/en/api/php/beta/messages/batches/retrieve.md b/content/en/api/php/beta/messages/batches/retrieve.md index fde544baf..b83863753 100644 --- a/content/en/api/php/beta/messages/batches/retrieve.md +++ b/content/en/api/php/beta/messages/batches/retrieve.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                            \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                              \ No newline at end of file diff --git a/content/en/api/php/beta/messages/count_tokens.md b/content/en/api/php/beta/messages/count_tokens.md index aed43945f..014585ad7 100644 --- a/content/en/api/php/beta/messages/count_tokens.md +++ b/content/en/api/php/beta/messages/count_tokens.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                  \ No newline at end of file diff --git a/content/en/api/php/beta/messages/create.md b/content/en/api/php/beta/messages/create.md index 0ef6a3a29..05b238043 100644 --- a/content/en/api/php/beta/messages/create.md +++ b/content/en/api/php/beta/messages/create.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                    \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                      \ No newline at end of file diff --git a/content/en/api/php/beta/models.md b/content/en/api/php/beta/models.md index 40114bc81..143f5b078 100644 --- a/content/en/api/php/beta/models.md +++ b/content/en/api/php/beta/models.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                        \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                          \ No newline at end of file diff --git a/content/en/api/php/beta/models/list.md b/content/en/api/php/beta/models/list.md index 30d8036cb..b47bb613c 100644 --- a/content/en/api/php/beta/models/list.md +++ b/content/en/api/php/beta/models/list.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                            \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                              \ No newline at end of file diff --git a/content/en/api/php/beta/models/retrieve.md b/content/en/api/php/beta/models/retrieve.md index 0e8538039..e376e4ad0 100644 --- a/content/en/api/php/beta/models/retrieve.md +++ b/content/en/api/php/beta/models/retrieve.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                  \ No newline at end of file diff --git a/content/en/api/php/beta/skills.md b/content/en/api/php/beta/skills.md index 15277f783..b0f9e9ffb 100644 --- a/content/en/api/php/beta/skills.md +++ b/content/en/api/php/beta/skills.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                    \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                      \ No newline at end of file diff --git a/content/en/api/php/beta/skills/create.md b/content/en/api/php/beta/skills/create.md index 677d82850..67dbff7c4 100644 --- a/content/en/api/php/beta/skills/create.md +++ b/content/en/api/php/beta/skills/create.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                        \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                          \ No newline at end of file diff --git a/content/en/api/php/beta/skills/delete.md b/content/en/api/php/beta/skills/delete.md index 3c1308cf9..8ae059d8e 100644 --- a/content/en/api/php/beta/skills/delete.md +++ b/content/en/api/php/beta/skills/delete.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                            \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                              \ No newline at end of file diff --git a/content/en/api/php/beta/skills/list.md b/content/en/api/php/beta/skills/list.md index eed2c025d..d957d3235 100644 --- a/content/en/api/php/beta/skills/list.md +++ b/content/en/api/php/beta/skills/list.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                  \ No newline at end of file diff --git a/content/en/api/php/beta/skills/retrieve.md b/content/en/api/php/beta/skills/retrieve.md index 64638437c..425270b9f 100644 --- a/content/en/api/php/beta/skills/retrieve.md +++ b/content/en/api/php/beta/skills/retrieve.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                    \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                      \ No newline at end of file diff --git a/content/en/api/php/beta/skills/versions.md b/content/en/api/php/beta/skills/versions.md index 940d9eb62..6b630222d 100644 --- a/content/en/api/php/beta/skills/versions.md +++ b/content/en/api/php/beta/skills/versions.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                        \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                          \ No newline at end of file diff --git a/content/en/api/php/beta/skills/versions/create.md b/content/en/api/php/beta/skills/versions/create.md index 5e236f7f1..00a376067 100644 --- a/content/en/api/php/beta/skills/versions/create.md +++ b/content/en/api/php/beta/skills/versions/create.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                            \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                              \ No newline at end of file diff --git a/content/en/api/php/beta/skills/versions/delete.md b/content/en/api/php/beta/skills/versions/delete.md index def994eb1..6c7790c29 100644 --- a/content/en/api/php/beta/skills/versions/delete.md +++ b/content/en/api/php/beta/skills/versions/delete.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                  \ No newline at end of file diff --git a/content/en/api/php/beta/skills/versions/list.md b/content/en/api/php/beta/skills/versions/list.md index c6641b772..f6cc11f82 100644 --- a/content/en/api/php/beta/skills/versions/list.md +++ b/content/en/api/php/beta/skills/versions/list.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                    \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                      \ No newline at end of file diff --git a/content/en/api/php/beta/skills/versions/retrieve.md b/content/en/api/php/beta/skills/versions/retrieve.md index 4559f44b0..a3b467db8 100644 --- a/content/en/api/php/beta/skills/versions/retrieve.md +++ b/content/en/api/php/beta/skills/versions/retrieve.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                        \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                          \ No newline at end of file diff --git a/content/en/api/php/beta/user_profiles.md b/content/en/api/php/beta/user_profiles.md new file mode 100644 index 000000000..90b1f52cb --- /dev/null +++ b/content/en/api/php/beta/user_profiles.md @@ -0,0 +1 @@ +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                            \ No newline at end of file diff --git a/content/en/api/php/beta/user_profiles/create.md b/content/en/api/php/beta/user_profiles/create.md new file mode 100644 index 000000000..19c81b761 --- /dev/null +++ b/content/en/api/php/beta/user_profiles/create.md @@ -0,0 +1 @@ +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                              \ No newline at end of file diff --git a/content/en/api/php/beta/user_profiles/create_enrollment_url.md b/content/en/api/php/beta/user_profiles/create_enrollment_url.md new file mode 100644 index 000000000..46ed0943f --- /dev/null +++ b/content/en/api/php/beta/user_profiles/create_enrollment_url.md @@ -0,0 +1 @@ +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                \ No newline at end of file diff --git a/content/en/api/php/beta/user_profiles/list.md b/content/en/api/php/beta/user_profiles/list.md new file mode 100644 index 000000000..310a57487 --- /dev/null +++ b/content/en/api/php/beta/user_profiles/list.md @@ -0,0 +1 @@ +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                  \ No newline at end of file diff --git a/content/en/api/php/beta/user_profiles/retrieve.md b/content/en/api/php/beta/user_profiles/retrieve.md new file mode 100644 index 000000000..884b69081 --- /dev/null +++ b/content/en/api/php/beta/user_profiles/retrieve.md @@ -0,0 +1 @@ +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                    \ No newline at end of file diff --git a/content/en/api/php/beta/user_profiles/update.md b/content/en/api/php/beta/user_profiles/update.md new file mode 100644 index 000000000..a179757ce --- /dev/null +++ b/content/en/api/php/beta/user_profiles/update.md @@ -0,0 +1 @@ +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                      \ No newline at end of file diff --git a/content/en/api/php/completions.md b/content/en/api/php/completions.md index e7659f6f8..78e408a9a 100644 --- a/content/en/api/php/completions.md +++ b/content/en/api/php/completions.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                        \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                          \ No newline at end of file diff --git a/content/en/api/php/completions/create.md b/content/en/api/php/completions/create.md index bafd46d62..e951b16a7 100644 --- a/content/en/api/php/completions/create.md +++ b/content/en/api/php/completions/create.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                            \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                              \ No newline at end of file diff --git a/content/en/api/php/messages.md b/content/en/api/php/messages.md index 37800ed6b..2dcf24595 100644 --- a/content/en/api/php/messages.md +++ b/content/en/api/php/messages.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                  \ No newline at end of file diff --git a/content/en/api/php/messages/batches.md b/content/en/api/php/messages/batches.md index 22559b7a0..d70f6114e 100644 --- a/content/en/api/php/messages/batches.md +++ b/content/en/api/php/messages/batches.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                    \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                      \ No newline at end of file diff --git a/content/en/api/php/messages/batches/cancel.md b/content/en/api/php/messages/batches/cancel.md index 5205cb2e7..a175b77b6 100644 --- a/content/en/api/php/messages/batches/cancel.md +++ b/content/en/api/php/messages/batches/cancel.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                        \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                          \ No newline at end of file diff --git a/content/en/api/php/messages/batches/create.md b/content/en/api/php/messages/batches/create.md index 090edc95d..c75589a3c 100644 --- a/content/en/api/php/messages/batches/create.md +++ b/content/en/api/php/messages/batches/create.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                            \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                              \ No newline at end of file diff --git a/content/en/api/php/messages/batches/delete.md b/content/en/api/php/messages/batches/delete.md index 5483731f6..234950a9f 100644 --- a/content/en/api/php/messages/batches/delete.md +++ b/content/en/api/php/messages/batches/delete.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                  \ No newline at end of file diff --git a/content/en/api/php/messages/batches/list.md b/content/en/api/php/messages/batches/list.md index 36a5ad749..4e854a263 100644 --- a/content/en/api/php/messages/batches/list.md +++ b/content/en/api/php/messages/batches/list.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                    \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                      \ No newline at end of file diff --git a/content/en/api/php/messages/batches/results.md b/content/en/api/php/messages/batches/results.md index 296542085..7b4a26ebe 100644 --- a/content/en/api/php/messages/batches/results.md +++ b/content/en/api/php/messages/batches/results.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                        \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                          \ No newline at end of file diff --git a/content/en/api/php/messages/batches/retrieve.md b/content/en/api/php/messages/batches/retrieve.md index f90a891b2..730e51723 100644 --- a/content/en/api/php/messages/batches/retrieve.md +++ b/content/en/api/php/messages/batches/retrieve.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                            \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                              \ No newline at end of file diff --git a/content/en/api/php/messages/count_tokens.md b/content/en/api/php/messages/count_tokens.md index 96b924db8..d51f7692a 100644 --- a/content/en/api/php/messages/count_tokens.md +++ b/content/en/api/php/messages/count_tokens.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                  \ No newline at end of file diff --git a/content/en/api/php/messages/create.md b/content/en/api/php/messages/create.md index 15f481f04..408ebb984 100644 --- a/content/en/api/php/messages/create.md +++ b/content/en/api/php/messages/create.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                    \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                      \ No newline at end of file diff --git a/content/en/api/php/models.md b/content/en/api/php/models.md index b75e18115..83d0ce88f 100644 --- a/content/en/api/php/models.md +++ b/content/en/api/php/models.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                        \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                          \ No newline at end of file diff --git a/content/en/api/php/models/list.md b/content/en/api/php/models/list.md index f506c0e19..1ede4c256 100644 --- a/content/en/api/php/models/list.md +++ b/content/en/api/php/models/list.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                            \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                              \ No newline at end of file diff --git a/content/en/api/php/models/retrieve.md b/content/en/api/php/models/retrieve.md index e42307d58..abf087584 100644 --- a/content/en/api/php/models/retrieve.md +++ b/content/en/api/php/models/retrieve.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                  \ No newline at end of file diff --git a/content/en/api/python/beta.md b/content/en/api/python/beta.md index 80759e632..940a78c19 100644 --- a/content/en/api/python/beta.md +++ b/content/en/api/python/beta.md @@ -4,11 +4,11 @@ ### Anthropic Beta -- `Union[str, Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]]` +- `Union[str, Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]]` - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -50,6 +50,10 @@ - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Beta API Error - `class BetaAPIError: …` @@ -334,7 +338,7 @@ The Models API response can be used to determine which models are available for - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -376,6 +380,10 @@ The Models API response can be used to determine which models are available for - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class BetaModelInfo: …` @@ -596,7 +604,7 @@ The Models API response can be used to determine information about a specific mo - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -638,6 +646,10 @@ The Models API response can be used to determine information about a specific mo - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class BetaModelInfo: …` @@ -4273,7 +4285,7 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `"fast"` -- `stop_sequences: Optional[SequenceNotStr[str]]` +- `stop_sequences: Optional[Sequence[str]]` Custom text sequences that will cause the model to stop generating. @@ -6011,13 +6023,17 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en Recommended for advanced use cases only. You usually only need to use `temperature`. +- `user_profile_id: Optional[str]` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + - `betas: Optional[List[AnthropicBetaParam]]` Optional header to specify the beta version(s) you want to use. - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -6059,6 +6075,10 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class BetaMessage: …` @@ -7074,6 +7094,30 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `"assistant"` + - `stop_details: Optional[BetaRefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[BetaStopReason]` The reason that we stopped. @@ -11893,7 +11937,7 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -11935,6 +11979,10 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageTokensCount: …` @@ -19247,6 +19295,30 @@ print(beta_message_tokens_count.context_management) - `"assistant"` + - `stop_details: Optional[BetaRefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[BetaStopReason]` The reason that we stopped. @@ -23392,6 +23464,30 @@ print(beta_message_tokens_count.context_management) Skill version or 'latest' for most recent version + - `stop_details: Optional[BetaRefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[BetaStopReason]` - `"end_turn"` @@ -24559,6 +24655,30 @@ print(beta_message_tokens_count.context_management) - `"assistant"` + - `stop_details: Optional[BetaRefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[BetaStopReason]` The reason that we stopped. @@ -25795,6 +25915,30 @@ print(beta_message_tokens_count.context_management) - `"assistant"` + - `stop_details: Optional[BetaRefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[BetaStopReason]` The reason that we stopped. @@ -26080,6 +26224,30 @@ print(beta_message_tokens_count.context_management) Skill version or 'latest' for most recent version + - `stop_details: Optional[BetaRefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[BetaStopReason]` - `"end_turn"` @@ -27224,6 +27392,32 @@ print(beta_message_tokens_count.context_management) - `"redacted_thinking"` +### Beta Refusal Stop Details + +- `class BetaRefusalStopDetails: …` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + ### Beta Request Document Block - `class BetaRequestDocumentBlock: …` @@ -37142,7 +37336,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast"` - - `stop_sequences: Optional[SequenceNotStr[str]]` + - `stop_sequences: Optional[Sequence[str]]` Custom text sequences that will cause the model to stop generating. @@ -38878,13 +39072,17 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Recommended for advanced use cases only. You usually only need to use `temperature`. + - `user_profile_id: Optional[str]` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + - `betas: Optional[List[AnthropicBetaParam]]` Optional header to specify the beta version(s) you want to use. - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -38926,6 +39124,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatch: …` @@ -39063,7 +39265,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -39105,6 +39307,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatch: …` @@ -39242,7 +39448,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -39284,175 +39490,183 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` -### Returns - -- `class BetaMessageBatch: …` - - - `id: str` - - Unique object identifier. - - The format and length of IDs may change over time. - - - `archived_at: Optional[datetime]` - - RFC 3339 datetime string representing the time at which the Message Batch was archived and its results became unavailable. - - - `cancel_initiated_at: Optional[datetime]` - - RFC 3339 datetime string representing the time at which cancellation was initiated for the Message Batch. Specified only if cancellation was initiated. - - - `created_at: datetime` - - RFC 3339 datetime string representing the time at which the Message Batch was created. - - - `ended_at: Optional[datetime]` - - RFC 3339 datetime string representing the time at which processing for the Message Batch ended. Specified only once processing ends. - - Processing ends when every request in a Message Batch has either succeeded, errored, canceled, or expired. - - - `expires_at: datetime` + - `"output-300k-2026-03-24"` - RFC 3339 datetime string representing the time at which the Message Batch will expire and end processing, which is 24 hours after creation. - - - `processing_status: Literal["in_progress", "canceling", "ended"]` - - Processing status of the Message Batch. - - - `"in_progress"` - - - `"canceling"` - - - `"ended"` - - - `request_counts: BetaMessageBatchRequestCounts` - - Tallies requests within the Message Batch, categorized by their status. - - Requests start as `processing` and move to one of the other statuses only once processing of the entire batch ends. The sum of all values always matches the total number of requests in the batch. - - - `canceled: int` - - Number of requests in the Message Batch that have been canceled. - - This is zero until processing of the entire Message Batch has ended. - - - `errored: int` - - Number of requests in the Message Batch that encountered an error. - - This is zero until processing of the entire Message Batch has ended. - - - `expired: int` - - Number of requests in the Message Batch that have expired. - - This is zero until processing of the entire Message Batch has ended. - - - `processing: int` - - Number of requests in the Message Batch that are processing. - - - `succeeded: int` - - Number of requests in the Message Batch that have completed successfully. - - This is zero until processing of the entire Message Batch has ended. - - - `results_url: Optional[str]` - - URL to a `.jsonl` file containing the results of the Message Batch requests. Specified only once processing ends. - - Results in the file are not guaranteed to be in the same order as requests. Use the `custom_id` field to match results to requests. - - - `type: Literal["message_batch"]` - - Object type. - - For Message Batches, this is always `"message_batch"`. - - - `"message_batch"` - -### Example - -```python -import os -from anthropic import Anthropic - -client = Anthropic( - api_key=os.environ.get("ANTHROPIC_API_KEY"), # This is the default and can be omitted -) -page = client.beta.messages.batches.list() -page = page.data[0] -print(page.id) -``` - -## Cancel - -`beta.messages.batches.cancel(strmessage_batch_id, BatchCancelParams**kwargs) -> BetaMessageBatch` - -**post** `/v1/messages/batches/{message_batch_id}/cancel` - -Batches may be canceled any time before processing ends. Once cancellation is initiated, the batch enters a `canceling` state, at which time the system may complete any in-progress, non-interruptible requests before finalizing cancellation. - -The number of canceled requests is specified in `request_counts`. To determine which requests were canceled, check the individual results within the batch. Note that cancellation may not result in any canceled requests if they were non-interruptible. - -Learn more about the Message Batches API in our [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing) - -### Parameters - -- `message_batch_id: str` - - ID of the Message Batch. - -- `betas: Optional[List[AnthropicBetaParam]]` - - Optional header to specify the beta version(s) you want to use. - - - `str` - - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` - - - `"message-batches-2024-09-24"` - - - `"prompt-caching-2024-07-31"` - - - `"computer-use-2024-10-22"` - - - `"computer-use-2025-01-24"` - - - `"pdfs-2024-09-25"` - - - `"token-counting-2024-11-01"` - - - `"token-efficient-tools-2025-02-19"` - - - `"output-128k-2025-02-19"` - - - `"files-api-2025-04-14"` - - - `"mcp-client-2025-04-04"` - - - `"mcp-client-2025-11-20"` - - - `"dev-full-thinking-2025-05-14"` - - - `"interleaved-thinking-2025-05-14"` - - - `"code-execution-2025-05-22"` - - - `"extended-cache-ttl-2025-04-11"` - - - `"context-1m-2025-08-07"` - - - `"context-management-2025-06-27"` - - - `"model-context-window-exceeded-2025-08-26"` - - - `"skills-2025-10-02"` - - - `"fast-mode-2026-02-01"` + - `"user-profiles-2026-03-24"` + +### Returns + +- `class BetaMessageBatch: …` + + - `id: str` + + Unique object identifier. + + The format and length of IDs may change over time. + + - `archived_at: Optional[datetime]` + + RFC 3339 datetime string representing the time at which the Message Batch was archived and its results became unavailable. + + - `cancel_initiated_at: Optional[datetime]` + + RFC 3339 datetime string representing the time at which cancellation was initiated for the Message Batch. Specified only if cancellation was initiated. + + - `created_at: datetime` + + RFC 3339 datetime string representing the time at which the Message Batch was created. + + - `ended_at: Optional[datetime]` + + RFC 3339 datetime string representing the time at which processing for the Message Batch ended. Specified only once processing ends. + + Processing ends when every request in a Message Batch has either succeeded, errored, canceled, or expired. + + - `expires_at: datetime` + + RFC 3339 datetime string representing the time at which the Message Batch will expire and end processing, which is 24 hours after creation. + + - `processing_status: Literal["in_progress", "canceling", "ended"]` + + Processing status of the Message Batch. + + - `"in_progress"` + + - `"canceling"` + + - `"ended"` + + - `request_counts: BetaMessageBatchRequestCounts` + + Tallies requests within the Message Batch, categorized by their status. + + Requests start as `processing` and move to one of the other statuses only once processing of the entire batch ends. The sum of all values always matches the total number of requests in the batch. + + - `canceled: int` + + Number of requests in the Message Batch that have been canceled. + + This is zero until processing of the entire Message Batch has ended. + + - `errored: int` + + Number of requests in the Message Batch that encountered an error. + + This is zero until processing of the entire Message Batch has ended. + + - `expired: int` + + Number of requests in the Message Batch that have expired. + + This is zero until processing of the entire Message Batch has ended. + + - `processing: int` + + Number of requests in the Message Batch that are processing. + + - `succeeded: int` + + Number of requests in the Message Batch that have completed successfully. + + This is zero until processing of the entire Message Batch has ended. + + - `results_url: Optional[str]` + + URL to a `.jsonl` file containing the results of the Message Batch requests. Specified only once processing ends. + + Results in the file are not guaranteed to be in the same order as requests. Use the `custom_id` field to match results to requests. + + - `type: Literal["message_batch"]` + + Object type. + + For Message Batches, this is always `"message_batch"`. + + - `"message_batch"` + +### Example + +```python +import os +from anthropic import Anthropic + +client = Anthropic( + api_key=os.environ.get("ANTHROPIC_API_KEY"), # This is the default and can be omitted +) +page = client.beta.messages.batches.list() +page = page.data[0] +print(page.id) +``` + +## Cancel + +`beta.messages.batches.cancel(strmessage_batch_id, BatchCancelParams**kwargs) -> BetaMessageBatch` + +**post** `/v1/messages/batches/{message_batch_id}/cancel` + +Batches may be canceled any time before processing ends. Once cancellation is initiated, the batch enters a `canceling` state, at which time the system may complete any in-progress, non-interruptible requests before finalizing cancellation. + +The number of canceled requests is specified in `request_counts`. To determine which requests were canceled, check the individual results within the batch. Note that cancellation may not result in any canceled requests if they were non-interruptible. + +Learn more about the Message Batches API in our [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing) + +### Parameters + +- `message_batch_id: str` + + ID of the Message Batch. + +- `betas: Optional[List[AnthropicBetaParam]]` + + Optional header to specify the beta version(s) you want to use. + + - `str` + + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` ### Returns @@ -39583,7 +39797,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -39625,6 +39839,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class BetaDeletedMessageBatch: …` @@ -39680,7 +39898,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -39722,6 +39940,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatchIndividualResponse: …` @@ -40755,6 +40977,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"assistant"` + - `stop_details: Optional[BetaRefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[BetaStopReason]` The reason that we stopped. @@ -42326,6 +42572,30 @@ for batch in client.beta.messages.batches.results( - `"assistant"` + - `stop_details: Optional[BetaRefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[BetaStopReason]` The reason that we stopped. @@ -43690,6 +43960,30 @@ for batch in client.beta.messages.batches.results( - `"assistant"` + - `stop_details: Optional[BetaRefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[BetaStopReason]` The reason that we stopped. @@ -45016,6 +45310,30 @@ for batch in client.beta.messages.batches.results( - `"assistant"` + - `stop_details: Optional[BetaRefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[BetaStopReason]` The reason that we stopped. @@ -45247,7 +45565,7 @@ Upload File - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -45289,130 +45607,138 @@ Upload File - `"fast-mode-2026-02-01"` -### Returns - -- `class FileMetadata: …` - - - `id: str` - - Unique object identifier. - - The format and length of IDs may change over time. - - - `created_at: datetime` - - RFC 3339 datetime string representing when the file was created. - - - `filename: str` + - `"output-300k-2026-03-24"` - Original filename of the uploaded file. - - - `mime_type: str` - - MIME type of the file. - - - `size_bytes: int` - - Size of the file in bytes. - - - `type: Literal["file"]` - - Object type. - - For files, this is always `"file"`. - - - `"file"` - - - `downloadable: Optional[bool]` - - Whether the file can be downloaded. - -### Example - -```python -import os -from anthropic import Anthropic - -client = Anthropic( - api_key=os.environ.get("ANTHROPIC_API_KEY"), # This is the default and can be omitted -) -file_metadata = client.beta.files.upload( - file=b"Example data", -) -print(file_metadata.id) -``` - -## List - -`beta.files.list(FileListParams**kwargs) -> SyncPage[FileMetadata]` - -**get** `/v1/files` - -List Files - -### Parameters - -- `after_id: Optional[str]` - - ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object. - -- `before_id: Optional[str]` - - ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object. - -- `limit: Optional[int]` - - Number of items to return per page. - - Defaults to `20`. Ranges from `1` to `1000`. - -- `betas: Optional[List[AnthropicBetaParam]]` - - Optional header to specify the beta version(s) you want to use. - - - `str` - - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` - - - `"message-batches-2024-09-24"` - - - `"prompt-caching-2024-07-31"` - - - `"computer-use-2024-10-22"` - - - `"computer-use-2025-01-24"` - - - `"pdfs-2024-09-25"` - - - `"token-counting-2024-11-01"` - - - `"token-efficient-tools-2025-02-19"` - - - `"output-128k-2025-02-19"` - - - `"files-api-2025-04-14"` - - - `"mcp-client-2025-04-04"` - - - `"mcp-client-2025-11-20"` - - - `"dev-full-thinking-2025-05-14"` - - - `"interleaved-thinking-2025-05-14"` - - - `"code-execution-2025-05-22"` - - - `"extended-cache-ttl-2025-04-11"` - - - `"context-1m-2025-08-07"` - - - `"context-management-2025-06-27"` - - - `"model-context-window-exceeded-2025-08-26"` - - - `"skills-2025-10-02"` - - - `"fast-mode-2026-02-01"` + - `"user-profiles-2026-03-24"` + +### Returns + +- `class FileMetadata: …` + + - `id: str` + + Unique object identifier. + + The format and length of IDs may change over time. + + - `created_at: datetime` + + RFC 3339 datetime string representing when the file was created. + + - `filename: str` + + Original filename of the uploaded file. + + - `mime_type: str` + + MIME type of the file. + + - `size_bytes: int` + + Size of the file in bytes. + + - `type: Literal["file"]` + + Object type. + + For files, this is always `"file"`. + + - `"file"` + + - `downloadable: Optional[bool]` + + Whether the file can be downloaded. + +### Example + +```python +import os +from anthropic import Anthropic + +client = Anthropic( + api_key=os.environ.get("ANTHROPIC_API_KEY"), # This is the default and can be omitted +) +file_metadata = client.beta.files.upload( + file=b"Example data", +) +print(file_metadata.id) +``` + +## List + +`beta.files.list(FileListParams**kwargs) -> SyncPage[FileMetadata]` + +**get** `/v1/files` + +List Files + +### Parameters + +- `after_id: Optional[str]` + + ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object. + +- `before_id: Optional[str]` + + ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object. + +- `limit: Optional[int]` + + Number of items to return per page. + + Defaults to `20`. Ranges from `1` to `1000`. + +- `betas: Optional[List[AnthropicBetaParam]]` + + Optional header to specify the beta version(s) you want to use. + + - `str` + + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` ### Returns @@ -45486,7 +45812,7 @@ Download File - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -45528,6 +45854,10 @@ Download File - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BinaryResponseContent` @@ -45569,7 +45899,7 @@ Get File Metadata - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -45611,6 +45941,10 @@ Get File Metadata - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class FileMetadata: …` @@ -45684,7 +46018,7 @@ Delete File - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -45726,6 +46060,10 @@ Delete File - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class DeletedFile: …` @@ -45831,7 +46169,7 @@ Create Skill This is a human-readable label that is not included in the prompt sent to the model. -- `files: Optional[SequenceNotStr[FileTypes]]` +- `files: Optional[Sequence[FileTypes]]` Files to upload for the skill. @@ -45843,7 +46181,7 @@ Create Skill - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -45885,146 +46223,154 @@ Create Skill - `"fast-mode-2026-02-01"` -### Returns - -- `class SkillCreateResponse: …` - - - `id: str` - - Unique identifier for the skill. - - The format and length of IDs may change over time. - - - `created_at: str` - - ISO 8601 timestamp of when the skill was created. - - - `display_title: Optional[str]` - - Display title for the skill. - - This is a human-readable label that is not included in the prompt sent to the model. - - - `latest_version: Optional[str]` - - The latest version identifier for the skill. - - This represents the most recent version of the skill that has been created. - - - `source: str` - - Source of the skill. - - This may be one of the following values: - - * `"custom"`: the skill was created by a user - * `"anthropic"`: the skill was created by Anthropic - - - `type: str` - - Object type. - - For Skills, this is always `"skill"`. - - - `updated_at: str` - - ISO 8601 timestamp of when the skill was last updated. - -### Example - -```python -import os -from anthropic import Anthropic - -client = Anthropic( - api_key=os.environ.get("ANTHROPIC_API_KEY"), # This is the default and can be omitted -) -skill = client.beta.skills.create() -print(skill.id) -``` - -## List - -`beta.skills.list(SkillListParams**kwargs) -> SyncPageCursor[SkillListResponse]` - -**get** `/v1/skills` - -List Skills - -### Parameters - -- `limit: Optional[int]` + - `"output-300k-2026-03-24"` - Number of results to return per page. - - Maximum value is 100. Defaults to 20. - -- `page: Optional[str]` - - Pagination token for fetching a specific page of results. - - Pass the value from a previous response's `next_page` field to get the next page of results. - -- `source: Optional[str]` - - Filter skills by source. - - If provided, only skills from the specified source will be returned: - - * `"custom"`: only return user-created skills - * `"anthropic"`: only return Anthropic-created skills - -- `betas: Optional[List[AnthropicBetaParam]]` - - Optional header to specify the beta version(s) you want to use. - - - `str` - - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` - - - `"message-batches-2024-09-24"` - - - `"prompt-caching-2024-07-31"` - - - `"computer-use-2024-10-22"` - - - `"computer-use-2025-01-24"` - - - `"pdfs-2024-09-25"` - - - `"token-counting-2024-11-01"` - - - `"token-efficient-tools-2025-02-19"` - - - `"output-128k-2025-02-19"` - - - `"files-api-2025-04-14"` - - - `"mcp-client-2025-04-04"` - - - `"mcp-client-2025-11-20"` - - - `"dev-full-thinking-2025-05-14"` - - - `"interleaved-thinking-2025-05-14"` - - - `"code-execution-2025-05-22"` - - - `"extended-cache-ttl-2025-04-11"` - - - `"context-1m-2025-08-07"` - - - `"context-management-2025-06-27"` - - - `"model-context-window-exceeded-2025-08-26"` - - - `"skills-2025-10-02"` - - - `"fast-mode-2026-02-01"` + - `"user-profiles-2026-03-24"` ### Returns -- `class SkillListResponse: …` +- `class SkillCreateResponse: …` + + - `id: str` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + + - `created_at: str` + + ISO 8601 timestamp of when the skill was created. + + - `display_title: Optional[str]` + + Display title for the skill. + + This is a human-readable label that is not included in the prompt sent to the model. + + - `latest_version: Optional[str]` + + The latest version identifier for the skill. + + This represents the most recent version of the skill that has been created. + + - `source: str` + + Source of the skill. + + This may be one of the following values: + + * `"custom"`: the skill was created by a user + * `"anthropic"`: the skill was created by Anthropic + + - `type: str` + + Object type. + + For Skills, this is always `"skill"`. + + - `updated_at: str` + + ISO 8601 timestamp of when the skill was last updated. + +### Example + +```python +import os +from anthropic import Anthropic + +client = Anthropic( + api_key=os.environ.get("ANTHROPIC_API_KEY"), # This is the default and can be omitted +) +skill = client.beta.skills.create() +print(skill.id) +``` + +## List + +`beta.skills.list(SkillListParams**kwargs) -> SyncPageCursor[SkillListResponse]` + +**get** `/v1/skills` + +List Skills + +### Parameters + +- `limit: Optional[int]` + + Number of results to return per page. + + Maximum value is 100. Defaults to 20. + +- `page: Optional[str]` + + Pagination token for fetching a specific page of results. + + Pass the value from a previous response's `next_page` field to get the next page of results. + +- `source: Optional[str]` + + Filter skills by source. + + If provided, only skills from the specified source will be returned: + + * `"custom"`: only return user-created skills + * `"anthropic"`: only return Anthropic-created skills + +- `betas: Optional[List[AnthropicBetaParam]]` + + Optional header to specify the beta version(s) you want to use. + + - `str` + + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `class SkillListResponse: …` - `id: str` @@ -46103,7 +46449,7 @@ Get Skill - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -46145,6 +46491,10 @@ Get Skill - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class SkillRetrieveResponse: …` @@ -46227,7 +46577,7 @@ Delete Skill - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -46269,6 +46619,10 @@ Delete Skill - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class SkillDeleteResponse: …` @@ -46300,6 +46654,159 @@ skill = client.beta.skills.delete( print(skill.id) ``` +## Domain Types + +### Skill Create Response + +- `class SkillCreateResponse: …` + + - `id: str` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + + - `created_at: str` + + ISO 8601 timestamp of when the skill was created. + + - `display_title: Optional[str]` + + Display title for the skill. + + This is a human-readable label that is not included in the prompt sent to the model. + + - `latest_version: Optional[str]` + + The latest version identifier for the skill. + + This represents the most recent version of the skill that has been created. + + - `source: str` + + Source of the skill. + + This may be one of the following values: + + * `"custom"`: the skill was created by a user + * `"anthropic"`: the skill was created by Anthropic + + - `type: str` + + Object type. + + For Skills, this is always `"skill"`. + + - `updated_at: str` + + ISO 8601 timestamp of when the skill was last updated. + +### Skill List Response + +- `class SkillListResponse: …` + + - `id: str` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + + - `created_at: str` + + ISO 8601 timestamp of when the skill was created. + + - `display_title: Optional[str]` + + Display title for the skill. + + This is a human-readable label that is not included in the prompt sent to the model. + + - `latest_version: Optional[str]` + + The latest version identifier for the skill. + + This represents the most recent version of the skill that has been created. + + - `source: str` + + Source of the skill. + + This may be one of the following values: + + * `"custom"`: the skill was created by a user + * `"anthropic"`: the skill was created by Anthropic + + - `type: str` + + Object type. + + For Skills, this is always `"skill"`. + + - `updated_at: str` + + ISO 8601 timestamp of when the skill was last updated. + +### Skill Retrieve Response + +- `class SkillRetrieveResponse: …` + + - `id: str` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + + - `created_at: str` + + ISO 8601 timestamp of when the skill was created. + + - `display_title: Optional[str]` + + Display title for the skill. + + This is a human-readable label that is not included in the prompt sent to the model. + + - `latest_version: Optional[str]` + + The latest version identifier for the skill. + + This represents the most recent version of the skill that has been created. + + - `source: str` + + Source of the skill. + + This may be one of the following values: + + * `"custom"`: the skill was created by a user + * `"anthropic"`: the skill was created by Anthropic + + - `type: str` + + Object type. + + For Skills, this is always `"skill"`. + + - `updated_at: str` + + ISO 8601 timestamp of when the skill was last updated. + +### Skill Delete Response + +- `class SkillDeleteResponse: …` + + - `id: str` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + + - `type: str` + + Deleted object type. + + For Skills, this is always `"skill_deleted"`. + # Versions ## Create @@ -46318,7 +46825,7 @@ Create Skill Version The format and length of IDs may change over time. -- `files: Optional[SequenceNotStr[FileTypes]]` +- `files: Optional[Sequence[FileTypes]]` Files to upload for the skill. @@ -46330,7 +46837,7 @@ Create Skill Version - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -46372,6 +46879,10 @@ Create Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class VersionCreateResponse: …` @@ -46467,7 +46978,7 @@ List Skill Versions - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -46509,6 +47020,10 @@ List Skill Versions - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class VersionListResponse: …` @@ -46601,7 +47116,7 @@ Get Skill Version - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -46643,6 +47158,10 @@ Get Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class VersionRetrieveResponse: …` @@ -46735,7 +47254,7 @@ Delete Skill Version - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -46777,6 +47296,10 @@ Delete Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class VersionDeleteResponse: …` @@ -46808,3 +47331,735 @@ version = client.beta.skills.versions.delete( ) print(version.id) ``` + +## Domain Types + +### Version Create Response + +- `class VersionCreateResponse: …` + + - `id: str` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: str` + + ISO 8601 timestamp of when the skill version was created. + + - `description: str` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: str` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: str` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: str` + + Identifier for the skill that this version belongs to. + + - `type: str` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: str` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version List Response + +- `class VersionListResponse: …` + + - `id: str` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: str` + + ISO 8601 timestamp of when the skill version was created. + + - `description: str` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: str` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: str` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: str` + + Identifier for the skill that this version belongs to. + + - `type: str` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: str` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version Retrieve Response + +- `class VersionRetrieveResponse: …` + + - `id: str` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: str` + + ISO 8601 timestamp of when the skill version was created. + + - `description: str` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: str` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: str` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: str` + + Identifier for the skill that this version belongs to. + + - `type: str` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: str` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version Delete Response + +- `class VersionDeleteResponse: …` + + - `id: str` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + + - `type: str` + + Deleted object type. + + For Skill Versions, this is always `"skill_version_deleted"`. + +# User Profiles + +## Create + +`beta.user_profiles.create(UserProfileCreateParams**kwargs) -> BetaUserProfile` + +**post** `/v1/user_profiles` + +Create User Profile + +### Parameters + +- `external_id: Optional[str]` + +- `metadata: Optional[Dict[str, str]]` + + Free-form key-value data to attach to this user profile. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. Values must be non-empty strings. + +- `betas: Optional[List[AnthropicBetaParam]]` + + Optional header to specify the beta version(s) you want to use. + + - `str` + + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `class BetaUserProfile: …` + + - `id: str` + + - `created_at: datetime` + + A timestamp in RFC 3339 format + + - `metadata: Dict[str, str]` + + - `trust_grants: Dict[str, BetaUserProfileTrustGrant]` + + - `status: str` + + - `type: str` + + - `updated_at: datetime` + + A timestamp in RFC 3339 format + + - `external_id: Optional[str]` + +### Example + +```python +import os +from anthropic import Anthropic + +client = Anthropic( + api_key=os.environ.get("ANTHROPIC_API_KEY"), # This is the default and can be omitted +) +beta_user_profile = client.beta.user_profiles.create() +print(beta_user_profile.id) +``` + +## List + +`beta.user_profiles.list(UserProfileListParams**kwargs) -> SyncPageCursorV2[BetaUserProfile]` + +**get** `/v1/user_profiles` + +List User Profiles + +### Parameters + +- `limit: Optional[int]` + + Query parameter for limit + +- `order: Optional[Literal["asc", "desc"]]` + + Query parameter for order + + - `"asc"` + + - `"desc"` + +- `page: Optional[str]` + + Query parameter for page + +- `betas: Optional[List[AnthropicBetaParam]]` + + Optional header to specify the beta version(s) you want to use. + + - `str` + + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `class BetaUserProfile: …` + + - `id: str` + + - `created_at: datetime` + + A timestamp in RFC 3339 format + + - `metadata: Dict[str, str]` + + - `trust_grants: Dict[str, BetaUserProfileTrustGrant]` + + - `status: str` + + - `type: str` + + - `updated_at: datetime` + + A timestamp in RFC 3339 format + + - `external_id: Optional[str]` + +### Example + +```python +import os +from anthropic import Anthropic + +client = Anthropic( + api_key=os.environ.get("ANTHROPIC_API_KEY"), # This is the default and can be omitted +) +page = client.beta.user_profiles.list() +page = page.data[0] +print(page.id) +``` + +## Retrieve + +`beta.user_profiles.retrieve(strid, UserProfileRetrieveParams**kwargs) -> BetaUserProfile` + +**get** `/v1/user_profiles/{id}` + +Get User Profile + +### Parameters + +- `id: str` + +- `betas: Optional[List[AnthropicBetaParam]]` + + Optional header to specify the beta version(s) you want to use. + + - `str` + + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `class BetaUserProfile: …` + + - `id: str` + + - `created_at: datetime` + + A timestamp in RFC 3339 format + + - `metadata: Dict[str, str]` + + - `trust_grants: Dict[str, BetaUserProfileTrustGrant]` + + - `status: str` + + - `type: str` + + - `updated_at: datetime` + + A timestamp in RFC 3339 format + + - `external_id: Optional[str]` + +### Example + +```python +import os +from anthropic import Anthropic + +client = Anthropic( + api_key=os.environ.get("ANTHROPIC_API_KEY"), # This is the default and can be omitted +) +beta_user_profile = client.beta.user_profiles.retrieve( + id="id", +) +print(beta_user_profile.id) +``` + +## Update + +`beta.user_profiles.update(strid, UserProfileUpdateParams**kwargs) -> BetaUserProfile` + +**post** `/v1/user_profiles/{id}` + +Update User Profile + +### Parameters + +- `id: str` + +- `external_id: Optional[str]` + +- `metadata: Optional[Dict[str, str]]` + + Key-value pairs to merge into the stored metadata. Keys provided overwrite existing values. To remove a key, set its value to an empty string. Keys not provided are left unchanged. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. + +- `betas: Optional[List[AnthropicBetaParam]]` + + Optional header to specify the beta version(s) you want to use. + + - `str` + + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `class BetaUserProfile: …` + + - `id: str` + + - `created_at: datetime` + + A timestamp in RFC 3339 format + + - `metadata: Dict[str, str]` + + - `trust_grants: Dict[str, BetaUserProfileTrustGrant]` + + - `status: str` + + - `type: str` + + - `updated_at: datetime` + + A timestamp in RFC 3339 format + + - `external_id: Optional[str]` + +### Example + +```python +import os +from anthropic import Anthropic + +client = Anthropic( + api_key=os.environ.get("ANTHROPIC_API_KEY"), # This is the default and can be omitted +) +beta_user_profile = client.beta.user_profiles.update( + id="id", +) +print(beta_user_profile.id) +``` + +## Create Enrollment URL + +`beta.user_profiles.create_enrollment_url(strid, UserProfileCreateEnrollmentURLParams**kwargs) -> BetaUserProfileEnrollmentURL` + +**post** `/v1/user_profiles/{id}/enrollment_url` + +Create Enrollment URL + +### Parameters + +- `id: str` + +- `betas: Optional[List[AnthropicBetaParam]]` + + Optional header to specify the beta version(s) you want to use. + + - `str` + + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `class BetaUserProfileEnrollmentURL: …` + + - `expires_at: datetime` + + A timestamp in RFC 3339 format + + - `type: str` + + - `url: str` + +### Example + +```python +import os +from anthropic import Anthropic + +client = Anthropic( + api_key=os.environ.get("ANTHROPIC_API_KEY"), # This is the default and can be omitted +) +beta_user_profile_enrollment_url = client.beta.user_profiles.create_enrollment_url( + id="id", +) +print(beta_user_profile_enrollment_url.expires_at) +``` + +## Domain Types + +### Beta User Profile + +- `class BetaUserProfile: …` + + - `id: str` + + - `created_at: datetime` + + A timestamp in RFC 3339 format + + - `metadata: Dict[str, str]` + + - `trust_grants: Dict[str, BetaUserProfileTrustGrant]` + + - `status: str` + + - `type: str` + + - `updated_at: datetime` + + A timestamp in RFC 3339 format + + - `external_id: Optional[str]` + +### Beta User Profile Enrollment URL + +- `class BetaUserProfileEnrollmentURL: …` + + - `expires_at: datetime` + + A timestamp in RFC 3339 format + + - `type: str` + + - `url: str` + +### Beta User Profile Trust Grant + +- `class BetaUserProfileTrustGrant: …` + + - `status: str` diff --git a/content/en/api/python/beta/files.md b/content/en/api/python/beta/files.md index b944ba056..7a53c8bea 100644 --- a/content/en/api/python/beta/files.md +++ b/content/en/api/python/beta/files.md @@ -20,7 +20,7 @@ Upload File - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -62,6 +62,10 @@ Upload File - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class FileMetadata: …` @@ -145,7 +149,7 @@ List Files - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -187,6 +191,10 @@ List Files - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class FileMetadata: …` @@ -259,7 +267,7 @@ Download File - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -301,6 +309,10 @@ Download File - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BinaryResponseContent` @@ -342,7 +354,7 @@ Get File Metadata - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -384,6 +396,10 @@ Get File Metadata - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class FileMetadata: …` @@ -457,7 +473,7 @@ Delete File - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -499,6 +515,10 @@ Delete File - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class DeletedFile: …` diff --git a/content/en/api/python/beta/files/delete.md b/content/en/api/python/beta/files/delete.md index cdcede557..e0f38f11b 100644 --- a/content/en/api/python/beta/files/delete.md +++ b/content/en/api/python/beta/files/delete.md @@ -18,7 +18,7 @@ Delete File - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -60,6 +60,10 @@ Delete File - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class DeletedFile: …` diff --git a/content/en/api/python/beta/files/download.md b/content/en/api/python/beta/files/download.md index 52f16ef11..6b9a71149 100644 --- a/content/en/api/python/beta/files/download.md +++ b/content/en/api/python/beta/files/download.md @@ -18,7 +18,7 @@ Download File - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -60,6 +60,10 @@ Download File - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BinaryResponseContent` diff --git a/content/en/api/python/beta/files/list.md b/content/en/api/python/beta/files/list.md index 0628fa9bb..386ede2d4 100644 --- a/content/en/api/python/beta/files/list.md +++ b/content/en/api/python/beta/files/list.md @@ -28,7 +28,7 @@ List Files - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -70,6 +70,10 @@ List Files - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class FileMetadata: …` diff --git a/content/en/api/python/beta/files/retrieve_metadata.md b/content/en/api/python/beta/files/retrieve_metadata.md index 330350849..2efa97ff7 100644 --- a/content/en/api/python/beta/files/retrieve_metadata.md +++ b/content/en/api/python/beta/files/retrieve_metadata.md @@ -18,7 +18,7 @@ Get File Metadata - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -60,6 +60,10 @@ Get File Metadata - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class FileMetadata: …` diff --git a/content/en/api/python/beta/files/upload.md b/content/en/api/python/beta/files/upload.md index 8819cf5df..82e21b347 100644 --- a/content/en/api/python/beta/files/upload.md +++ b/content/en/api/python/beta/files/upload.md @@ -18,7 +18,7 @@ Upload File - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -60,6 +60,10 @@ Upload File - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class FileMetadata: …` diff --git a/content/en/api/python/beta/messages.md b/content/en/api/python/beta/messages.md index 2dc236512..393952bcb 100644 --- a/content/en/api/python/beta/messages.md +++ b/content/en/api/python/beta/messages.md @@ -2956,7 +2956,7 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `"fast"` -- `stop_sequences: Optional[SequenceNotStr[str]]` +- `stop_sequences: Optional[Sequence[str]]` Custom text sequences that will cause the model to stop generating. @@ -4694,13 +4694,17 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en Recommended for advanced use cases only. You usually only need to use `temperature`. +- `user_profile_id: Optional[str]` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + - `betas: Optional[List[AnthropicBetaParam]]` Optional header to specify the beta version(s) you want to use. - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -4742,6 +4746,10 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class BetaMessage: …` @@ -5757,6 +5765,30 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `"assistant"` + - `stop_details: Optional[BetaRefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[BetaStopReason]` The reason that we stopped. @@ -10576,7 +10608,7 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -10618,6 +10650,10 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageTokensCount: …` @@ -17930,6 +17966,30 @@ print(beta_message_tokens_count.context_management) - `"assistant"` + - `stop_details: Optional[BetaRefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[BetaStopReason]` The reason that we stopped. @@ -22075,6 +22135,30 @@ print(beta_message_tokens_count.context_management) Skill version or 'latest' for most recent version + - `stop_details: Optional[BetaRefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[BetaStopReason]` - `"end_turn"` @@ -23242,6 +23326,30 @@ print(beta_message_tokens_count.context_management) - `"assistant"` + - `stop_details: Optional[BetaRefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[BetaStopReason]` The reason that we stopped. @@ -24478,6 +24586,30 @@ print(beta_message_tokens_count.context_management) - `"assistant"` + - `stop_details: Optional[BetaRefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[BetaStopReason]` The reason that we stopped. @@ -24763,6 +24895,30 @@ print(beta_message_tokens_count.context_management) Skill version or 'latest' for most recent version + - `stop_details: Optional[BetaRefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[BetaStopReason]` - `"end_turn"` @@ -25907,6 +26063,32 @@ print(beta_message_tokens_count.context_management) - `"redacted_thinking"` +### Beta Refusal Stop Details + +- `class BetaRefusalStopDetails: …` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + ### Beta Request Document Block - `class BetaRequestDocumentBlock: …` @@ -35825,7 +36007,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast"` - - `stop_sequences: Optional[SequenceNotStr[str]]` + - `stop_sequences: Optional[Sequence[str]]` Custom text sequences that will cause the model to stop generating. @@ -37561,13 +37743,17 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Recommended for advanced use cases only. You usually only need to use `temperature`. + - `user_profile_id: Optional[str]` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + - `betas: Optional[List[AnthropicBetaParam]]` Optional header to specify the beta version(s) you want to use. - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -37609,6 +37795,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatch: …` @@ -37746,7 +37936,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -37788,6 +37978,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatch: …` @@ -37925,7 +38119,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -37967,6 +38161,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatch: …` @@ -38095,7 +38293,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -38137,6 +38335,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatch: …` @@ -38266,7 +38468,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -38308,6 +38510,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class BetaDeletedMessageBatch: …` @@ -38363,7 +38569,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -38405,6 +38611,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatchIndividualResponse: …` @@ -39438,6 +39648,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"assistant"` + - `stop_details: Optional[BetaRefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[BetaStopReason]` The reason that we stopped. @@ -41009,6 +41243,30 @@ for batch in client.beta.messages.batches.results( - `"assistant"` + - `stop_details: Optional[BetaRefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[BetaStopReason]` The reason that we stopped. @@ -42373,6 +42631,30 @@ for batch in client.beta.messages.batches.results( - `"assistant"` + - `stop_details: Optional[BetaRefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[BetaStopReason]` The reason that we stopped. @@ -43699,6 +43981,30 @@ for batch in client.beta.messages.batches.results( - `"assistant"` + - `stop_details: Optional[BetaRefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[BetaStopReason]` The reason that we stopped. diff --git a/content/en/api/python/beta/messages/batches.md b/content/en/api/python/beta/messages/batches.md index 4581ca1cf..61f3405ce 100644 --- a/content/en/api/python/beta/messages/batches.md +++ b/content/en/api/python/beta/messages/batches.md @@ -2972,7 +2972,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast"` - - `stop_sequences: Optional[SequenceNotStr[str]]` + - `stop_sequences: Optional[Sequence[str]]` Custom text sequences that will cause the model to stop generating. @@ -4708,13 +4708,17 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Recommended for advanced use cases only. You usually only need to use `temperature`. + - `user_profile_id: Optional[str]` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + - `betas: Optional[List[AnthropicBetaParam]]` Optional header to specify the beta version(s) you want to use. - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -4756,6 +4760,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatch: …` @@ -4893,7 +4901,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -4935,6 +4943,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatch: …` @@ -5072,7 +5084,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -5114,6 +5126,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatch: …` @@ -5242,7 +5258,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -5284,6 +5300,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatch: …` @@ -5413,7 +5433,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -5455,6 +5475,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class BetaDeletedMessageBatch: …` @@ -5510,7 +5534,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -5552,6 +5576,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatchIndividualResponse: …` @@ -6585,6 +6613,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"assistant"` + - `stop_details: Optional[BetaRefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[BetaStopReason]` The reason that we stopped. @@ -8156,6 +8208,30 @@ for batch in client.beta.messages.batches.results( - `"assistant"` + - `stop_details: Optional[BetaRefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[BetaStopReason]` The reason that we stopped. @@ -9520,6 +9596,30 @@ for batch in client.beta.messages.batches.results( - `"assistant"` + - `stop_details: Optional[BetaRefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[BetaStopReason]` The reason that we stopped. @@ -10846,6 +10946,30 @@ for batch in client.beta.messages.batches.results( - `"assistant"` + - `stop_details: Optional[BetaRefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[BetaStopReason]` The reason that we stopped. diff --git a/content/en/api/python/beta/messages/batches/cancel.md b/content/en/api/python/beta/messages/batches/cancel.md index 3f5a12a2f..c762c9d52 100644 --- a/content/en/api/python/beta/messages/batches/cancel.md +++ b/content/en/api/python/beta/messages/batches/cancel.md @@ -22,7 +22,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -64,6 +64,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatch: …` diff --git a/content/en/api/python/beta/messages/batches/create.md b/content/en/api/python/beta/messages/batches/create.md index 428fb5545..a308fbf9c 100644 --- a/content/en/api/python/beta/messages/batches/create.md +++ b/content/en/api/python/beta/messages/batches/create.md @@ -2970,7 +2970,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast"` - - `stop_sequences: Optional[SequenceNotStr[str]]` + - `stop_sequences: Optional[Sequence[str]]` Custom text sequences that will cause the model to stop generating. @@ -4706,13 +4706,17 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Recommended for advanced use cases only. You usually only need to use `temperature`. + - `user_profile_id: Optional[str]` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + - `betas: Optional[List[AnthropicBetaParam]]` Optional header to specify the beta version(s) you want to use. - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -4754,6 +4758,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatch: …` diff --git a/content/en/api/python/beta/messages/batches/delete.md b/content/en/api/python/beta/messages/batches/delete.md index de7fed4ca..c08d15b77 100644 --- a/content/en/api/python/beta/messages/batches/delete.md +++ b/content/en/api/python/beta/messages/batches/delete.md @@ -22,7 +22,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -64,6 +64,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class BetaDeletedMessageBatch: …` diff --git a/content/en/api/python/beta/messages/batches/list.md b/content/en/api/python/beta/messages/batches/list.md index e85974913..bacee2ce7 100644 --- a/content/en/api/python/beta/messages/batches/list.md +++ b/content/en/api/python/beta/messages/batches/list.md @@ -30,7 +30,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -72,6 +72,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatch: …` diff --git a/content/en/api/python/beta/messages/batches/results.md b/content/en/api/python/beta/messages/batches/results.md index fb3491153..04a2ca1c2 100644 --- a/content/en/api/python/beta/messages/batches/results.md +++ b/content/en/api/python/beta/messages/batches/results.md @@ -22,7 +22,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -64,6 +64,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatchIndividualResponse: …` @@ -1097,6 +1101,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"assistant"` + - `stop_details: Optional[BetaRefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[BetaStopReason]` The reason that we stopped. diff --git a/content/en/api/python/beta/messages/batches/retrieve.md b/content/en/api/python/beta/messages/batches/retrieve.md index 7c3301899..f6183cf35 100644 --- a/content/en/api/python/beta/messages/batches/retrieve.md +++ b/content/en/api/python/beta/messages/batches/retrieve.md @@ -20,7 +20,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -62,6 +62,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatch: …` diff --git a/content/en/api/python/beta/messages/count_tokens.md b/content/en/api/python/beta/messages/count_tokens.md index 36a401664..8d99c229b 100644 --- a/content/en/api/python/beta/messages/count_tokens.md +++ b/content/en/api/python/beta/messages/count_tokens.md @@ -4592,7 +4592,7 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -4634,6 +4634,10 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageTokensCount: …` diff --git a/content/en/api/python/beta/messages/create.md b/content/en/api/python/beta/messages/create.md index 6ab816cbd..24804ac63 100644 --- a/content/en/api/python/beta/messages/create.md +++ b/content/en/api/python/beta/messages/create.md @@ -2954,7 +2954,7 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `"fast"` -- `stop_sequences: Optional[SequenceNotStr[str]]` +- `stop_sequences: Optional[Sequence[str]]` Custom text sequences that will cause the model to stop generating. @@ -4692,13 +4692,17 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en Recommended for advanced use cases only. You usually only need to use `temperature`. +- `user_profile_id: Optional[str]` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + - `betas: Optional[List[AnthropicBetaParam]]` Optional header to specify the beta version(s) you want to use. - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -4740,6 +4744,10 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class BetaMessage: …` @@ -5755,6 +5763,30 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `"assistant"` + - `stop_details: Optional[BetaRefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[BetaStopReason]` The reason that we stopped. diff --git a/content/en/api/python/beta/models.md b/content/en/api/python/beta/models.md index 8527e0088..075f95f84 100644 --- a/content/en/api/python/beta/models.md +++ b/content/en/api/python/beta/models.md @@ -32,7 +32,7 @@ The Models API response can be used to determine which models are available for - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -74,6 +74,10 @@ The Models API response can be used to determine which models are available for - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class BetaModelInfo: …` @@ -294,7 +298,7 @@ The Models API response can be used to determine information about a specific mo - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -336,6 +340,10 @@ The Models API response can be used to determine information about a specific mo - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class BetaModelInfo: …` diff --git a/content/en/api/python/beta/models/list.md b/content/en/api/python/beta/models/list.md index d7e3e97c6..ebd2bf725 100644 --- a/content/en/api/python/beta/models/list.md +++ b/content/en/api/python/beta/models/list.md @@ -30,7 +30,7 @@ The Models API response can be used to determine which models are available for - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -72,6 +72,10 @@ The Models API response can be used to determine which models are available for - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class BetaModelInfo: …` diff --git a/content/en/api/python/beta/models/retrieve.md b/content/en/api/python/beta/models/retrieve.md index f60f388d8..0cde128e5 100644 --- a/content/en/api/python/beta/models/retrieve.md +++ b/content/en/api/python/beta/models/retrieve.md @@ -20,7 +20,7 @@ The Models API response can be used to determine information about a specific mo - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -62,6 +62,10 @@ The Models API response can be used to determine information about a specific mo - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class BetaModelInfo: …` diff --git a/content/en/api/python/beta/skills.md b/content/en/api/python/beta/skills.md index a622fd07c..b5a1f3d58 100644 --- a/content/en/api/python/beta/skills.md +++ b/content/en/api/python/beta/skills.md @@ -16,7 +16,7 @@ Create Skill This is a human-readable label that is not included in the prompt sent to the model. -- `files: Optional[SequenceNotStr[FileTypes]]` +- `files: Optional[Sequence[FileTypes]]` Files to upload for the skill. @@ -28,7 +28,7 @@ Create Skill - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -70,6 +70,10 @@ Create Skill - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class SkillCreateResponse: …` @@ -165,7 +169,7 @@ List Skills - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -207,6 +211,10 @@ List Skills - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class SkillListResponse: …` @@ -288,7 +296,7 @@ Get Skill - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -330,6 +338,10 @@ Get Skill - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class SkillRetrieveResponse: …` @@ -412,7 +424,7 @@ Delete Skill - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -454,6 +466,10 @@ Delete Skill - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class SkillDeleteResponse: …` @@ -485,6 +501,159 @@ skill = client.beta.skills.delete( print(skill.id) ``` +## Domain Types + +### Skill Create Response + +- `class SkillCreateResponse: …` + + - `id: str` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + + - `created_at: str` + + ISO 8601 timestamp of when the skill was created. + + - `display_title: Optional[str]` + + Display title for the skill. + + This is a human-readable label that is not included in the prompt sent to the model. + + - `latest_version: Optional[str]` + + The latest version identifier for the skill. + + This represents the most recent version of the skill that has been created. + + - `source: str` + + Source of the skill. + + This may be one of the following values: + + * `"custom"`: the skill was created by a user + * `"anthropic"`: the skill was created by Anthropic + + - `type: str` + + Object type. + + For Skills, this is always `"skill"`. + + - `updated_at: str` + + ISO 8601 timestamp of when the skill was last updated. + +### Skill List Response + +- `class SkillListResponse: …` + + - `id: str` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + + - `created_at: str` + + ISO 8601 timestamp of when the skill was created. + + - `display_title: Optional[str]` + + Display title for the skill. + + This is a human-readable label that is not included in the prompt sent to the model. + + - `latest_version: Optional[str]` + + The latest version identifier for the skill. + + This represents the most recent version of the skill that has been created. + + - `source: str` + + Source of the skill. + + This may be one of the following values: + + * `"custom"`: the skill was created by a user + * `"anthropic"`: the skill was created by Anthropic + + - `type: str` + + Object type. + + For Skills, this is always `"skill"`. + + - `updated_at: str` + + ISO 8601 timestamp of when the skill was last updated. + +### Skill Retrieve Response + +- `class SkillRetrieveResponse: …` + + - `id: str` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + + - `created_at: str` + + ISO 8601 timestamp of when the skill was created. + + - `display_title: Optional[str]` + + Display title for the skill. + + This is a human-readable label that is not included in the prompt sent to the model. + + - `latest_version: Optional[str]` + + The latest version identifier for the skill. + + This represents the most recent version of the skill that has been created. + + - `source: str` + + Source of the skill. + + This may be one of the following values: + + * `"custom"`: the skill was created by a user + * `"anthropic"`: the skill was created by Anthropic + + - `type: str` + + Object type. + + For Skills, this is always `"skill"`. + + - `updated_at: str` + + ISO 8601 timestamp of when the skill was last updated. + +### Skill Delete Response + +- `class SkillDeleteResponse: …` + + - `id: str` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + + - `type: str` + + Deleted object type. + + For Skills, this is always `"skill_deleted"`. + # Versions ## Create @@ -503,7 +672,7 @@ Create Skill Version The format and length of IDs may change over time. -- `files: Optional[SequenceNotStr[FileTypes]]` +- `files: Optional[Sequence[FileTypes]]` Files to upload for the skill. @@ -515,7 +684,7 @@ Create Skill Version - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -557,6 +726,10 @@ Create Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class VersionCreateResponse: …` @@ -652,7 +825,7 @@ List Skill Versions - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -694,6 +867,10 @@ List Skill Versions - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class VersionListResponse: …` @@ -786,7 +963,7 @@ Get Skill Version - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -828,6 +1005,10 @@ Get Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class VersionRetrieveResponse: …` @@ -920,7 +1101,7 @@ Delete Skill Version - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -962,6 +1143,10 @@ Delete Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class VersionDeleteResponse: …` @@ -993,3 +1178,165 @@ version = client.beta.skills.versions.delete( ) print(version.id) ``` + +## Domain Types + +### Version Create Response + +- `class VersionCreateResponse: …` + + - `id: str` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: str` + + ISO 8601 timestamp of when the skill version was created. + + - `description: str` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: str` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: str` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: str` + + Identifier for the skill that this version belongs to. + + - `type: str` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: str` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version List Response + +- `class VersionListResponse: …` + + - `id: str` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: str` + + ISO 8601 timestamp of when the skill version was created. + + - `description: str` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: str` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: str` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: str` + + Identifier for the skill that this version belongs to. + + - `type: str` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: str` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version Retrieve Response + +- `class VersionRetrieveResponse: …` + + - `id: str` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: str` + + ISO 8601 timestamp of when the skill version was created. + + - `description: str` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: str` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: str` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: str` + + Identifier for the skill that this version belongs to. + + - `type: str` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: str` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version Delete Response + +- `class VersionDeleteResponse: …` + + - `id: str` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + + - `type: str` + + Deleted object type. + + For Skill Versions, this is always `"skill_version_deleted"`. diff --git a/content/en/api/python/beta/skills/create.md b/content/en/api/python/beta/skills/create.md index d9ba545f6..f3506b9b7 100644 --- a/content/en/api/python/beta/skills/create.md +++ b/content/en/api/python/beta/skills/create.md @@ -14,7 +14,7 @@ Create Skill This is a human-readable label that is not included in the prompt sent to the model. -- `files: Optional[SequenceNotStr[FileTypes]]` +- `files: Optional[Sequence[FileTypes]]` Files to upload for the skill. @@ -26,7 +26,7 @@ Create Skill - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -68,6 +68,10 @@ Create Skill - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class SkillCreateResponse: …` diff --git a/content/en/api/python/beta/skills/delete.md b/content/en/api/python/beta/skills/delete.md index 80df504ea..5c42bc768 100644 --- a/content/en/api/python/beta/skills/delete.md +++ b/content/en/api/python/beta/skills/delete.md @@ -20,7 +20,7 @@ Delete Skill - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -62,6 +62,10 @@ Delete Skill - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class SkillDeleteResponse: …` diff --git a/content/en/api/python/beta/skills/list.md b/content/en/api/python/beta/skills/list.md index 5e6ae785c..531531388 100644 --- a/content/en/api/python/beta/skills/list.md +++ b/content/en/api/python/beta/skills/list.md @@ -35,7 +35,7 @@ List Skills - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -77,6 +77,10 @@ List Skills - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class SkillListResponse: …` diff --git a/content/en/api/python/beta/skills/retrieve.md b/content/en/api/python/beta/skills/retrieve.md index 7bc98df08..b2d9373ab 100644 --- a/content/en/api/python/beta/skills/retrieve.md +++ b/content/en/api/python/beta/skills/retrieve.md @@ -20,7 +20,7 @@ Get Skill - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -62,6 +62,10 @@ Get Skill - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class SkillRetrieveResponse: …` diff --git a/content/en/api/python/beta/skills/versions.md b/content/en/api/python/beta/skills/versions.md index 9e4fb864f..adcbdf70f 100644 --- a/content/en/api/python/beta/skills/versions.md +++ b/content/en/api/python/beta/skills/versions.md @@ -16,7 +16,7 @@ Create Skill Version The format and length of IDs may change over time. -- `files: Optional[SequenceNotStr[FileTypes]]` +- `files: Optional[Sequence[FileTypes]]` Files to upload for the skill. @@ -28,7 +28,7 @@ Create Skill Version - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -70,6 +70,10 @@ Create Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class VersionCreateResponse: …` @@ -165,7 +169,7 @@ List Skill Versions - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -207,6 +211,10 @@ List Skill Versions - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class VersionListResponse: …` @@ -299,7 +307,7 @@ Get Skill Version - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -341,6 +349,10 @@ Get Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class VersionRetrieveResponse: …` @@ -433,7 +445,7 @@ Delete Skill Version - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -475,6 +487,10 @@ Delete Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class VersionDeleteResponse: …` @@ -506,3 +522,165 @@ version = client.beta.skills.versions.delete( ) print(version.id) ``` + +## Domain Types + +### Version Create Response + +- `class VersionCreateResponse: …` + + - `id: str` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: str` + + ISO 8601 timestamp of when the skill version was created. + + - `description: str` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: str` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: str` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: str` + + Identifier for the skill that this version belongs to. + + - `type: str` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: str` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version List Response + +- `class VersionListResponse: …` + + - `id: str` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: str` + + ISO 8601 timestamp of when the skill version was created. + + - `description: str` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: str` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: str` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: str` + + Identifier for the skill that this version belongs to. + + - `type: str` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: str` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version Retrieve Response + +- `class VersionRetrieveResponse: …` + + - `id: str` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: str` + + ISO 8601 timestamp of when the skill version was created. + + - `description: str` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: str` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: str` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: str` + + Identifier for the skill that this version belongs to. + + - `type: str` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: str` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version Delete Response + +- `class VersionDeleteResponse: …` + + - `id: str` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + + - `type: str` + + Deleted object type. + + For Skill Versions, this is always `"skill_version_deleted"`. diff --git a/content/en/api/python/beta/skills/versions/create.md b/content/en/api/python/beta/skills/versions/create.md index 2c1fe19ed..a12d81eb5 100644 --- a/content/en/api/python/beta/skills/versions/create.md +++ b/content/en/api/python/beta/skills/versions/create.md @@ -14,7 +14,7 @@ Create Skill Version The format and length of IDs may change over time. -- `files: Optional[SequenceNotStr[FileTypes]]` +- `files: Optional[Sequence[FileTypes]]` Files to upload for the skill. @@ -26,7 +26,7 @@ Create Skill Version - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -68,6 +68,10 @@ Create Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class VersionCreateResponse: …` diff --git a/content/en/api/python/beta/skills/versions/delete.md b/content/en/api/python/beta/skills/versions/delete.md index c5aed279a..dded09232 100644 --- a/content/en/api/python/beta/skills/versions/delete.md +++ b/content/en/api/python/beta/skills/versions/delete.md @@ -26,7 +26,7 @@ Delete Skill Version - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -68,6 +68,10 @@ Delete Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class VersionDeleteResponse: …` diff --git a/content/en/api/python/beta/skills/versions/list.md b/content/en/api/python/beta/skills/versions/list.md index 59b0f937e..f05b870fc 100644 --- a/content/en/api/python/beta/skills/versions/list.md +++ b/content/en/api/python/beta/skills/versions/list.md @@ -30,7 +30,7 @@ List Skill Versions - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -72,6 +72,10 @@ List Skill Versions - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class VersionListResponse: …` diff --git a/content/en/api/python/beta/skills/versions/retrieve.md b/content/en/api/python/beta/skills/versions/retrieve.md index 7cd12c648..49b50c4a1 100644 --- a/content/en/api/python/beta/skills/versions/retrieve.md +++ b/content/en/api/python/beta/skills/versions/retrieve.md @@ -26,7 +26,7 @@ Get Skill Version - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -68,6 +68,10 @@ Get Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class VersionRetrieveResponse: …` diff --git a/content/en/api/python/beta/user_profiles.md b/content/en/api/python/beta/user_profiles.md new file mode 100644 index 000000000..4ed32ce20 --- /dev/null +++ b/content/en/api/python/beta/user_profiles.md @@ -0,0 +1,569 @@ +# User Profiles + +## Create + +`beta.user_profiles.create(UserProfileCreateParams**kwargs) -> BetaUserProfile` + +**post** `/v1/user_profiles` + +Create User Profile + +### Parameters + +- `external_id: Optional[str]` + +- `metadata: Optional[Dict[str, str]]` + + Free-form key-value data to attach to this user profile. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. Values must be non-empty strings. + +- `betas: Optional[List[AnthropicBetaParam]]` + + Optional header to specify the beta version(s) you want to use. + + - `str` + + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `class BetaUserProfile: …` + + - `id: str` + + - `created_at: datetime` + + A timestamp in RFC 3339 format + + - `metadata: Dict[str, str]` + + - `trust_grants: Dict[str, BetaUserProfileTrustGrant]` + + - `status: str` + + - `type: str` + + - `updated_at: datetime` + + A timestamp in RFC 3339 format + + - `external_id: Optional[str]` + +### Example + +```python +import os +from anthropic import Anthropic + +client = Anthropic( + api_key=os.environ.get("ANTHROPIC_API_KEY"), # This is the default and can be omitted +) +beta_user_profile = client.beta.user_profiles.create() +print(beta_user_profile.id) +``` + +## List + +`beta.user_profiles.list(UserProfileListParams**kwargs) -> SyncPageCursorV2[BetaUserProfile]` + +**get** `/v1/user_profiles` + +List User Profiles + +### Parameters + +- `limit: Optional[int]` + + Query parameter for limit + +- `order: Optional[Literal["asc", "desc"]]` + + Query parameter for order + + - `"asc"` + + - `"desc"` + +- `page: Optional[str]` + + Query parameter for page + +- `betas: Optional[List[AnthropicBetaParam]]` + + Optional header to specify the beta version(s) you want to use. + + - `str` + + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `class BetaUserProfile: …` + + - `id: str` + + - `created_at: datetime` + + A timestamp in RFC 3339 format + + - `metadata: Dict[str, str]` + + - `trust_grants: Dict[str, BetaUserProfileTrustGrant]` + + - `status: str` + + - `type: str` + + - `updated_at: datetime` + + A timestamp in RFC 3339 format + + - `external_id: Optional[str]` + +### Example + +```python +import os +from anthropic import Anthropic + +client = Anthropic( + api_key=os.environ.get("ANTHROPIC_API_KEY"), # This is the default and can be omitted +) +page = client.beta.user_profiles.list() +page = page.data[0] +print(page.id) +``` + +## Retrieve + +`beta.user_profiles.retrieve(strid, UserProfileRetrieveParams**kwargs) -> BetaUserProfile` + +**get** `/v1/user_profiles/{id}` + +Get User Profile + +### Parameters + +- `id: str` + +- `betas: Optional[List[AnthropicBetaParam]]` + + Optional header to specify the beta version(s) you want to use. + + - `str` + + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `class BetaUserProfile: …` + + - `id: str` + + - `created_at: datetime` + + A timestamp in RFC 3339 format + + - `metadata: Dict[str, str]` + + - `trust_grants: Dict[str, BetaUserProfileTrustGrant]` + + - `status: str` + + - `type: str` + + - `updated_at: datetime` + + A timestamp in RFC 3339 format + + - `external_id: Optional[str]` + +### Example + +```python +import os +from anthropic import Anthropic + +client = Anthropic( + api_key=os.environ.get("ANTHROPIC_API_KEY"), # This is the default and can be omitted +) +beta_user_profile = client.beta.user_profiles.retrieve( + id="id", +) +print(beta_user_profile.id) +``` + +## Update + +`beta.user_profiles.update(strid, UserProfileUpdateParams**kwargs) -> BetaUserProfile` + +**post** `/v1/user_profiles/{id}` + +Update User Profile + +### Parameters + +- `id: str` + +- `external_id: Optional[str]` + +- `metadata: Optional[Dict[str, str]]` + + Key-value pairs to merge into the stored metadata. Keys provided overwrite existing values. To remove a key, set its value to an empty string. Keys not provided are left unchanged. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. + +- `betas: Optional[List[AnthropicBetaParam]]` + + Optional header to specify the beta version(s) you want to use. + + - `str` + + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `class BetaUserProfile: …` + + - `id: str` + + - `created_at: datetime` + + A timestamp in RFC 3339 format + + - `metadata: Dict[str, str]` + + - `trust_grants: Dict[str, BetaUserProfileTrustGrant]` + + - `status: str` + + - `type: str` + + - `updated_at: datetime` + + A timestamp in RFC 3339 format + + - `external_id: Optional[str]` + +### Example + +```python +import os +from anthropic import Anthropic + +client = Anthropic( + api_key=os.environ.get("ANTHROPIC_API_KEY"), # This is the default and can be omitted +) +beta_user_profile = client.beta.user_profiles.update( + id="id", +) +print(beta_user_profile.id) +``` + +## Create Enrollment URL + +`beta.user_profiles.create_enrollment_url(strid, UserProfileCreateEnrollmentURLParams**kwargs) -> BetaUserProfileEnrollmentURL` + +**post** `/v1/user_profiles/{id}/enrollment_url` + +Create Enrollment URL + +### Parameters + +- `id: str` + +- `betas: Optional[List[AnthropicBetaParam]]` + + Optional header to specify the beta version(s) you want to use. + + - `str` + + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `class BetaUserProfileEnrollmentURL: …` + + - `expires_at: datetime` + + A timestamp in RFC 3339 format + + - `type: str` + + - `url: str` + +### Example + +```python +import os +from anthropic import Anthropic + +client = Anthropic( + api_key=os.environ.get("ANTHROPIC_API_KEY"), # This is the default and can be omitted +) +beta_user_profile_enrollment_url = client.beta.user_profiles.create_enrollment_url( + id="id", +) +print(beta_user_profile_enrollment_url.expires_at) +``` + +## Domain Types + +### Beta User Profile + +- `class BetaUserProfile: …` + + - `id: str` + + - `created_at: datetime` + + A timestamp in RFC 3339 format + + - `metadata: Dict[str, str]` + + - `trust_grants: Dict[str, BetaUserProfileTrustGrant]` + + - `status: str` + + - `type: str` + + - `updated_at: datetime` + + A timestamp in RFC 3339 format + + - `external_id: Optional[str]` + +### Beta User Profile Enrollment URL + +- `class BetaUserProfileEnrollmentURL: …` + + - `expires_at: datetime` + + A timestamp in RFC 3339 format + + - `type: str` + + - `url: str` + +### Beta User Profile Trust Grant + +- `class BetaUserProfileTrustGrant: …` + + - `status: str` diff --git a/content/en/api/python/beta/user_profiles/create.md b/content/en/api/python/beta/user_profiles/create.md new file mode 100644 index 000000000..3fa5c7665 --- /dev/null +++ b/content/en/api/python/beta/user_profiles/create.md @@ -0,0 +1,104 @@ +## Create + +`beta.user_profiles.create(UserProfileCreateParams**kwargs) -> BetaUserProfile` + +**post** `/v1/user_profiles` + +Create User Profile + +### Parameters + +- `external_id: Optional[str]` + +- `metadata: Optional[Dict[str, str]]` + + Free-form key-value data to attach to this user profile. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. Values must be non-empty strings. + +- `betas: Optional[List[AnthropicBetaParam]]` + + Optional header to specify the beta version(s) you want to use. + + - `str` + + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `class BetaUserProfile: …` + + - `id: str` + + - `created_at: datetime` + + A timestamp in RFC 3339 format + + - `metadata: Dict[str, str]` + + - `trust_grants: Dict[str, BetaUserProfileTrustGrant]` + + - `status: str` + + - `type: str` + + - `updated_at: datetime` + + A timestamp in RFC 3339 format + + - `external_id: Optional[str]` + +### Example + +```python +import os +from anthropic import Anthropic + +client = Anthropic( + api_key=os.environ.get("ANTHROPIC_API_KEY"), # This is the default and can be omitted +) +beta_user_profile = client.beta.user_profiles.create() +print(beta_user_profile.id) +``` diff --git a/content/en/api/python/beta/user_profiles/create_enrollment_url.md b/content/en/api/python/beta/user_profiles/create_enrollment_url.md new file mode 100644 index 000000000..bd2f3e2c6 --- /dev/null +++ b/content/en/api/python/beta/user_profiles/create_enrollment_url.md @@ -0,0 +1,90 @@ +## Create Enrollment URL + +`beta.user_profiles.create_enrollment_url(strid, UserProfileCreateEnrollmentURLParams**kwargs) -> BetaUserProfileEnrollmentURL` + +**post** `/v1/user_profiles/{id}/enrollment_url` + +Create Enrollment URL + +### Parameters + +- `id: str` + +- `betas: Optional[List[AnthropicBetaParam]]` + + Optional header to specify the beta version(s) you want to use. + + - `str` + + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `class BetaUserProfileEnrollmentURL: …` + + - `expires_at: datetime` + + A timestamp in RFC 3339 format + + - `type: str` + + - `url: str` + +### Example + +```python +import os +from anthropic import Anthropic + +client = Anthropic( + api_key=os.environ.get("ANTHROPIC_API_KEY"), # This is the default and can be omitted +) +beta_user_profile_enrollment_url = client.beta.user_profiles.create_enrollment_url( + id="id", +) +print(beta_user_profile_enrollment_url.expires_at) +``` diff --git a/content/en/api/python/beta/user_profiles/list.md b/content/en/api/python/beta/user_profiles/list.md new file mode 100644 index 000000000..c3fb52667 --- /dev/null +++ b/content/en/api/python/beta/user_profiles/list.md @@ -0,0 +1,115 @@ +## List + +`beta.user_profiles.list(UserProfileListParams**kwargs) -> SyncPageCursorV2[BetaUserProfile]` + +**get** `/v1/user_profiles` + +List User Profiles + +### Parameters + +- `limit: Optional[int]` + + Query parameter for limit + +- `order: Optional[Literal["asc", "desc"]]` + + Query parameter for order + + - `"asc"` + + - `"desc"` + +- `page: Optional[str]` + + Query parameter for page + +- `betas: Optional[List[AnthropicBetaParam]]` + + Optional header to specify the beta version(s) you want to use. + + - `str` + + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `class BetaUserProfile: …` + + - `id: str` + + - `created_at: datetime` + + A timestamp in RFC 3339 format + + - `metadata: Dict[str, str]` + + - `trust_grants: Dict[str, BetaUserProfileTrustGrant]` + + - `status: str` + + - `type: str` + + - `updated_at: datetime` + + A timestamp in RFC 3339 format + + - `external_id: Optional[str]` + +### Example + +```python +import os +from anthropic import Anthropic + +client = Anthropic( + api_key=os.environ.get("ANTHROPIC_API_KEY"), # This is the default and can be omitted +) +page = client.beta.user_profiles.list() +page = page.data[0] +print(page.id) +``` diff --git a/content/en/api/python/beta/user_profiles/retrieve.md b/content/en/api/python/beta/user_profiles/retrieve.md new file mode 100644 index 000000000..3ee24b8ab --- /dev/null +++ b/content/en/api/python/beta/user_profiles/retrieve.md @@ -0,0 +1,102 @@ +## Retrieve + +`beta.user_profiles.retrieve(strid, UserProfileRetrieveParams**kwargs) -> BetaUserProfile` + +**get** `/v1/user_profiles/{id}` + +Get User Profile + +### Parameters + +- `id: str` + +- `betas: Optional[List[AnthropicBetaParam]]` + + Optional header to specify the beta version(s) you want to use. + + - `str` + + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `class BetaUserProfile: …` + + - `id: str` + + - `created_at: datetime` + + A timestamp in RFC 3339 format + + - `metadata: Dict[str, str]` + + - `trust_grants: Dict[str, BetaUserProfileTrustGrant]` + + - `status: str` + + - `type: str` + + - `updated_at: datetime` + + A timestamp in RFC 3339 format + + - `external_id: Optional[str]` + +### Example + +```python +import os +from anthropic import Anthropic + +client = Anthropic( + api_key=os.environ.get("ANTHROPIC_API_KEY"), # This is the default and can be omitted +) +beta_user_profile = client.beta.user_profiles.retrieve( + id="id", +) +print(beta_user_profile.id) +``` diff --git a/content/en/api/python/beta/user_profiles/update.md b/content/en/api/python/beta/user_profiles/update.md new file mode 100644 index 000000000..9cbcd4640 --- /dev/null +++ b/content/en/api/python/beta/user_profiles/update.md @@ -0,0 +1,108 @@ +## Update + +`beta.user_profiles.update(strid, UserProfileUpdateParams**kwargs) -> BetaUserProfile` + +**post** `/v1/user_profiles/{id}` + +Update User Profile + +### Parameters + +- `id: str` + +- `external_id: Optional[str]` + +- `metadata: Optional[Dict[str, str]]` + + Key-value pairs to merge into the stored metadata. Keys provided overwrite existing values. To remove a key, set its value to an empty string. Keys not provided are left unchanged. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. + +- `betas: Optional[List[AnthropicBetaParam]]` + + Optional header to specify the beta version(s) you want to use. + + - `str` + + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `class BetaUserProfile: …` + + - `id: str` + + - `created_at: datetime` + + A timestamp in RFC 3339 format + + - `metadata: Dict[str, str]` + + - `trust_grants: Dict[str, BetaUserProfileTrustGrant]` + + - `status: str` + + - `type: str` + + - `updated_at: datetime` + + A timestamp in RFC 3339 format + + - `external_id: Optional[str]` + +### Example + +```python +import os +from anthropic import Anthropic + +client = Anthropic( + api_key=os.environ.get("ANTHROPIC_API_KEY"), # This is the default and can be omitted +) +beta_user_profile = client.beta.user_profiles.update( + id="id", +) +print(beta_user_profile.id) +``` diff --git a/content/en/api/python/completions.md b/content/en/api/python/completions.md index d1bd29068..903a9f0c2 100644 --- a/content/en/api/python/completions.md +++ b/content/en/api/python/completions.md @@ -140,7 +140,7 @@ Future models and features will not be compatible with Text Completions. See our This should be a uuid, hash value, or other opaque identifier. Anthropic may use this id to help detect abuse. Do not include any identifying information such as name, email address, or phone number. -- `stop_sequences: Optional[SequenceNotStr[str]]` +- `stop_sequences: Optional[Sequence[str]]` Sequences that will cause the model to stop generating. @@ -186,7 +186,7 @@ Future models and features will not be compatible with Text Completions. See our - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -228,6 +228,10 @@ Future models and features will not be compatible with Text Completions. See our - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class Completion: …` diff --git a/content/en/api/python/completions/create.md b/content/en/api/python/completions/create.md index a318c71c6..94f23ae08 100644 --- a/content/en/api/python/completions/create.md +++ b/content/en/api/python/completions/create.md @@ -138,7 +138,7 @@ Future models and features will not be compatible with Text Completions. See our This should be a uuid, hash value, or other opaque identifier. Anthropic may use this id to help detect abuse. Do not include any identifying information such as name, email address, or phone number. -- `stop_sequences: Optional[SequenceNotStr[str]]` +- `stop_sequences: Optional[Sequence[str]]` Sequences that will cause the model to stop generating. @@ -184,7 +184,7 @@ Future models and features will not be compatible with Text Completions. See our - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -226,6 +226,10 @@ Future models and features will not be compatible with Text Completions. See our - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class Completion: …` diff --git a/content/en/api/python/messages.md b/content/en/api/python/messages.md index e56f18eb1..712d03af3 100644 --- a/content/en/api/python/messages.md +++ b/content/en/api/python/messages.md @@ -2468,7 +2468,7 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `"standard_only"` -- `stop_sequences: Optional[SequenceNotStr[str]]` +- `stop_sequences: Optional[Sequence[str]]` Custom text sequences that will cause the model to stop generating. @@ -4642,6 +4642,30 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `"assistant"` + - `stop_details: Optional[RefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[StopReason]` The reason that we stopped. @@ -14339,6 +14363,30 @@ print(message_tokens_count.input_tokens) - `"assistant"` + - `stop_details: Optional[RefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[StopReason]` The reason that we stopped. @@ -18868,6 +18916,30 @@ print(message_tokens_count.input_tokens) The time at which the container will expire. + - `stop_details: Optional[RefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[StopReason]` - `"end_turn"` @@ -19735,6 +19807,30 @@ print(message_tokens_count.input_tokens) - `"assistant"` + - `stop_details: Optional[RefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[StopReason]` The reason that we stopped. @@ -20663,6 +20759,30 @@ print(message_tokens_count.input_tokens) - `"assistant"` + - `stop_details: Optional[RefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[StopReason]` The reason that we stopped. @@ -20790,6 +20910,30 @@ print(message_tokens_count.input_tokens) The time at which the container will expire. + - `stop_details: Optional[RefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[StopReason]` - `"end_turn"` @@ -21688,6 +21832,32 @@ print(message_tokens_count.input_tokens) - `"redacted_thinking"` +### Refusal Stop Details + +- `class RefusalStopDetails: …` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + ### Search Result Block Param - `class SearchResultBlockParam: …` @@ -29771,7 +29941,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"standard_only"` - - `stop_sequences: Optional[SequenceNotStr[str]]` + - `stop_sequences: Optional[Sequence[str]]` Custom text sequences that will cause the model to stop generating. @@ -32517,6 +32687,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"assistant"` + - `stop_details: Optional[RefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[StopReason]` The reason that we stopped. @@ -33780,6 +33974,30 @@ for batch in client.messages.batches.results( - `"assistant"` + - `stop_details: Optional[RefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[StopReason]` The reason that we stopped. @@ -34836,6 +35054,30 @@ for batch in client.messages.batches.results( - `"assistant"` + - `stop_details: Optional[RefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[StopReason]` The reason that we stopped. @@ -35854,6 +36096,30 @@ for batch in client.messages.batches.results( - `"assistant"` + - `stop_details: Optional[RefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[StopReason]` The reason that we stopped. diff --git a/content/en/api/python/messages/batches.md b/content/en/api/python/messages/batches.md index ad0526c24..a9eedf8a9 100644 --- a/content/en/api/python/messages/batches.md +++ b/content/en/api/python/messages/batches.md @@ -2484,7 +2484,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"standard_only"` - - `stop_sequences: Optional[SequenceNotStr[str]]` + - `stop_sequences: Optional[Sequence[str]]` Custom text sequences that will cause the model to stop generating. @@ -5230,6 +5230,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"assistant"` + - `stop_details: Optional[RefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[StopReason]` The reason that we stopped. @@ -6493,6 +6517,30 @@ for batch in client.messages.batches.results( - `"assistant"` + - `stop_details: Optional[RefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[StopReason]` The reason that we stopped. @@ -7549,6 +7597,30 @@ for batch in client.messages.batches.results( - `"assistant"` + - `stop_details: Optional[RefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[StopReason]` The reason that we stopped. @@ -8567,6 +8639,30 @@ for batch in client.messages.batches.results( - `"assistant"` + - `stop_details: Optional[RefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[StopReason]` The reason that we stopped. diff --git a/content/en/api/python/messages/batches/create.md b/content/en/api/python/messages/batches/create.md index 2ac785a5a..04abee270 100644 --- a/content/en/api/python/messages/batches/create.md +++ b/content/en/api/python/messages/batches/create.md @@ -2482,7 +2482,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"standard_only"` - - `stop_sequences: Optional[SequenceNotStr[str]]` + - `stop_sequences: Optional[Sequence[str]]` Custom text sequences that will cause the model to stop generating. diff --git a/content/en/api/python/messages/batches/results.md b/content/en/api/python/messages/batches/results.md index 22cf3bf22..6320c8324 100644 --- a/content/en/api/python/messages/batches/results.md +++ b/content/en/api/python/messages/batches/results.md @@ -839,6 +839,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"assistant"` + - `stop_details: Optional[RefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[StopReason]` The reason that we stopped. diff --git a/content/en/api/python/messages/create.md b/content/en/api/python/messages/create.md index db0559120..e2d944652 100644 --- a/content/en/api/python/messages/create.md +++ b/content/en/api/python/messages/create.md @@ -2466,7 +2466,7 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `"standard_only"` -- `stop_sequences: Optional[SequenceNotStr[str]]` +- `stop_sequences: Optional[Sequence[str]]` Custom text sequences that will cause the model to stop generating. @@ -4640,6 +4640,30 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `"assistant"` + - `stop_details: Optional[RefusalStopDetails]` + + Structured information about a refusal. + + - `category: Optional[Literal["cyber", "bio"]]` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: Optional[str]` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: Literal["refusal"]` + + - `"refusal"` + - `stop_reason: Optional[StopReason]` The reason that we stopped. diff --git a/content/en/api/python/models.md b/content/en/api/python/models.md index 132eaa6e4..92b33cde7 100644 --- a/content/en/api/python/models.md +++ b/content/en/api/python/models.md @@ -32,7 +32,7 @@ The Models API response can be used to determine which models are available for - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -74,6 +74,10 @@ The Models API response can be used to determine which models are available for - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class ModelInfo: …` @@ -294,7 +298,7 @@ The Models API response can be used to determine information about a specific mo - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -336,6 +340,10 @@ The Models API response can be used to determine information about a specific mo - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class ModelInfo: …` diff --git a/content/en/api/python/models/list.md b/content/en/api/python/models/list.md index b689ddd7c..3e489433d 100644 --- a/content/en/api/python/models/list.md +++ b/content/en/api/python/models/list.md @@ -30,7 +30,7 @@ The Models API response can be used to determine which models are available for - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -72,6 +72,10 @@ The Models API response can be used to determine which models are available for - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class ModelInfo: …` diff --git a/content/en/api/python/models/retrieve.md b/content/en/api/python/models/retrieve.md index ff4d30ce7..b7c7a9308 100644 --- a/content/en/api/python/models/retrieve.md +++ b/content/en/api/python/models/retrieve.md @@ -20,7 +20,7 @@ The Models API response can be used to determine information about a specific mo - `str` - - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 17 more]` + - `Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 19 more]` - `"message-batches-2024-09-24"` @@ -62,6 +62,10 @@ The Models API response can be used to determine information about a specific mo - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `class ModelInfo: …` diff --git a/content/en/api/ruby/beta.md b/content/en/api/ruby/beta.md index a0d9afdd8..50797a9f3 100644 --- a/content/en/api/ruby/beta.md +++ b/content/en/api/ruby/beta.md @@ -4,11 +4,11 @@ ### Anthropic Beta -- `AnthropicBeta = String | :"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` +- `AnthropicBeta = String | :"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -50,6 +50,10 @@ - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Beta API Error - `class BetaAPIError` @@ -334,7 +338,7 @@ The Models API response can be used to determine which models are available for - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -376,265 +380,273 @@ The Models API response can be used to determine which models are available for - `:"fast-mode-2026-02-01"` -### Returns - -- `class BetaModelInfo` - - - `id: String` - - Unique model identifier. - - - `capabilities: BetaModelCapabilities` - - Model capability information. - - - `batch: BetaCapabilitySupport` - - Whether the model supports the Batch API. - - - `supported: bool` - - Whether this capability is supported by the model. - - - `citations: BetaCapabilitySupport` - - Whether the model supports citation generation. - - - `supported: bool` - - Whether this capability is supported by the model. - - - `code_execution: BetaCapabilitySupport` - - Whether the model supports code execution tools. - - - `supported: bool` - - Whether this capability is supported by the model. - - - `context_management: BetaContextManagementCapability` - - Context management support and available strategies. - - - `clear_thinking_20251015: BetaCapabilitySupport` - - Indicates whether a capability is supported. - - - `supported: bool` - - Whether this capability is supported by the model. - - - `clear_tool_uses_20250919: BetaCapabilitySupport` - - Indicates whether a capability is supported. - - - `supported: bool` - - Whether this capability is supported by the model. - - - `compact_20260112: BetaCapabilitySupport` - - Indicates whether a capability is supported. - - - `supported: bool` - - Whether this capability is supported by the model. - - - `supported: bool` + - `:"output-300k-2026-03-24"` - Whether this capability is supported by the model. - - - `effort: BetaEffortCapability` - - Effort (reasoning_effort) support and available levels. - - - `high: BetaCapabilitySupport` - - Whether the model supports high effort level. - - - `supported: bool` - - Whether this capability is supported by the model. - - - `low: BetaCapabilitySupport` - - Whether the model supports low effort level. - - - `supported: bool` - - Whether this capability is supported by the model. - - - `max: BetaCapabilitySupport` - - Whether the model supports max effort level. - - - `supported: bool` - - Whether this capability is supported by the model. - - - `medium: BetaCapabilitySupport` - - Whether the model supports medium effort level. - - - `supported: bool` - - Whether this capability is supported by the model. - - - `supported: bool` - - Whether this capability is supported by the model. - - - `image_input: BetaCapabilitySupport` - - Whether the model accepts image content blocks. - - - `supported: bool` - - Whether this capability is supported by the model. - - - `pdf_input: BetaCapabilitySupport` - - Whether the model accepts PDF content blocks. - - - `supported: bool` - - Whether this capability is supported by the model. - - - `structured_outputs: BetaCapabilitySupport` - - Whether the model supports structured output / JSON mode / strict tool schemas. - - - `supported: bool` - - Whether this capability is supported by the model. - - - `thinking: BetaThinkingCapability` - - Thinking capability and supported type configurations. - - - `supported: bool` - - Whether this capability is supported by the model. - - - `types: BetaThinkingTypes` - - Supported thinking type configurations. - - - `adaptive: BetaCapabilitySupport` - - Whether the model supports thinking with type 'adaptive' (auto). - - - `supported: bool` - - Whether this capability is supported by the model. - - - `enabled: BetaCapabilitySupport` - - Whether the model supports thinking with type 'enabled'. - - - `supported: bool` - - Whether this capability is supported by the model. - - - `created_at: Time` - - RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown. - - - `display_name: String` - - A human-readable name for the model. - - - `max_input_tokens: Integer` - - Maximum input context window size in tokens for this model. - - - `max_tokens: Integer` - - Maximum value for the `max_tokens` parameter when using this model. - - - `type: :model` - - Object type. - - For Models, this is always `"model"`. - - - `:model` - -### Example - -```ruby -require "anthropic" - -anthropic = Anthropic::Client.new(api_key: "my-anthropic-api-key") - -page = anthropic.beta.models.list - -puts(page) -``` - -## Retrieve - -`beta.models.retrieve(model_id, **kwargs) -> BetaModelInfo` - -**get** `/v1/models/{model_id}` - -Get a specific model. - -The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID. - -### Parameters - -- `model_id: String` - - Model identifier or alias. - -- `betas: Array[AnthropicBeta]` - - Optional header to specify the beta version(s) you want to use. - - - `String` - - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` - - - `:"message-batches-2024-09-24"` - - - `:"prompt-caching-2024-07-31"` - - - `:"computer-use-2024-10-22"` - - - `:"computer-use-2025-01-24"` - - - `:"pdfs-2024-09-25"` - - - `:"token-counting-2024-11-01"` - - - `:"token-efficient-tools-2025-02-19"` - - - `:"output-128k-2025-02-19"` - - - `:"files-api-2025-04-14"` - - - `:"mcp-client-2025-04-04"` - - - `:"mcp-client-2025-11-20"` - - - `:"dev-full-thinking-2025-05-14"` - - - `:"interleaved-thinking-2025-05-14"` - - - `:"code-execution-2025-05-22"` - - - `:"extended-cache-ttl-2025-04-11"` - - - `:"context-1m-2025-08-07"` - - - `:"context-management-2025-06-27"` - - - `:"model-context-window-exceeded-2025-08-26"` - - - `:"skills-2025-10-02"` - - - `:"fast-mode-2026-02-01"` + - `:"user-profiles-2026-03-24"` + +### Returns + +- `class BetaModelInfo` + + - `id: String` + + Unique model identifier. + + - `capabilities: BetaModelCapabilities` + + Model capability information. + + - `batch: BetaCapabilitySupport` + + Whether the model supports the Batch API. + + - `supported: bool` + + Whether this capability is supported by the model. + + - `citations: BetaCapabilitySupport` + + Whether the model supports citation generation. + + - `supported: bool` + + Whether this capability is supported by the model. + + - `code_execution: BetaCapabilitySupport` + + Whether the model supports code execution tools. + + - `supported: bool` + + Whether this capability is supported by the model. + + - `context_management: BetaContextManagementCapability` + + Context management support and available strategies. + + - `clear_thinking_20251015: BetaCapabilitySupport` + + Indicates whether a capability is supported. + + - `supported: bool` + + Whether this capability is supported by the model. + + - `clear_tool_uses_20250919: BetaCapabilitySupport` + + Indicates whether a capability is supported. + + - `supported: bool` + + Whether this capability is supported by the model. + + - `compact_20260112: BetaCapabilitySupport` + + Indicates whether a capability is supported. + + - `supported: bool` + + Whether this capability is supported by the model. + + - `supported: bool` + + Whether this capability is supported by the model. + + - `effort: BetaEffortCapability` + + Effort (reasoning_effort) support and available levels. + + - `high: BetaCapabilitySupport` + + Whether the model supports high effort level. + + - `supported: bool` + + Whether this capability is supported by the model. + + - `low: BetaCapabilitySupport` + + Whether the model supports low effort level. + + - `supported: bool` + + Whether this capability is supported by the model. + + - `max: BetaCapabilitySupport` + + Whether the model supports max effort level. + + - `supported: bool` + + Whether this capability is supported by the model. + + - `medium: BetaCapabilitySupport` + + Whether the model supports medium effort level. + + - `supported: bool` + + Whether this capability is supported by the model. + + - `supported: bool` + + Whether this capability is supported by the model. + + - `image_input: BetaCapabilitySupport` + + Whether the model accepts image content blocks. + + - `supported: bool` + + Whether this capability is supported by the model. + + - `pdf_input: BetaCapabilitySupport` + + Whether the model accepts PDF content blocks. + + - `supported: bool` + + Whether this capability is supported by the model. + + - `structured_outputs: BetaCapabilitySupport` + + Whether the model supports structured output / JSON mode / strict tool schemas. + + - `supported: bool` + + Whether this capability is supported by the model. + + - `thinking: BetaThinkingCapability` + + Thinking capability and supported type configurations. + + - `supported: bool` + + Whether this capability is supported by the model. + + - `types: BetaThinkingTypes` + + Supported thinking type configurations. + + - `adaptive: BetaCapabilitySupport` + + Whether the model supports thinking with type 'adaptive' (auto). + + - `supported: bool` + + Whether this capability is supported by the model. + + - `enabled: BetaCapabilitySupport` + + Whether the model supports thinking with type 'enabled'. + + - `supported: bool` + + Whether this capability is supported by the model. + + - `created_at: Time` + + RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown. + + - `display_name: String` + + A human-readable name for the model. + + - `max_input_tokens: Integer` + + Maximum input context window size in tokens for this model. + + - `max_tokens: Integer` + + Maximum value for the `max_tokens` parameter when using this model. + + - `type: :model` + + Object type. + + For Models, this is always `"model"`. + + - `:model` + +### Example + +```ruby +require "anthropic" + +anthropic = Anthropic::Client.new(api_key: "my-anthropic-api-key") + +page = anthropic.beta.models.list + +puts(page) +``` + +## Retrieve + +`beta.models.retrieve(model_id, **kwargs) -> BetaModelInfo` + +**get** `/v1/models/{model_id}` + +Get a specific model. + +The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID. + +### Parameters + +- `model_id: String` + + Model identifier or alias. + +- `betas: Array[AnthropicBeta]` + + Optional header to specify the beta version(s) you want to use. + + - `String` + + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` + + - `:"message-batches-2024-09-24"` + + - `:"prompt-caching-2024-07-31"` + + - `:"computer-use-2024-10-22"` + + - `:"computer-use-2025-01-24"` + + - `:"pdfs-2024-09-25"` + + - `:"token-counting-2024-11-01"` + + - `:"token-efficient-tools-2025-02-19"` + + - `:"output-128k-2025-02-19"` + + - `:"files-api-2025-04-14"` + + - `:"mcp-client-2025-04-04"` + + - `:"mcp-client-2025-11-20"` + + - `:"dev-full-thinking-2025-05-14"` + + - `:"interleaved-thinking-2025-05-14"` + + - `:"code-execution-2025-05-22"` + + - `:"extended-cache-ttl-2025-04-11"` + + - `:"context-1m-2025-08-07"` + + - `:"context-management-2025-06-27"` + + - `:"model-context-window-exceeded-2025-08-26"` + + - `:"skills-2025-10-02"` + + - `:"fast-mode-2026-02-01"` + + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` ### Returns @@ -5988,13 +6000,17 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en Recommended for advanced use cases only. You usually only need to use `temperature`. +- `user_profile_id: String` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + - `betas: Array[AnthropicBeta]` Optional header to specify the beta version(s) you want to use. - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -6036,6 +6052,10 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class BetaMessage` @@ -7035,6 +7055,30 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `:assistant` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -11834,7 +11878,7 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -11876,6 +11920,10 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageTokensCount` @@ -19168,6 +19216,30 @@ puts(beta_message_tokens_count) - `:assistant` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -23279,7 +23351,7 @@ puts(beta_message_tokens_count) - `:clear_thinking_20251015` - - `delta: { container, stop_reason, stop_sequence}` + - `delta: { container, stop_details, stop_reason, stop_sequence}` - `container: BetaContainer` @@ -23313,6 +23385,30 @@ puts(beta_message_tokens_count) Skill version or 'latest' for most recent version + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: BetaStopReason` - `:end_turn` @@ -24464,6 +24560,30 @@ puts(beta_message_tokens_count) - `:assistant` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -25684,6 +25804,30 @@ puts(beta_message_tokens_count) - `:assistant` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -25935,7 +26079,7 @@ puts(beta_message_tokens_count) - `:clear_thinking_20251015` - - `delta: { container, stop_reason, stop_sequence}` + - `delta: { container, stop_details, stop_reason, stop_sequence}` - `container: BetaContainer` @@ -25969,6 +26113,30 @@ puts(beta_message_tokens_count) Skill version or 'latest' for most recent version + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: BetaStopReason` - `:end_turn` @@ -27113,6 +27281,32 @@ puts(beta_message_tokens_count) - `:redacted_thinking` +### Beta Refusal Stop Details + +- `class BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + ### Beta Request Document Block - `class BetaRequestDocumentBlock` @@ -34083,7 +34277,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Must be unique for each request within the Message Batch. - - `params: { max_tokens, messages, model, 19 more}` + - `params: { max_tokens, messages, model, 20 more}` Messages API creation parameters for the individual request. @@ -38751,178 +38945,9 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Recommended for advanced use cases only. You usually only need to use `temperature`. -- `betas: Array[AnthropicBeta]` - - Optional header to specify the beta version(s) you want to use. - - - `String` - - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` - - - `:"message-batches-2024-09-24"` - - - `:"prompt-caching-2024-07-31"` - - - `:"computer-use-2024-10-22"` - - - `:"computer-use-2025-01-24"` - - - `:"pdfs-2024-09-25"` - - - `:"token-counting-2024-11-01"` - - - `:"token-efficient-tools-2025-02-19"` - - - `:"output-128k-2025-02-19"` - - - `:"files-api-2025-04-14"` - - - `:"mcp-client-2025-04-04"` - - - `:"mcp-client-2025-11-20"` - - - `:"dev-full-thinking-2025-05-14"` - - - `:"interleaved-thinking-2025-05-14"` - - - `:"code-execution-2025-05-22"` - - - `:"extended-cache-ttl-2025-04-11"` - - - `:"context-1m-2025-08-07"` - - - `:"context-management-2025-06-27"` - - - `:"model-context-window-exceeded-2025-08-26"` - - - `:"skills-2025-10-02"` - - - `:"fast-mode-2026-02-01"` - -### Returns - -- `class BetaMessageBatch` - - - `id: String` - - Unique object identifier. - - The format and length of IDs may change over time. - - - `archived_at: Time` - - RFC 3339 datetime string representing the time at which the Message Batch was archived and its results became unavailable. - - - `cancel_initiated_at: Time` - - RFC 3339 datetime string representing the time at which cancellation was initiated for the Message Batch. Specified only if cancellation was initiated. - - - `created_at: Time` - - RFC 3339 datetime string representing the time at which the Message Batch was created. - - - `ended_at: Time` - - RFC 3339 datetime string representing the time at which processing for the Message Batch ended. Specified only once processing ends. - - Processing ends when every request in a Message Batch has either succeeded, errored, canceled, or expired. - - - `expires_at: Time` - - RFC 3339 datetime string representing the time at which the Message Batch will expire and end processing, which is 24 hours after creation. - - - `processing_status: :in_progress | :canceling | :ended` - - Processing status of the Message Batch. - - - `:in_progress` - - - `:canceling` - - - `:ended` - - - `request_counts: BetaMessageBatchRequestCounts` - - Tallies requests within the Message Batch, categorized by their status. - - Requests start as `processing` and move to one of the other statuses only once processing of the entire batch ends. The sum of all values always matches the total number of requests in the batch. - - - `canceled: Integer` - - Number of requests in the Message Batch that have been canceled. - - This is zero until processing of the entire Message Batch has ended. - - - `errored: Integer` - - Number of requests in the Message Batch that encountered an error. - - This is zero until processing of the entire Message Batch has ended. - - - `expired: Integer` - - Number of requests in the Message Batch that have expired. - - This is zero until processing of the entire Message Batch has ended. - - - `processing: Integer` - - Number of requests in the Message Batch that are processing. - - - `succeeded: Integer` - - Number of requests in the Message Batch that have completed successfully. + - `user_profile_id: String` - This is zero until processing of the entire Message Batch has ended. - - - `results_url: String` - - URL to a `.jsonl` file containing the results of the Message Batch requests. Specified only once processing ends. - - Results in the file are not guaranteed to be in the same order as requests. Use the `custom_id` field to match results to requests. - - - `type: :message_batch` - - Object type. - - For Message Batches, this is always `"message_batch"`. - - - `:message_batch` - -### Example - -```ruby -require "anthropic" - -anthropic = Anthropic::Client.new(api_key: "my-anthropic-api-key") - -beta_message_batch = anthropic.beta.messages.batches.create( - requests: [ - { - custom_id: "my-custom-id-1", - params: {max_tokens: 1024, messages: [{content: "Hello, world", role: :user}], model: :"claude-opus-4-6"} - } - ] -) - -puts(beta_message_batch) -``` - -## Retrieve - -`beta.messages.batches.retrieve(message_batch_id, **kwargs) -> BetaMessageBatch` - -**get** `/v1/messages/batches/{message_batch_id}` - -This endpoint is idempotent and can be used to poll for Message Batch completion. To access the results of a Message Batch, make a request to the `results_url` field in the response. - -Learn more about the Message Batches API in our [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing) - -### Parameters - -- `message_batch_id: String` - - ID of the Message Batch. + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. - `betas: Array[AnthropicBeta]` @@ -38930,7 +38955,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -38972,6 +38997,187 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + +### Returns + +- `class BetaMessageBatch` + + - `id: String` + + Unique object identifier. + + The format and length of IDs may change over time. + + - `archived_at: Time` + + RFC 3339 datetime string representing the time at which the Message Batch was archived and its results became unavailable. + + - `cancel_initiated_at: Time` + + RFC 3339 datetime string representing the time at which cancellation was initiated for the Message Batch. Specified only if cancellation was initiated. + + - `created_at: Time` + + RFC 3339 datetime string representing the time at which the Message Batch was created. + + - `ended_at: Time` + + RFC 3339 datetime string representing the time at which processing for the Message Batch ended. Specified only once processing ends. + + Processing ends when every request in a Message Batch has either succeeded, errored, canceled, or expired. + + - `expires_at: Time` + + RFC 3339 datetime string representing the time at which the Message Batch will expire and end processing, which is 24 hours after creation. + + - `processing_status: :in_progress | :canceling | :ended` + + Processing status of the Message Batch. + + - `:in_progress` + + - `:canceling` + + - `:ended` + + - `request_counts: BetaMessageBatchRequestCounts` + + Tallies requests within the Message Batch, categorized by their status. + + Requests start as `processing` and move to one of the other statuses only once processing of the entire batch ends. The sum of all values always matches the total number of requests in the batch. + + - `canceled: Integer` + + Number of requests in the Message Batch that have been canceled. + + This is zero until processing of the entire Message Batch has ended. + + - `errored: Integer` + + Number of requests in the Message Batch that encountered an error. + + This is zero until processing of the entire Message Batch has ended. + + - `expired: Integer` + + Number of requests in the Message Batch that have expired. + + This is zero until processing of the entire Message Batch has ended. + + - `processing: Integer` + + Number of requests in the Message Batch that are processing. + + - `succeeded: Integer` + + Number of requests in the Message Batch that have completed successfully. + + This is zero until processing of the entire Message Batch has ended. + + - `results_url: String` + + URL to a `.jsonl` file containing the results of the Message Batch requests. Specified only once processing ends. + + Results in the file are not guaranteed to be in the same order as requests. Use the `custom_id` field to match results to requests. + + - `type: :message_batch` + + Object type. + + For Message Batches, this is always `"message_batch"`. + + - `:message_batch` + +### Example + +```ruby +require "anthropic" + +anthropic = Anthropic::Client.new(api_key: "my-anthropic-api-key") + +beta_message_batch = anthropic.beta.messages.batches.create( + requests: [ + { + custom_id: "my-custom-id-1", + params: {max_tokens: 1024, messages: [{content: "Hello, world", role: :user}], model: :"claude-opus-4-6"} + } + ] +) + +puts(beta_message_batch) +``` + +## Retrieve + +`beta.messages.batches.retrieve(message_batch_id, **kwargs) -> BetaMessageBatch` + +**get** `/v1/messages/batches/{message_batch_id}` + +This endpoint is idempotent and can be used to poll for Message Batch completion. To access the results of a Message Batch, make a request to the `results_url` field in the response. + +Learn more about the Message Batches API in our [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing) + +### Parameters + +- `message_batch_id: String` + + ID of the Message Batch. + +- `betas: Array[AnthropicBeta]` + + Optional header to specify the beta version(s) you want to use. + + - `String` + + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` + + - `:"message-batches-2024-09-24"` + + - `:"prompt-caching-2024-07-31"` + + - `:"computer-use-2024-10-22"` + + - `:"computer-use-2025-01-24"` + + - `:"pdfs-2024-09-25"` + + - `:"token-counting-2024-11-01"` + + - `:"token-efficient-tools-2025-02-19"` + + - `:"output-128k-2025-02-19"` + + - `:"files-api-2025-04-14"` + + - `:"mcp-client-2025-04-04"` + + - `:"mcp-client-2025-11-20"` + + - `:"dev-full-thinking-2025-05-14"` + + - `:"interleaved-thinking-2025-05-14"` + + - `:"code-execution-2025-05-22"` + + - `:"extended-cache-ttl-2025-04-11"` + + - `:"context-1m-2025-08-07"` + + - `:"context-management-2025-06-27"` + + - `:"model-context-window-exceeded-2025-08-26"` + + - `:"skills-2025-10-02"` + + - `:"fast-mode-2026-02-01"` + + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatch` @@ -39106,7 +39312,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -39148,6 +39354,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatch` @@ -39274,7 +39484,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -39316,6 +39526,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatch` @@ -39442,7 +39656,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -39484,6 +39698,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class BetaDeletedMessageBatch` @@ -39536,7 +39754,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -39578,6 +39796,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatchIndividualResponse` @@ -40595,6 +40817,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `:assistant` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -42147,6 +42393,30 @@ puts(beta_message_batch_individual_response) - `:assistant` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -43495,6 +43765,30 @@ puts(beta_message_batch_individual_response) - `:assistant` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -44805,6 +45099,30 @@ puts(beta_message_batch_individual_response) - `:assistant` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -45036,7 +45354,7 @@ Upload File - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -45078,127 +45396,135 @@ Upload File - `:"fast-mode-2026-02-01"` -### Returns - -- `class FileMetadata` - - - `id: String` - - Unique object identifier. - - The format and length of IDs may change over time. - - - `created_at: Time` - - RFC 3339 datetime string representing when the file was created. - - - `filename: String` - - Original filename of the uploaded file. - - - `mime_type: String` - - MIME type of the file. - - - `size_bytes: Integer` - - Size of the file in bytes. - - - `type: :file` - - Object type. - - For files, this is always `"file"`. - - - `:file` - - - `downloadable: bool` - - Whether the file can be downloaded. - -### Example - -```ruby -require "anthropic" - -anthropic = Anthropic::Client.new(api_key: "my-anthropic-api-key") - -file_metadata = anthropic.beta.files.upload(file: StringIO.new("Example data")) - -puts(file_metadata) -``` - -## List - -`beta.files.list(**kwargs) -> Page` - -**get** `/v1/files` - -List Files - -### Parameters - -- `after_id: String` - - ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object. - -- `before_id: String` - - ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object. - -- `limit: Integer` - - Number of items to return per page. - - Defaults to `20`. Ranges from `1` to `1000`. - -- `betas: Array[AnthropicBeta]` - - Optional header to specify the beta version(s) you want to use. - - - `String` - - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` - - - `:"message-batches-2024-09-24"` - - - `:"prompt-caching-2024-07-31"` - - - `:"computer-use-2024-10-22"` - - - `:"computer-use-2025-01-24"` - - - `:"pdfs-2024-09-25"` - - - `:"token-counting-2024-11-01"` - - - `:"token-efficient-tools-2025-02-19"` - - - `:"output-128k-2025-02-19"` - - - `:"files-api-2025-04-14"` - - - `:"mcp-client-2025-04-04"` - - - `:"mcp-client-2025-11-20"` - - - `:"dev-full-thinking-2025-05-14"` - - - `:"interleaved-thinking-2025-05-14"` - - - `:"code-execution-2025-05-22"` + - `:"output-300k-2026-03-24"` - - `:"extended-cache-ttl-2025-04-11"` - - - `:"context-1m-2025-08-07"` - - - `:"context-management-2025-06-27"` - - - `:"model-context-window-exceeded-2025-08-26"` - - - `:"skills-2025-10-02"` - - - `:"fast-mode-2026-02-01"` + - `:"user-profiles-2026-03-24"` + +### Returns + +- `class FileMetadata` + + - `id: String` + + Unique object identifier. + + The format and length of IDs may change over time. + + - `created_at: Time` + + RFC 3339 datetime string representing when the file was created. + + - `filename: String` + + Original filename of the uploaded file. + + - `mime_type: String` + + MIME type of the file. + + - `size_bytes: Integer` + + Size of the file in bytes. + + - `type: :file` + + Object type. + + For files, this is always `"file"`. + + - `:file` + + - `downloadable: bool` + + Whether the file can be downloaded. + +### Example + +```ruby +require "anthropic" + +anthropic = Anthropic::Client.new(api_key: "my-anthropic-api-key") + +file_metadata = anthropic.beta.files.upload(file: StringIO.new("Example data")) + +puts(file_metadata) +``` + +## List + +`beta.files.list(**kwargs) -> Page` + +**get** `/v1/files` + +List Files + +### Parameters + +- `after_id: String` + + ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object. + +- `before_id: String` + + ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object. + +- `limit: Integer` + + Number of items to return per page. + + Defaults to `20`. Ranges from `1` to `1000`. + +- `betas: Array[AnthropicBeta]` + + Optional header to specify the beta version(s) you want to use. + + - `String` + + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` + + - `:"message-batches-2024-09-24"` + + - `:"prompt-caching-2024-07-31"` + + - `:"computer-use-2024-10-22"` + + - `:"computer-use-2025-01-24"` + + - `:"pdfs-2024-09-25"` + + - `:"token-counting-2024-11-01"` + + - `:"token-efficient-tools-2025-02-19"` + + - `:"output-128k-2025-02-19"` + + - `:"files-api-2025-04-14"` + + - `:"mcp-client-2025-04-04"` + + - `:"mcp-client-2025-11-20"` + + - `:"dev-full-thinking-2025-05-14"` + + - `:"interleaved-thinking-2025-05-14"` + + - `:"code-execution-2025-05-22"` + + - `:"extended-cache-ttl-2025-04-11"` + + - `:"context-1m-2025-08-07"` + + - `:"context-management-2025-06-27"` + + - `:"model-context-window-exceeded-2025-08-26"` + + - `:"skills-2025-10-02"` + + - `:"fast-mode-2026-02-01"` + + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` ### Returns @@ -45270,7 +45596,7 @@ Download File - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -45312,6 +45638,10 @@ Download File - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `StringIO` @@ -45348,7 +45678,7 @@ Get File Metadata - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -45390,6 +45720,10 @@ Get File Metadata - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class FileMetadata` @@ -45460,7 +45794,7 @@ Delete File - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -45502,6 +45836,10 @@ Delete File - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class DeletedFile` @@ -45616,7 +45954,7 @@ Create Skill - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -45658,145 +45996,153 @@ Create Skill - `:"fast-mode-2026-02-01"` -### Returns - -- `class SkillCreateResponse` - - - `id: String` - - Unique identifier for the skill. - - The format and length of IDs may change over time. - - - `created_at: String` - - ISO 8601 timestamp of when the skill was created. - - - `display_title: String` - - Display title for the skill. - - This is a human-readable label that is not included in the prompt sent to the model. - - - `latest_version: String` - - The latest version identifier for the skill. - - This represents the most recent version of the skill that has been created. - - - `source: String` - - Source of the skill. - - This may be one of the following values: - - * `"custom"`: the skill was created by a user - * `"anthropic"`: the skill was created by Anthropic - - - `type: String` - - Object type. - - For Skills, this is always `"skill"`. - - - `updated_at: String` - - ISO 8601 timestamp of when the skill was last updated. - -### Example - -```ruby -require "anthropic" - -anthropic = Anthropic::Client.new(api_key: "my-anthropic-api-key") - -skill = anthropic.beta.skills.create - -puts(skill) -``` - -## List - -`beta.skills.list(**kwargs) -> PageCursor` - -**get** `/v1/skills` - -List Skills - -### Parameters - -- `limit: Integer` - - Number of results to return per page. - - Maximum value is 100. Defaults to 20. - -- `page: String` - - Pagination token for fetching a specific page of results. - - Pass the value from a previous response's `next_page` field to get the next page of results. - -- `source: String` - - Filter skills by source. - - If provided, only skills from the specified source will be returned: - - * `"custom"`: only return user-created skills - * `"anthropic"`: only return Anthropic-created skills - -- `betas: Array[AnthropicBeta]` - - Optional header to specify the beta version(s) you want to use. - - - `String` - - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` - - - `:"message-batches-2024-09-24"` - - - `:"prompt-caching-2024-07-31"` - - - `:"computer-use-2024-10-22"` - - - `:"computer-use-2025-01-24"` + - `:"output-300k-2026-03-24"` - - `:"pdfs-2024-09-25"` - - - `:"token-counting-2024-11-01"` - - - `:"token-efficient-tools-2025-02-19"` - - - `:"output-128k-2025-02-19"` - - - `:"files-api-2025-04-14"` - - - `:"mcp-client-2025-04-04"` - - - `:"mcp-client-2025-11-20"` - - - `:"dev-full-thinking-2025-05-14"` - - - `:"interleaved-thinking-2025-05-14"` - - - `:"code-execution-2025-05-22"` - - - `:"extended-cache-ttl-2025-04-11"` - - - `:"context-1m-2025-08-07"` - - - `:"context-management-2025-06-27"` - - - `:"model-context-window-exceeded-2025-08-26"` - - - `:"skills-2025-10-02"` - - - `:"fast-mode-2026-02-01"` + - `:"user-profiles-2026-03-24"` ### Returns -- `class SkillListResponse` +- `class SkillCreateResponse` + + - `id: String` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + + - `created_at: String` + + ISO 8601 timestamp of when the skill was created. + + - `display_title: String` + + Display title for the skill. + + This is a human-readable label that is not included in the prompt sent to the model. + + - `latest_version: String` + + The latest version identifier for the skill. + + This represents the most recent version of the skill that has been created. + + - `source: String` + + Source of the skill. + + This may be one of the following values: + + * `"custom"`: the skill was created by a user + * `"anthropic"`: the skill was created by Anthropic + + - `type: String` + + Object type. + + For Skills, this is always `"skill"`. + + - `updated_at: String` + + ISO 8601 timestamp of when the skill was last updated. + +### Example + +```ruby +require "anthropic" + +anthropic = Anthropic::Client.new(api_key: "my-anthropic-api-key") + +skill = anthropic.beta.skills.create + +puts(skill) +``` + +## List + +`beta.skills.list(**kwargs) -> PageCursor` + +**get** `/v1/skills` + +List Skills + +### Parameters + +- `limit: Integer` + + Number of results to return per page. + + Maximum value is 100. Defaults to 20. + +- `page: String` + + Pagination token for fetching a specific page of results. + + Pass the value from a previous response's `next_page` field to get the next page of results. + +- `source: String` + + Filter skills by source. + + If provided, only skills from the specified source will be returned: + + * `"custom"`: only return user-created skills + * `"anthropic"`: only return Anthropic-created skills + +- `betas: Array[AnthropicBeta]` + + Optional header to specify the beta version(s) you want to use. + + - `String` + + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` + + - `:"message-batches-2024-09-24"` + + - `:"prompt-caching-2024-07-31"` + + - `:"computer-use-2024-10-22"` + + - `:"computer-use-2025-01-24"` + + - `:"pdfs-2024-09-25"` + + - `:"token-counting-2024-11-01"` + + - `:"token-efficient-tools-2025-02-19"` + + - `:"output-128k-2025-02-19"` + + - `:"files-api-2025-04-14"` + + - `:"mcp-client-2025-04-04"` + + - `:"mcp-client-2025-11-20"` + + - `:"dev-full-thinking-2025-05-14"` + + - `:"interleaved-thinking-2025-05-14"` + + - `:"code-execution-2025-05-22"` + + - `:"extended-cache-ttl-2025-04-11"` + + - `:"context-1m-2025-08-07"` + + - `:"context-management-2025-06-27"` + + - `:"model-context-window-exceeded-2025-08-26"` + + - `:"skills-2025-10-02"` + + - `:"fast-mode-2026-02-01"` + + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + +### Returns + +- `class SkillListResponse` - `id: String` @@ -45873,7 +46219,7 @@ Get Skill - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -45915,6 +46261,10 @@ Get Skill - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class SkillRetrieveResponse` @@ -45994,7 +46344,7 @@ Delete Skill - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -46036,6 +46386,10 @@ Delete Skill - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class SkillDeleteResponse` @@ -46064,6 +46418,159 @@ skill = anthropic.beta.skills.delete("skill_id") puts(skill) ``` +## Domain Types + +### Skill Create Response + +- `class SkillCreateResponse` + + - `id: String` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + + - `created_at: String` + + ISO 8601 timestamp of when the skill was created. + + - `display_title: String` + + Display title for the skill. + + This is a human-readable label that is not included in the prompt sent to the model. + + - `latest_version: String` + + The latest version identifier for the skill. + + This represents the most recent version of the skill that has been created. + + - `source: String` + + Source of the skill. + + This may be one of the following values: + + * `"custom"`: the skill was created by a user + * `"anthropic"`: the skill was created by Anthropic + + - `type: String` + + Object type. + + For Skills, this is always `"skill"`. + + - `updated_at: String` + + ISO 8601 timestamp of when the skill was last updated. + +### Skill List Response + +- `class SkillListResponse` + + - `id: String` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + + - `created_at: String` + + ISO 8601 timestamp of when the skill was created. + + - `display_title: String` + + Display title for the skill. + + This is a human-readable label that is not included in the prompt sent to the model. + + - `latest_version: String` + + The latest version identifier for the skill. + + This represents the most recent version of the skill that has been created. + + - `source: String` + + Source of the skill. + + This may be one of the following values: + + * `"custom"`: the skill was created by a user + * `"anthropic"`: the skill was created by Anthropic + + - `type: String` + + Object type. + + For Skills, this is always `"skill"`. + + - `updated_at: String` + + ISO 8601 timestamp of when the skill was last updated. + +### Skill Retrieve Response + +- `class SkillRetrieveResponse` + + - `id: String` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + + - `created_at: String` + + ISO 8601 timestamp of when the skill was created. + + - `display_title: String` + + Display title for the skill. + + This is a human-readable label that is not included in the prompt sent to the model. + + - `latest_version: String` + + The latest version identifier for the skill. + + This represents the most recent version of the skill that has been created. + + - `source: String` + + Source of the skill. + + This may be one of the following values: + + * `"custom"`: the skill was created by a user + * `"anthropic"`: the skill was created by Anthropic + + - `type: String` + + Object type. + + For Skills, this is always `"skill"`. + + - `updated_at: String` + + ISO 8601 timestamp of when the skill was last updated. + +### Skill Delete Response + +- `class SkillDeleteResponse` + + - `id: String` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + + - `type: String` + + Deleted object type. + + For Skills, this is always `"skill_deleted"`. + # Versions ## Create @@ -46094,7 +46601,7 @@ Create Skill Version - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -46136,6 +46643,10 @@ Create Skill Version - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class VersionCreateResponse` @@ -46228,7 +46739,7 @@ List Skill Versions - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -46270,6 +46781,10 @@ List Skill Versions - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class VersionListResponse` @@ -46358,7 +46873,7 @@ Get Skill Version - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -46400,6 +46915,10 @@ Get Skill Version - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class VersionRetrieveResponse` @@ -46488,7 +47007,7 @@ Delete Skill Version - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -46530,6 +47049,10 @@ Delete Skill Version - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class VersionDeleteResponse` @@ -46557,3 +47080,723 @@ version = anthropic.beta.skills.versions.delete("version", skill_id: "skill_id") puts(version) ``` + +## Domain Types + +### Version Create Response + +- `class VersionCreateResponse` + + - `id: String` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: String` + + ISO 8601 timestamp of when the skill version was created. + + - `description: String` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: String` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: String` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: String` + + Identifier for the skill that this version belongs to. + + - `type: String` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: String` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version List Response + +- `class VersionListResponse` + + - `id: String` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: String` + + ISO 8601 timestamp of when the skill version was created. + + - `description: String` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: String` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: String` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: String` + + Identifier for the skill that this version belongs to. + + - `type: String` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: String` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version Retrieve Response + +- `class VersionRetrieveResponse` + + - `id: String` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: String` + + ISO 8601 timestamp of when the skill version was created. + + - `description: String` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: String` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: String` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: String` + + Identifier for the skill that this version belongs to. + + - `type: String` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: String` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version Delete Response + +- `class VersionDeleteResponse` + + - `id: String` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + + - `type: String` + + Deleted object type. + + For Skill Versions, this is always `"skill_version_deleted"`. + +# User Profiles + +## Create + +`beta.user_profiles.create(**kwargs) -> BetaUserProfile` + +**post** `/v1/user_profiles` + +Create User Profile + +### Parameters + +- `external_id: String` + +- `metadata: Hash[Symbol, String]` + + Free-form key-value data to attach to this user profile. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. Values must be non-empty strings. + +- `betas: Array[AnthropicBeta]` + + Optional header to specify the beta version(s) you want to use. + + - `String` + + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` + + - `:"message-batches-2024-09-24"` + + - `:"prompt-caching-2024-07-31"` + + - `:"computer-use-2024-10-22"` + + - `:"computer-use-2025-01-24"` + + - `:"pdfs-2024-09-25"` + + - `:"token-counting-2024-11-01"` + + - `:"token-efficient-tools-2025-02-19"` + + - `:"output-128k-2025-02-19"` + + - `:"files-api-2025-04-14"` + + - `:"mcp-client-2025-04-04"` + + - `:"mcp-client-2025-11-20"` + + - `:"dev-full-thinking-2025-05-14"` + + - `:"interleaved-thinking-2025-05-14"` + + - `:"code-execution-2025-05-22"` + + - `:"extended-cache-ttl-2025-04-11"` + + - `:"context-1m-2025-08-07"` + + - `:"context-management-2025-06-27"` + + - `:"model-context-window-exceeded-2025-08-26"` + + - `:"skills-2025-10-02"` + + - `:"fast-mode-2026-02-01"` + + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + +### Returns + +- `class BetaUserProfile` + + - `id: String` + + - `created_at: Time` + + A timestamp in RFC 3339 format + + - `metadata: Hash[Symbol, String]` + + - `trust_grants: Hash[Symbol, BetaUserProfileTrustGrant]` + + - `status: String` + + - `type: String` + + - `updated_at: Time` + + A timestamp in RFC 3339 format + + - `external_id: String` + +### Example + +```ruby +require "anthropic" + +anthropic = Anthropic::Client.new(api_key: "my-anthropic-api-key") + +beta_user_profile = anthropic.beta.user_profiles.create + +puts(beta_user_profile) +``` + +## List + +`beta.user_profiles.list(**kwargs) -> PageCursorV2` + +**get** `/v1/user_profiles` + +List User Profiles + +### Parameters + +- `limit: Integer` + + Query parameter for limit + +- `order: :asc | :desc` + + Query parameter for order + + - `:asc` + + - `:desc` + +- `page: String` + + Query parameter for page + +- `betas: Array[AnthropicBeta]` + + Optional header to specify the beta version(s) you want to use. + + - `String` + + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` + + - `:"message-batches-2024-09-24"` + + - `:"prompt-caching-2024-07-31"` + + - `:"computer-use-2024-10-22"` + + - `:"computer-use-2025-01-24"` + + - `:"pdfs-2024-09-25"` + + - `:"token-counting-2024-11-01"` + + - `:"token-efficient-tools-2025-02-19"` + + - `:"output-128k-2025-02-19"` + + - `:"files-api-2025-04-14"` + + - `:"mcp-client-2025-04-04"` + + - `:"mcp-client-2025-11-20"` + + - `:"dev-full-thinking-2025-05-14"` + + - `:"interleaved-thinking-2025-05-14"` + + - `:"code-execution-2025-05-22"` + + - `:"extended-cache-ttl-2025-04-11"` + + - `:"context-1m-2025-08-07"` + + - `:"context-management-2025-06-27"` + + - `:"model-context-window-exceeded-2025-08-26"` + + - `:"skills-2025-10-02"` + + - `:"fast-mode-2026-02-01"` + + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + +### Returns + +- `class BetaUserProfile` + + - `id: String` + + - `created_at: Time` + + A timestamp in RFC 3339 format + + - `metadata: Hash[Symbol, String]` + + - `trust_grants: Hash[Symbol, BetaUserProfileTrustGrant]` + + - `status: String` + + - `type: String` + + - `updated_at: Time` + + A timestamp in RFC 3339 format + + - `external_id: String` + +### Example + +```ruby +require "anthropic" + +anthropic = Anthropic::Client.new(api_key: "my-anthropic-api-key") + +page = anthropic.beta.user_profiles.list + +puts(page) +``` + +## Retrieve + +`beta.user_profiles.retrieve(id, **kwargs) -> BetaUserProfile` + +**get** `/v1/user_profiles/{id}` + +Get User Profile + +### Parameters + +- `id: String` + +- `betas: Array[AnthropicBeta]` + + Optional header to specify the beta version(s) you want to use. + + - `String` + + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` + + - `:"message-batches-2024-09-24"` + + - `:"prompt-caching-2024-07-31"` + + - `:"computer-use-2024-10-22"` + + - `:"computer-use-2025-01-24"` + + - `:"pdfs-2024-09-25"` + + - `:"token-counting-2024-11-01"` + + - `:"token-efficient-tools-2025-02-19"` + + - `:"output-128k-2025-02-19"` + + - `:"files-api-2025-04-14"` + + - `:"mcp-client-2025-04-04"` + + - `:"mcp-client-2025-11-20"` + + - `:"dev-full-thinking-2025-05-14"` + + - `:"interleaved-thinking-2025-05-14"` + + - `:"code-execution-2025-05-22"` + + - `:"extended-cache-ttl-2025-04-11"` + + - `:"context-1m-2025-08-07"` + + - `:"context-management-2025-06-27"` + + - `:"model-context-window-exceeded-2025-08-26"` + + - `:"skills-2025-10-02"` + + - `:"fast-mode-2026-02-01"` + + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + +### Returns + +- `class BetaUserProfile` + + - `id: String` + + - `created_at: Time` + + A timestamp in RFC 3339 format + + - `metadata: Hash[Symbol, String]` + + - `trust_grants: Hash[Symbol, BetaUserProfileTrustGrant]` + + - `status: String` + + - `type: String` + + - `updated_at: Time` + + A timestamp in RFC 3339 format + + - `external_id: String` + +### Example + +```ruby +require "anthropic" + +anthropic = Anthropic::Client.new(api_key: "my-anthropic-api-key") + +beta_user_profile = anthropic.beta.user_profiles.retrieve("id") + +puts(beta_user_profile) +``` + +## Update + +`beta.user_profiles.update(id, **kwargs) -> BetaUserProfile` + +**post** `/v1/user_profiles/{id}` + +Update User Profile + +### Parameters + +- `id: String` + +- `external_id: String` + +- `metadata: Hash[Symbol, String]` + + Key-value pairs to merge into the stored metadata. Keys provided overwrite existing values. To remove a key, set its value to an empty string. Keys not provided are left unchanged. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. + +- `betas: Array[AnthropicBeta]` + + Optional header to specify the beta version(s) you want to use. + + - `String` + + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` + + - `:"message-batches-2024-09-24"` + + - `:"prompt-caching-2024-07-31"` + + - `:"computer-use-2024-10-22"` + + - `:"computer-use-2025-01-24"` + + - `:"pdfs-2024-09-25"` + + - `:"token-counting-2024-11-01"` + + - `:"token-efficient-tools-2025-02-19"` + + - `:"output-128k-2025-02-19"` + + - `:"files-api-2025-04-14"` + + - `:"mcp-client-2025-04-04"` + + - `:"mcp-client-2025-11-20"` + + - `:"dev-full-thinking-2025-05-14"` + + - `:"interleaved-thinking-2025-05-14"` + + - `:"code-execution-2025-05-22"` + + - `:"extended-cache-ttl-2025-04-11"` + + - `:"context-1m-2025-08-07"` + + - `:"context-management-2025-06-27"` + + - `:"model-context-window-exceeded-2025-08-26"` + + - `:"skills-2025-10-02"` + + - `:"fast-mode-2026-02-01"` + + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + +### Returns + +- `class BetaUserProfile` + + - `id: String` + + - `created_at: Time` + + A timestamp in RFC 3339 format + + - `metadata: Hash[Symbol, String]` + + - `trust_grants: Hash[Symbol, BetaUserProfileTrustGrant]` + + - `status: String` + + - `type: String` + + - `updated_at: Time` + + A timestamp in RFC 3339 format + + - `external_id: String` + +### Example + +```ruby +require "anthropic" + +anthropic = Anthropic::Client.new(api_key: "my-anthropic-api-key") + +beta_user_profile = anthropic.beta.user_profiles.update("id") + +puts(beta_user_profile) +``` + +## Create Enrollment URL + +`beta.user_profiles.create_enrollment_url(id, **kwargs) -> BetaUserProfileEnrollmentURL` + +**post** `/v1/user_profiles/{id}/enrollment_url` + +Create Enrollment URL + +### Parameters + +- `id: String` + +- `betas: Array[AnthropicBeta]` + + Optional header to specify the beta version(s) you want to use. + + - `String` + + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` + + - `:"message-batches-2024-09-24"` + + - `:"prompt-caching-2024-07-31"` + + - `:"computer-use-2024-10-22"` + + - `:"computer-use-2025-01-24"` + + - `:"pdfs-2024-09-25"` + + - `:"token-counting-2024-11-01"` + + - `:"token-efficient-tools-2025-02-19"` + + - `:"output-128k-2025-02-19"` + + - `:"files-api-2025-04-14"` + + - `:"mcp-client-2025-04-04"` + + - `:"mcp-client-2025-11-20"` + + - `:"dev-full-thinking-2025-05-14"` + + - `:"interleaved-thinking-2025-05-14"` + + - `:"code-execution-2025-05-22"` + + - `:"extended-cache-ttl-2025-04-11"` + + - `:"context-1m-2025-08-07"` + + - `:"context-management-2025-06-27"` + + - `:"model-context-window-exceeded-2025-08-26"` + + - `:"skills-2025-10-02"` + + - `:"fast-mode-2026-02-01"` + + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + +### Returns + +- `class BetaUserProfileEnrollmentURL` + + - `expires_at: Time` + + A timestamp in RFC 3339 format + + - `type: String` + + - `url: String` + +### Example + +```ruby +require "anthropic" + +anthropic = Anthropic::Client.new(api_key: "my-anthropic-api-key") + +beta_user_profile_enrollment_url = anthropic.beta.user_profiles.create_enrollment_url("id") + +puts(beta_user_profile_enrollment_url) +``` + +## Domain Types + +### Beta User Profile + +- `class BetaUserProfile` + + - `id: String` + + - `created_at: Time` + + A timestamp in RFC 3339 format + + - `metadata: Hash[Symbol, String]` + + - `trust_grants: Hash[Symbol, BetaUserProfileTrustGrant]` + + - `status: String` + + - `type: String` + + - `updated_at: Time` + + A timestamp in RFC 3339 format + + - `external_id: String` + +### Beta User Profile Enrollment URL + +- `class BetaUserProfileEnrollmentURL` + + - `expires_at: Time` + + A timestamp in RFC 3339 format + + - `type: String` + + - `url: String` + +### Beta User Profile Trust Grant + +- `class BetaUserProfileTrustGrant` + + - `status: String` diff --git a/content/en/api/ruby/beta/files.md b/content/en/api/ruby/beta/files.md index 0257cff4a..8b751e627 100644 --- a/content/en/api/ruby/beta/files.md +++ b/content/en/api/ruby/beta/files.md @@ -20,7 +20,7 @@ Upload File - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -62,6 +62,10 @@ Upload File - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class FileMetadata` @@ -142,7 +146,7 @@ List Files - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -184,6 +188,10 @@ List Files - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class FileMetadata` @@ -254,7 +262,7 @@ Download File - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -296,6 +304,10 @@ Download File - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `StringIO` @@ -332,7 +344,7 @@ Get File Metadata - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -374,6 +386,10 @@ Get File Metadata - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class FileMetadata` @@ -444,7 +460,7 @@ Delete File - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -486,6 +502,10 @@ Delete File - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class DeletedFile` diff --git a/content/en/api/ruby/beta/files/delete.md b/content/en/api/ruby/beta/files/delete.md index 29c3eb339..281c0fbbf 100644 --- a/content/en/api/ruby/beta/files/delete.md +++ b/content/en/api/ruby/beta/files/delete.md @@ -18,7 +18,7 @@ Delete File - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -60,6 +60,10 @@ Delete File - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class DeletedFile` diff --git a/content/en/api/ruby/beta/files/download.md b/content/en/api/ruby/beta/files/download.md index 81998ea07..7efe80b36 100644 --- a/content/en/api/ruby/beta/files/download.md +++ b/content/en/api/ruby/beta/files/download.md @@ -18,7 +18,7 @@ Download File - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -60,6 +60,10 @@ Download File - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `StringIO` diff --git a/content/en/api/ruby/beta/files/list.md b/content/en/api/ruby/beta/files/list.md index daf64db64..2c9c8ba39 100644 --- a/content/en/api/ruby/beta/files/list.md +++ b/content/en/api/ruby/beta/files/list.md @@ -28,7 +28,7 @@ List Files - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -70,6 +70,10 @@ List Files - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class FileMetadata` diff --git a/content/en/api/ruby/beta/files/retrieve_metadata.md b/content/en/api/ruby/beta/files/retrieve_metadata.md index 06f47a4fc..618a26389 100644 --- a/content/en/api/ruby/beta/files/retrieve_metadata.md +++ b/content/en/api/ruby/beta/files/retrieve_metadata.md @@ -18,7 +18,7 @@ Get File Metadata - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -60,6 +60,10 @@ Get File Metadata - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class FileMetadata` diff --git a/content/en/api/ruby/beta/files/upload.md b/content/en/api/ruby/beta/files/upload.md index 4af310e0f..079d7bb4e 100644 --- a/content/en/api/ruby/beta/files/upload.md +++ b/content/en/api/ruby/beta/files/upload.md @@ -18,7 +18,7 @@ Upload File - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -60,6 +60,10 @@ Upload File - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class FileMetadata` diff --git a/content/en/api/ruby/beta/messages.md b/content/en/api/ruby/beta/messages.md index 60736554c..f3ce60fc3 100644 --- a/content/en/api/ruby/beta/messages.md +++ b/content/en/api/ruby/beta/messages.md @@ -4676,13 +4676,17 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en Recommended for advanced use cases only. You usually only need to use `temperature`. +- `user_profile_id: String` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + - `betas: Array[AnthropicBeta]` Optional header to specify the beta version(s) you want to use. - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -4724,6 +4728,10 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class BetaMessage` @@ -5723,6 +5731,30 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `:assistant` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -10522,7 +10554,7 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -10564,6 +10596,10 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageTokensCount` @@ -17856,6 +17892,30 @@ puts(beta_message_tokens_count) - `:assistant` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -21967,7 +22027,7 @@ puts(beta_message_tokens_count) - `:clear_thinking_20251015` - - `delta: { container, stop_reason, stop_sequence}` + - `delta: { container, stop_details, stop_reason, stop_sequence}` - `container: BetaContainer` @@ -22001,6 +22061,30 @@ puts(beta_message_tokens_count) Skill version or 'latest' for most recent version + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: BetaStopReason` - `:end_turn` @@ -23152,6 +23236,30 @@ puts(beta_message_tokens_count) - `:assistant` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -24372,6 +24480,30 @@ puts(beta_message_tokens_count) - `:assistant` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -24623,7 +24755,7 @@ puts(beta_message_tokens_count) - `:clear_thinking_20251015` - - `delta: { container, stop_reason, stop_sequence}` + - `delta: { container, stop_details, stop_reason, stop_sequence}` - `container: BetaContainer` @@ -24657,6 +24789,30 @@ puts(beta_message_tokens_count) Skill version or 'latest' for most recent version + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: BetaStopReason` - `:end_turn` @@ -25801,6 +25957,32 @@ puts(beta_message_tokens_count) - `:redacted_thinking` +### Beta Refusal Stop Details + +- `class BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + ### Beta Request Document Block - `class BetaRequestDocumentBlock` @@ -32771,7 +32953,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Must be unique for each request within the Message Batch. - - `params: { max_tokens, messages, model, 19 more}` + - `params: { max_tokens, messages, model, 20 more}` Messages API creation parameters for the individual request. @@ -37439,13 +37621,17 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Recommended for advanced use cases only. You usually only need to use `temperature`. + - `user_profile_id: String` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + - `betas: Array[AnthropicBeta]` Optional header to specify the beta version(s) you want to use. - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -37487,6 +37673,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatch` @@ -37618,7 +37808,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -37660,6 +37850,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatch` @@ -37794,7 +37988,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -37836,6 +38030,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatch` @@ -37962,7 +38160,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -38004,6 +38202,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatch` @@ -38130,7 +38332,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -38172,6 +38374,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class BetaDeletedMessageBatch` @@ -38224,7 +38430,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -38266,6 +38472,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatchIndividualResponse` @@ -39283,6 +39493,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `:assistant` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -40835,6 +41069,30 @@ puts(beta_message_batch_individual_response) - `:assistant` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -42183,6 +42441,30 @@ puts(beta_message_batch_individual_response) - `:assistant` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -43493,6 +43775,30 @@ puts(beta_message_batch_individual_response) - `:assistant` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: BetaStopReason` The reason that we stopped. diff --git a/content/en/api/ruby/beta/messages/batches.md b/content/en/api/ruby/beta/messages/batches.md index 629252fd2..278425dff 100644 --- a/content/en/api/ruby/beta/messages/batches.md +++ b/content/en/api/ruby/beta/messages/batches.md @@ -24,7 +24,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Must be unique for each request within the Message Batch. - - `params: { max_tokens, messages, model, 19 more}` + - `params: { max_tokens, messages, model, 20 more}` Messages API creation parameters for the individual request. @@ -4692,13 +4692,17 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Recommended for advanced use cases only. You usually only need to use `temperature`. + - `user_profile_id: String` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + - `betas: Array[AnthropicBeta]` Optional header to specify the beta version(s) you want to use. - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -4740,6 +4744,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatch` @@ -4871,7 +4879,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -4913,6 +4921,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatch` @@ -5047,7 +5059,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -5089,6 +5101,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatch` @@ -5215,7 +5231,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -5257,6 +5273,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatch` @@ -5383,7 +5403,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -5425,6 +5445,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class BetaDeletedMessageBatch` @@ -5477,7 +5501,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -5519,6 +5543,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatchIndividualResponse` @@ -6536,6 +6564,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `:assistant` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -8088,6 +8140,30 @@ puts(beta_message_batch_individual_response) - `:assistant` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -9436,6 +9512,30 @@ puts(beta_message_batch_individual_response) - `:assistant` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: BetaStopReason` The reason that we stopped. @@ -10746,6 +10846,30 @@ puts(beta_message_batch_individual_response) - `:assistant` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: BetaStopReason` The reason that we stopped. diff --git a/content/en/api/ruby/beta/messages/batches/cancel.md b/content/en/api/ruby/beta/messages/batches/cancel.md index 4764baa71..f85143e38 100644 --- a/content/en/api/ruby/beta/messages/batches/cancel.md +++ b/content/en/api/ruby/beta/messages/batches/cancel.md @@ -22,7 +22,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -64,6 +64,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatch` diff --git a/content/en/api/ruby/beta/messages/batches/create.md b/content/en/api/ruby/beta/messages/batches/create.md index 3e9b7f8a7..39afce823 100644 --- a/content/en/api/ruby/beta/messages/batches/create.md +++ b/content/en/api/ruby/beta/messages/batches/create.md @@ -22,7 +22,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Must be unique for each request within the Message Batch. - - `params: { max_tokens, messages, model, 19 more}` + - `params: { max_tokens, messages, model, 20 more}` Messages API creation parameters for the individual request. @@ -4690,13 +4690,17 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Recommended for advanced use cases only. You usually only need to use `temperature`. + - `user_profile_id: String` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + - `betas: Array[AnthropicBeta]` Optional header to specify the beta version(s) you want to use. - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -4738,6 +4742,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatch` diff --git a/content/en/api/ruby/beta/messages/batches/delete.md b/content/en/api/ruby/beta/messages/batches/delete.md index f1ef45ee9..29c339da1 100644 --- a/content/en/api/ruby/beta/messages/batches/delete.md +++ b/content/en/api/ruby/beta/messages/batches/delete.md @@ -22,7 +22,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -64,6 +64,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class BetaDeletedMessageBatch` diff --git a/content/en/api/ruby/beta/messages/batches/list.md b/content/en/api/ruby/beta/messages/batches/list.md index 41013fc95..0f82da250 100644 --- a/content/en/api/ruby/beta/messages/batches/list.md +++ b/content/en/api/ruby/beta/messages/batches/list.md @@ -30,7 +30,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -72,6 +72,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatch` diff --git a/content/en/api/ruby/beta/messages/batches/results.md b/content/en/api/ruby/beta/messages/batches/results.md index 472877f87..14181f5a3 100644 --- a/content/en/api/ruby/beta/messages/batches/results.md +++ b/content/en/api/ruby/beta/messages/batches/results.md @@ -22,7 +22,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -64,6 +64,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatchIndividualResponse` @@ -1081,6 +1085,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `:assistant` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: BetaStopReason` The reason that we stopped. diff --git a/content/en/api/ruby/beta/messages/batches/retrieve.md b/content/en/api/ruby/beta/messages/batches/retrieve.md index 941ee09dc..b0f006e5b 100644 --- a/content/en/api/ruby/beta/messages/batches/retrieve.md +++ b/content/en/api/ruby/beta/messages/batches/retrieve.md @@ -20,7 +20,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -62,6 +62,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageBatch` diff --git a/content/en/api/ruby/beta/messages/count_tokens.md b/content/en/api/ruby/beta/messages/count_tokens.md index 421414185..79a5e2068 100644 --- a/content/en/api/ruby/beta/messages/count_tokens.md +++ b/content/en/api/ruby/beta/messages/count_tokens.md @@ -4576,7 +4576,7 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -4618,6 +4618,10 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class BetaMessageTokensCount` diff --git a/content/en/api/ruby/beta/messages/create.md b/content/en/api/ruby/beta/messages/create.md index 605113109..67c9d0882 100644 --- a/content/en/api/ruby/beta/messages/create.md +++ b/content/en/api/ruby/beta/messages/create.md @@ -4674,13 +4674,17 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en Recommended for advanced use cases only. You usually only need to use `temperature`. +- `user_profile_id: String` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + - `betas: Array[AnthropicBeta]` Optional header to specify the beta version(s) you want to use. - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -4722,6 +4726,10 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class BetaMessage` @@ -5721,6 +5729,30 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `:assistant` + - `stop_details: BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: BetaStopReason` The reason that we stopped. diff --git a/content/en/api/ruby/beta/models.md b/content/en/api/ruby/beta/models.md index 5617e03b2..e2824d892 100644 --- a/content/en/api/ruby/beta/models.md +++ b/content/en/api/ruby/beta/models.md @@ -32,7 +32,7 @@ The Models API response can be used to determine which models are available for - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -74,6 +74,10 @@ The Models API response can be used to determine which models are available for - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class BetaModelInfo` @@ -292,7 +296,7 @@ The Models API response can be used to determine information about a specific mo - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -334,6 +338,10 @@ The Models API response can be used to determine information about a specific mo - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class BetaModelInfo` diff --git a/content/en/api/ruby/beta/models/list.md b/content/en/api/ruby/beta/models/list.md index 958d8fd44..d5900d3a3 100644 --- a/content/en/api/ruby/beta/models/list.md +++ b/content/en/api/ruby/beta/models/list.md @@ -30,7 +30,7 @@ The Models API response can be used to determine which models are available for - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -72,6 +72,10 @@ The Models API response can be used to determine which models are available for - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class BetaModelInfo` diff --git a/content/en/api/ruby/beta/models/retrieve.md b/content/en/api/ruby/beta/models/retrieve.md index 3be10c3e8..b088b1088 100644 --- a/content/en/api/ruby/beta/models/retrieve.md +++ b/content/en/api/ruby/beta/models/retrieve.md @@ -20,7 +20,7 @@ The Models API response can be used to determine information about a specific mo - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -62,6 +62,10 @@ The Models API response can be used to determine information about a specific mo - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class BetaModelInfo` diff --git a/content/en/api/ruby/beta/skills.md b/content/en/api/ruby/beta/skills.md index ca91c51de..8cd66573d 100644 --- a/content/en/api/ruby/beta/skills.md +++ b/content/en/api/ruby/beta/skills.md @@ -28,7 +28,7 @@ Create Skill - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -70,6 +70,10 @@ Create Skill - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class SkillCreateResponse` @@ -164,7 +168,7 @@ List Skills - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -206,6 +210,10 @@ List Skills - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class SkillListResponse` @@ -285,7 +293,7 @@ Get Skill - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -327,6 +335,10 @@ Get Skill - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class SkillRetrieveResponse` @@ -406,7 +418,7 @@ Delete Skill - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -448,6 +460,10 @@ Delete Skill - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class SkillDeleteResponse` @@ -476,6 +492,159 @@ skill = anthropic.beta.skills.delete("skill_id") puts(skill) ``` +## Domain Types + +### Skill Create Response + +- `class SkillCreateResponse` + + - `id: String` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + + - `created_at: String` + + ISO 8601 timestamp of when the skill was created. + + - `display_title: String` + + Display title for the skill. + + This is a human-readable label that is not included in the prompt sent to the model. + + - `latest_version: String` + + The latest version identifier for the skill. + + This represents the most recent version of the skill that has been created. + + - `source: String` + + Source of the skill. + + This may be one of the following values: + + * `"custom"`: the skill was created by a user + * `"anthropic"`: the skill was created by Anthropic + + - `type: String` + + Object type. + + For Skills, this is always `"skill"`. + + - `updated_at: String` + + ISO 8601 timestamp of when the skill was last updated. + +### Skill List Response + +- `class SkillListResponse` + + - `id: String` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + + - `created_at: String` + + ISO 8601 timestamp of when the skill was created. + + - `display_title: String` + + Display title for the skill. + + This is a human-readable label that is not included in the prompt sent to the model. + + - `latest_version: String` + + The latest version identifier for the skill. + + This represents the most recent version of the skill that has been created. + + - `source: String` + + Source of the skill. + + This may be one of the following values: + + * `"custom"`: the skill was created by a user + * `"anthropic"`: the skill was created by Anthropic + + - `type: String` + + Object type. + + For Skills, this is always `"skill"`. + + - `updated_at: String` + + ISO 8601 timestamp of when the skill was last updated. + +### Skill Retrieve Response + +- `class SkillRetrieveResponse` + + - `id: String` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + + - `created_at: String` + + ISO 8601 timestamp of when the skill was created. + + - `display_title: String` + + Display title for the skill. + + This is a human-readable label that is not included in the prompt sent to the model. + + - `latest_version: String` + + The latest version identifier for the skill. + + This represents the most recent version of the skill that has been created. + + - `source: String` + + Source of the skill. + + This may be one of the following values: + + * `"custom"`: the skill was created by a user + * `"anthropic"`: the skill was created by Anthropic + + - `type: String` + + Object type. + + For Skills, this is always `"skill"`. + + - `updated_at: String` + + ISO 8601 timestamp of when the skill was last updated. + +### Skill Delete Response + +- `class SkillDeleteResponse` + + - `id: String` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + + - `type: String` + + Deleted object type. + + For Skills, this is always `"skill_deleted"`. + # Versions ## Create @@ -506,7 +675,7 @@ Create Skill Version - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -548,6 +717,10 @@ Create Skill Version - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class VersionCreateResponse` @@ -640,7 +813,7 @@ List Skill Versions - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -682,6 +855,10 @@ List Skill Versions - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class VersionListResponse` @@ -770,7 +947,7 @@ Get Skill Version - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -812,6 +989,10 @@ Get Skill Version - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class VersionRetrieveResponse` @@ -900,7 +1081,7 @@ Delete Skill Version - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -942,6 +1123,10 @@ Delete Skill Version - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class VersionDeleteResponse` @@ -969,3 +1154,165 @@ version = anthropic.beta.skills.versions.delete("version", skill_id: "skill_id") puts(version) ``` + +## Domain Types + +### Version Create Response + +- `class VersionCreateResponse` + + - `id: String` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: String` + + ISO 8601 timestamp of when the skill version was created. + + - `description: String` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: String` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: String` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: String` + + Identifier for the skill that this version belongs to. + + - `type: String` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: String` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version List Response + +- `class VersionListResponse` + + - `id: String` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: String` + + ISO 8601 timestamp of when the skill version was created. + + - `description: String` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: String` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: String` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: String` + + Identifier for the skill that this version belongs to. + + - `type: String` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: String` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version Retrieve Response + +- `class VersionRetrieveResponse` + + - `id: String` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: String` + + ISO 8601 timestamp of when the skill version was created. + + - `description: String` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: String` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: String` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: String` + + Identifier for the skill that this version belongs to. + + - `type: String` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: String` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version Delete Response + +- `class VersionDeleteResponse` + + - `id: String` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + + - `type: String` + + Deleted object type. + + For Skill Versions, this is always `"skill_version_deleted"`. diff --git a/content/en/api/ruby/beta/skills/create.md b/content/en/api/ruby/beta/skills/create.md index 7b8fde66c..9faa93783 100644 --- a/content/en/api/ruby/beta/skills/create.md +++ b/content/en/api/ruby/beta/skills/create.md @@ -26,7 +26,7 @@ Create Skill - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -68,6 +68,10 @@ Create Skill - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class SkillCreateResponse` diff --git a/content/en/api/ruby/beta/skills/delete.md b/content/en/api/ruby/beta/skills/delete.md index cbca6504c..37a673fda 100644 --- a/content/en/api/ruby/beta/skills/delete.md +++ b/content/en/api/ruby/beta/skills/delete.md @@ -20,7 +20,7 @@ Delete Skill - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -62,6 +62,10 @@ Delete Skill - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class SkillDeleteResponse` diff --git a/content/en/api/ruby/beta/skills/list.md b/content/en/api/ruby/beta/skills/list.md index f06438f5e..bbf318c76 100644 --- a/content/en/api/ruby/beta/skills/list.md +++ b/content/en/api/ruby/beta/skills/list.md @@ -35,7 +35,7 @@ List Skills - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -77,6 +77,10 @@ List Skills - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class SkillListResponse` diff --git a/content/en/api/ruby/beta/skills/retrieve.md b/content/en/api/ruby/beta/skills/retrieve.md index 108daf821..23943eec5 100644 --- a/content/en/api/ruby/beta/skills/retrieve.md +++ b/content/en/api/ruby/beta/skills/retrieve.md @@ -20,7 +20,7 @@ Get Skill - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -62,6 +62,10 @@ Get Skill - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class SkillRetrieveResponse` diff --git a/content/en/api/ruby/beta/skills/versions.md b/content/en/api/ruby/beta/skills/versions.md index 809d3f562..cc02625b2 100644 --- a/content/en/api/ruby/beta/skills/versions.md +++ b/content/en/api/ruby/beta/skills/versions.md @@ -28,7 +28,7 @@ Create Skill Version - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -70,6 +70,10 @@ Create Skill Version - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class VersionCreateResponse` @@ -162,7 +166,7 @@ List Skill Versions - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -204,6 +208,10 @@ List Skill Versions - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class VersionListResponse` @@ -292,7 +300,7 @@ Get Skill Version - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -334,6 +342,10 @@ Get Skill Version - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class VersionRetrieveResponse` @@ -422,7 +434,7 @@ Delete Skill Version - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -464,6 +476,10 @@ Delete Skill Version - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class VersionDeleteResponse` @@ -491,3 +507,165 @@ version = anthropic.beta.skills.versions.delete("version", skill_id: "skill_id") puts(version) ``` + +## Domain Types + +### Version Create Response + +- `class VersionCreateResponse` + + - `id: String` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: String` + + ISO 8601 timestamp of when the skill version was created. + + - `description: String` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: String` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: String` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: String` + + Identifier for the skill that this version belongs to. + + - `type: String` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: String` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version List Response + +- `class VersionListResponse` + + - `id: String` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: String` + + ISO 8601 timestamp of when the skill version was created. + + - `description: String` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: String` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: String` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: String` + + Identifier for the skill that this version belongs to. + + - `type: String` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: String` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version Retrieve Response + +- `class VersionRetrieveResponse` + + - `id: String` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: String` + + ISO 8601 timestamp of when the skill version was created. + + - `description: String` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: String` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: String` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: String` + + Identifier for the skill that this version belongs to. + + - `type: String` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: String` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version Delete Response + +- `class VersionDeleteResponse` + + - `id: String` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + + - `type: String` + + Deleted object type. + + For Skill Versions, this is always `"skill_version_deleted"`. diff --git a/content/en/api/ruby/beta/skills/versions/create.md b/content/en/api/ruby/beta/skills/versions/create.md index bb8646026..0c72e169b 100644 --- a/content/en/api/ruby/beta/skills/versions/create.md +++ b/content/en/api/ruby/beta/skills/versions/create.md @@ -26,7 +26,7 @@ Create Skill Version - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -68,6 +68,10 @@ Create Skill Version - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class VersionCreateResponse` diff --git a/content/en/api/ruby/beta/skills/versions/delete.md b/content/en/api/ruby/beta/skills/versions/delete.md index 05fbd8ed3..543221a40 100644 --- a/content/en/api/ruby/beta/skills/versions/delete.md +++ b/content/en/api/ruby/beta/skills/versions/delete.md @@ -26,7 +26,7 @@ Delete Skill Version - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -68,6 +68,10 @@ Delete Skill Version - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class VersionDeleteResponse` diff --git a/content/en/api/ruby/beta/skills/versions/list.md b/content/en/api/ruby/beta/skills/versions/list.md index f498cc98b..da57543fa 100644 --- a/content/en/api/ruby/beta/skills/versions/list.md +++ b/content/en/api/ruby/beta/skills/versions/list.md @@ -30,7 +30,7 @@ List Skill Versions - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -72,6 +72,10 @@ List Skill Versions - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class VersionListResponse` diff --git a/content/en/api/ruby/beta/skills/versions/retrieve.md b/content/en/api/ruby/beta/skills/versions/retrieve.md index 67de5ce42..f978b5772 100644 --- a/content/en/api/ruby/beta/skills/versions/retrieve.md +++ b/content/en/api/ruby/beta/skills/versions/retrieve.md @@ -26,7 +26,7 @@ Get Skill Version - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -68,6 +68,10 @@ Get Skill Version - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class VersionRetrieveResponse` diff --git a/content/en/api/ruby/beta/user_profiles.md b/content/en/api/ruby/beta/user_profiles.md new file mode 100644 index 000000000..57380799f --- /dev/null +++ b/content/en/api/ruby/beta/user_profiles.md @@ -0,0 +1,557 @@ +# User Profiles + +## Create + +`beta.user_profiles.create(**kwargs) -> BetaUserProfile` + +**post** `/v1/user_profiles` + +Create User Profile + +### Parameters + +- `external_id: String` + +- `metadata: Hash[Symbol, String]` + + Free-form key-value data to attach to this user profile. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. Values must be non-empty strings. + +- `betas: Array[AnthropicBeta]` + + Optional header to specify the beta version(s) you want to use. + + - `String` + + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` + + - `:"message-batches-2024-09-24"` + + - `:"prompt-caching-2024-07-31"` + + - `:"computer-use-2024-10-22"` + + - `:"computer-use-2025-01-24"` + + - `:"pdfs-2024-09-25"` + + - `:"token-counting-2024-11-01"` + + - `:"token-efficient-tools-2025-02-19"` + + - `:"output-128k-2025-02-19"` + + - `:"files-api-2025-04-14"` + + - `:"mcp-client-2025-04-04"` + + - `:"mcp-client-2025-11-20"` + + - `:"dev-full-thinking-2025-05-14"` + + - `:"interleaved-thinking-2025-05-14"` + + - `:"code-execution-2025-05-22"` + + - `:"extended-cache-ttl-2025-04-11"` + + - `:"context-1m-2025-08-07"` + + - `:"context-management-2025-06-27"` + + - `:"model-context-window-exceeded-2025-08-26"` + + - `:"skills-2025-10-02"` + + - `:"fast-mode-2026-02-01"` + + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + +### Returns + +- `class BetaUserProfile` + + - `id: String` + + - `created_at: Time` + + A timestamp in RFC 3339 format + + - `metadata: Hash[Symbol, String]` + + - `trust_grants: Hash[Symbol, BetaUserProfileTrustGrant]` + + - `status: String` + + - `type: String` + + - `updated_at: Time` + + A timestamp in RFC 3339 format + + - `external_id: String` + +### Example + +```ruby +require "anthropic" + +anthropic = Anthropic::Client.new(api_key: "my-anthropic-api-key") + +beta_user_profile = anthropic.beta.user_profiles.create + +puts(beta_user_profile) +``` + +## List + +`beta.user_profiles.list(**kwargs) -> PageCursorV2` + +**get** `/v1/user_profiles` + +List User Profiles + +### Parameters + +- `limit: Integer` + + Query parameter for limit + +- `order: :asc | :desc` + + Query parameter for order + + - `:asc` + + - `:desc` + +- `page: String` + + Query parameter for page + +- `betas: Array[AnthropicBeta]` + + Optional header to specify the beta version(s) you want to use. + + - `String` + + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` + + - `:"message-batches-2024-09-24"` + + - `:"prompt-caching-2024-07-31"` + + - `:"computer-use-2024-10-22"` + + - `:"computer-use-2025-01-24"` + + - `:"pdfs-2024-09-25"` + + - `:"token-counting-2024-11-01"` + + - `:"token-efficient-tools-2025-02-19"` + + - `:"output-128k-2025-02-19"` + + - `:"files-api-2025-04-14"` + + - `:"mcp-client-2025-04-04"` + + - `:"mcp-client-2025-11-20"` + + - `:"dev-full-thinking-2025-05-14"` + + - `:"interleaved-thinking-2025-05-14"` + + - `:"code-execution-2025-05-22"` + + - `:"extended-cache-ttl-2025-04-11"` + + - `:"context-1m-2025-08-07"` + + - `:"context-management-2025-06-27"` + + - `:"model-context-window-exceeded-2025-08-26"` + + - `:"skills-2025-10-02"` + + - `:"fast-mode-2026-02-01"` + + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + +### Returns + +- `class BetaUserProfile` + + - `id: String` + + - `created_at: Time` + + A timestamp in RFC 3339 format + + - `metadata: Hash[Symbol, String]` + + - `trust_grants: Hash[Symbol, BetaUserProfileTrustGrant]` + + - `status: String` + + - `type: String` + + - `updated_at: Time` + + A timestamp in RFC 3339 format + + - `external_id: String` + +### Example + +```ruby +require "anthropic" + +anthropic = Anthropic::Client.new(api_key: "my-anthropic-api-key") + +page = anthropic.beta.user_profiles.list + +puts(page) +``` + +## Retrieve + +`beta.user_profiles.retrieve(id, **kwargs) -> BetaUserProfile` + +**get** `/v1/user_profiles/{id}` + +Get User Profile + +### Parameters + +- `id: String` + +- `betas: Array[AnthropicBeta]` + + Optional header to specify the beta version(s) you want to use. + + - `String` + + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` + + - `:"message-batches-2024-09-24"` + + - `:"prompt-caching-2024-07-31"` + + - `:"computer-use-2024-10-22"` + + - `:"computer-use-2025-01-24"` + + - `:"pdfs-2024-09-25"` + + - `:"token-counting-2024-11-01"` + + - `:"token-efficient-tools-2025-02-19"` + + - `:"output-128k-2025-02-19"` + + - `:"files-api-2025-04-14"` + + - `:"mcp-client-2025-04-04"` + + - `:"mcp-client-2025-11-20"` + + - `:"dev-full-thinking-2025-05-14"` + + - `:"interleaved-thinking-2025-05-14"` + + - `:"code-execution-2025-05-22"` + + - `:"extended-cache-ttl-2025-04-11"` + + - `:"context-1m-2025-08-07"` + + - `:"context-management-2025-06-27"` + + - `:"model-context-window-exceeded-2025-08-26"` + + - `:"skills-2025-10-02"` + + - `:"fast-mode-2026-02-01"` + + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + +### Returns + +- `class BetaUserProfile` + + - `id: String` + + - `created_at: Time` + + A timestamp in RFC 3339 format + + - `metadata: Hash[Symbol, String]` + + - `trust_grants: Hash[Symbol, BetaUserProfileTrustGrant]` + + - `status: String` + + - `type: String` + + - `updated_at: Time` + + A timestamp in RFC 3339 format + + - `external_id: String` + +### Example + +```ruby +require "anthropic" + +anthropic = Anthropic::Client.new(api_key: "my-anthropic-api-key") + +beta_user_profile = anthropic.beta.user_profiles.retrieve("id") + +puts(beta_user_profile) +``` + +## Update + +`beta.user_profiles.update(id, **kwargs) -> BetaUserProfile` + +**post** `/v1/user_profiles/{id}` + +Update User Profile + +### Parameters + +- `id: String` + +- `external_id: String` + +- `metadata: Hash[Symbol, String]` + + Key-value pairs to merge into the stored metadata. Keys provided overwrite existing values. To remove a key, set its value to an empty string. Keys not provided are left unchanged. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. + +- `betas: Array[AnthropicBeta]` + + Optional header to specify the beta version(s) you want to use. + + - `String` + + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` + + - `:"message-batches-2024-09-24"` + + - `:"prompt-caching-2024-07-31"` + + - `:"computer-use-2024-10-22"` + + - `:"computer-use-2025-01-24"` + + - `:"pdfs-2024-09-25"` + + - `:"token-counting-2024-11-01"` + + - `:"token-efficient-tools-2025-02-19"` + + - `:"output-128k-2025-02-19"` + + - `:"files-api-2025-04-14"` + + - `:"mcp-client-2025-04-04"` + + - `:"mcp-client-2025-11-20"` + + - `:"dev-full-thinking-2025-05-14"` + + - `:"interleaved-thinking-2025-05-14"` + + - `:"code-execution-2025-05-22"` + + - `:"extended-cache-ttl-2025-04-11"` + + - `:"context-1m-2025-08-07"` + + - `:"context-management-2025-06-27"` + + - `:"model-context-window-exceeded-2025-08-26"` + + - `:"skills-2025-10-02"` + + - `:"fast-mode-2026-02-01"` + + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + +### Returns + +- `class BetaUserProfile` + + - `id: String` + + - `created_at: Time` + + A timestamp in RFC 3339 format + + - `metadata: Hash[Symbol, String]` + + - `trust_grants: Hash[Symbol, BetaUserProfileTrustGrant]` + + - `status: String` + + - `type: String` + + - `updated_at: Time` + + A timestamp in RFC 3339 format + + - `external_id: String` + +### Example + +```ruby +require "anthropic" + +anthropic = Anthropic::Client.new(api_key: "my-anthropic-api-key") + +beta_user_profile = anthropic.beta.user_profiles.update("id") + +puts(beta_user_profile) +``` + +## Create Enrollment URL + +`beta.user_profiles.create_enrollment_url(id, **kwargs) -> BetaUserProfileEnrollmentURL` + +**post** `/v1/user_profiles/{id}/enrollment_url` + +Create Enrollment URL + +### Parameters + +- `id: String` + +- `betas: Array[AnthropicBeta]` + + Optional header to specify the beta version(s) you want to use. + + - `String` + + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` + + - `:"message-batches-2024-09-24"` + + - `:"prompt-caching-2024-07-31"` + + - `:"computer-use-2024-10-22"` + + - `:"computer-use-2025-01-24"` + + - `:"pdfs-2024-09-25"` + + - `:"token-counting-2024-11-01"` + + - `:"token-efficient-tools-2025-02-19"` + + - `:"output-128k-2025-02-19"` + + - `:"files-api-2025-04-14"` + + - `:"mcp-client-2025-04-04"` + + - `:"mcp-client-2025-11-20"` + + - `:"dev-full-thinking-2025-05-14"` + + - `:"interleaved-thinking-2025-05-14"` + + - `:"code-execution-2025-05-22"` + + - `:"extended-cache-ttl-2025-04-11"` + + - `:"context-1m-2025-08-07"` + + - `:"context-management-2025-06-27"` + + - `:"model-context-window-exceeded-2025-08-26"` + + - `:"skills-2025-10-02"` + + - `:"fast-mode-2026-02-01"` + + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + +### Returns + +- `class BetaUserProfileEnrollmentURL` + + - `expires_at: Time` + + A timestamp in RFC 3339 format + + - `type: String` + + - `url: String` + +### Example + +```ruby +require "anthropic" + +anthropic = Anthropic::Client.new(api_key: "my-anthropic-api-key") + +beta_user_profile_enrollment_url = anthropic.beta.user_profiles.create_enrollment_url("id") + +puts(beta_user_profile_enrollment_url) +``` + +## Domain Types + +### Beta User Profile + +- `class BetaUserProfile` + + - `id: String` + + - `created_at: Time` + + A timestamp in RFC 3339 format + + - `metadata: Hash[Symbol, String]` + + - `trust_grants: Hash[Symbol, BetaUserProfileTrustGrant]` + + - `status: String` + + - `type: String` + + - `updated_at: Time` + + A timestamp in RFC 3339 format + + - `external_id: String` + +### Beta User Profile Enrollment URL + +- `class BetaUserProfileEnrollmentURL` + + - `expires_at: Time` + + A timestamp in RFC 3339 format + + - `type: String` + + - `url: String` + +### Beta User Profile Trust Grant + +- `class BetaUserProfileTrustGrant` + + - `status: String` diff --git a/content/en/api/ruby/beta/user_profiles/create.md b/content/en/api/ruby/beta/user_profiles/create.md new file mode 100644 index 000000000..d6221360f --- /dev/null +++ b/content/en/api/ruby/beta/user_profiles/create.md @@ -0,0 +1,103 @@ +## Create + +`beta.user_profiles.create(**kwargs) -> BetaUserProfile` + +**post** `/v1/user_profiles` + +Create User Profile + +### Parameters + +- `external_id: String` + +- `metadata: Hash[Symbol, String]` + + Free-form key-value data to attach to this user profile. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. Values must be non-empty strings. + +- `betas: Array[AnthropicBeta]` + + Optional header to specify the beta version(s) you want to use. + + - `String` + + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` + + - `:"message-batches-2024-09-24"` + + - `:"prompt-caching-2024-07-31"` + + - `:"computer-use-2024-10-22"` + + - `:"computer-use-2025-01-24"` + + - `:"pdfs-2024-09-25"` + + - `:"token-counting-2024-11-01"` + + - `:"token-efficient-tools-2025-02-19"` + + - `:"output-128k-2025-02-19"` + + - `:"files-api-2025-04-14"` + + - `:"mcp-client-2025-04-04"` + + - `:"mcp-client-2025-11-20"` + + - `:"dev-full-thinking-2025-05-14"` + + - `:"interleaved-thinking-2025-05-14"` + + - `:"code-execution-2025-05-22"` + + - `:"extended-cache-ttl-2025-04-11"` + + - `:"context-1m-2025-08-07"` + + - `:"context-management-2025-06-27"` + + - `:"model-context-window-exceeded-2025-08-26"` + + - `:"skills-2025-10-02"` + + - `:"fast-mode-2026-02-01"` + + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + +### Returns + +- `class BetaUserProfile` + + - `id: String` + + - `created_at: Time` + + A timestamp in RFC 3339 format + + - `metadata: Hash[Symbol, String]` + + - `trust_grants: Hash[Symbol, BetaUserProfileTrustGrant]` + + - `status: String` + + - `type: String` + + - `updated_at: Time` + + A timestamp in RFC 3339 format + + - `external_id: String` + +### Example + +```ruby +require "anthropic" + +anthropic = Anthropic::Client.new(api_key: "my-anthropic-api-key") + +beta_user_profile = anthropic.beta.user_profiles.create + +puts(beta_user_profile) +``` diff --git a/content/en/api/ruby/beta/user_profiles/create_enrollment_url.md b/content/en/api/ruby/beta/user_profiles/create_enrollment_url.md new file mode 100644 index 000000000..28b2cc1f7 --- /dev/null +++ b/content/en/api/ruby/beta/user_profiles/create_enrollment_url.md @@ -0,0 +1,87 @@ +## Create Enrollment URL + +`beta.user_profiles.create_enrollment_url(id, **kwargs) -> BetaUserProfileEnrollmentURL` + +**post** `/v1/user_profiles/{id}/enrollment_url` + +Create Enrollment URL + +### Parameters + +- `id: String` + +- `betas: Array[AnthropicBeta]` + + Optional header to specify the beta version(s) you want to use. + + - `String` + + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` + + - `:"message-batches-2024-09-24"` + + - `:"prompt-caching-2024-07-31"` + + - `:"computer-use-2024-10-22"` + + - `:"computer-use-2025-01-24"` + + - `:"pdfs-2024-09-25"` + + - `:"token-counting-2024-11-01"` + + - `:"token-efficient-tools-2025-02-19"` + + - `:"output-128k-2025-02-19"` + + - `:"files-api-2025-04-14"` + + - `:"mcp-client-2025-04-04"` + + - `:"mcp-client-2025-11-20"` + + - `:"dev-full-thinking-2025-05-14"` + + - `:"interleaved-thinking-2025-05-14"` + + - `:"code-execution-2025-05-22"` + + - `:"extended-cache-ttl-2025-04-11"` + + - `:"context-1m-2025-08-07"` + + - `:"context-management-2025-06-27"` + + - `:"model-context-window-exceeded-2025-08-26"` + + - `:"skills-2025-10-02"` + + - `:"fast-mode-2026-02-01"` + + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + +### Returns + +- `class BetaUserProfileEnrollmentURL` + + - `expires_at: Time` + + A timestamp in RFC 3339 format + + - `type: String` + + - `url: String` + +### Example + +```ruby +require "anthropic" + +anthropic = Anthropic::Client.new(api_key: "my-anthropic-api-key") + +beta_user_profile_enrollment_url = anthropic.beta.user_profiles.create_enrollment_url("id") + +puts(beta_user_profile_enrollment_url) +``` diff --git a/content/en/api/ruby/beta/user_profiles/list.md b/content/en/api/ruby/beta/user_profiles/list.md new file mode 100644 index 000000000..e649bb03f --- /dev/null +++ b/content/en/api/ruby/beta/user_profiles/list.md @@ -0,0 +1,113 @@ +## List + +`beta.user_profiles.list(**kwargs) -> PageCursorV2` + +**get** `/v1/user_profiles` + +List User Profiles + +### Parameters + +- `limit: Integer` + + Query parameter for limit + +- `order: :asc | :desc` + + Query parameter for order + + - `:asc` + + - `:desc` + +- `page: String` + + Query parameter for page + +- `betas: Array[AnthropicBeta]` + + Optional header to specify the beta version(s) you want to use. + + - `String` + + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` + + - `:"message-batches-2024-09-24"` + + - `:"prompt-caching-2024-07-31"` + + - `:"computer-use-2024-10-22"` + + - `:"computer-use-2025-01-24"` + + - `:"pdfs-2024-09-25"` + + - `:"token-counting-2024-11-01"` + + - `:"token-efficient-tools-2025-02-19"` + + - `:"output-128k-2025-02-19"` + + - `:"files-api-2025-04-14"` + + - `:"mcp-client-2025-04-04"` + + - `:"mcp-client-2025-11-20"` + + - `:"dev-full-thinking-2025-05-14"` + + - `:"interleaved-thinking-2025-05-14"` + + - `:"code-execution-2025-05-22"` + + - `:"extended-cache-ttl-2025-04-11"` + + - `:"context-1m-2025-08-07"` + + - `:"context-management-2025-06-27"` + + - `:"model-context-window-exceeded-2025-08-26"` + + - `:"skills-2025-10-02"` + + - `:"fast-mode-2026-02-01"` + + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + +### Returns + +- `class BetaUserProfile` + + - `id: String` + + - `created_at: Time` + + A timestamp in RFC 3339 format + + - `metadata: Hash[Symbol, String]` + + - `trust_grants: Hash[Symbol, BetaUserProfileTrustGrant]` + + - `status: String` + + - `type: String` + + - `updated_at: Time` + + A timestamp in RFC 3339 format + + - `external_id: String` + +### Example + +```ruby +require "anthropic" + +anthropic = Anthropic::Client.new(api_key: "my-anthropic-api-key") + +page = anthropic.beta.user_profiles.list + +puts(page) +``` diff --git a/content/en/api/ruby/beta/user_profiles/retrieve.md b/content/en/api/ruby/beta/user_profiles/retrieve.md new file mode 100644 index 000000000..61c9cf5a0 --- /dev/null +++ b/content/en/api/ruby/beta/user_profiles/retrieve.md @@ -0,0 +1,99 @@ +## Retrieve + +`beta.user_profiles.retrieve(id, **kwargs) -> BetaUserProfile` + +**get** `/v1/user_profiles/{id}` + +Get User Profile + +### Parameters + +- `id: String` + +- `betas: Array[AnthropicBeta]` + + Optional header to specify the beta version(s) you want to use. + + - `String` + + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` + + - `:"message-batches-2024-09-24"` + + - `:"prompt-caching-2024-07-31"` + + - `:"computer-use-2024-10-22"` + + - `:"computer-use-2025-01-24"` + + - `:"pdfs-2024-09-25"` + + - `:"token-counting-2024-11-01"` + + - `:"token-efficient-tools-2025-02-19"` + + - `:"output-128k-2025-02-19"` + + - `:"files-api-2025-04-14"` + + - `:"mcp-client-2025-04-04"` + + - `:"mcp-client-2025-11-20"` + + - `:"dev-full-thinking-2025-05-14"` + + - `:"interleaved-thinking-2025-05-14"` + + - `:"code-execution-2025-05-22"` + + - `:"extended-cache-ttl-2025-04-11"` + + - `:"context-1m-2025-08-07"` + + - `:"context-management-2025-06-27"` + + - `:"model-context-window-exceeded-2025-08-26"` + + - `:"skills-2025-10-02"` + + - `:"fast-mode-2026-02-01"` + + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + +### Returns + +- `class BetaUserProfile` + + - `id: String` + + - `created_at: Time` + + A timestamp in RFC 3339 format + + - `metadata: Hash[Symbol, String]` + + - `trust_grants: Hash[Symbol, BetaUserProfileTrustGrant]` + + - `status: String` + + - `type: String` + + - `updated_at: Time` + + A timestamp in RFC 3339 format + + - `external_id: String` + +### Example + +```ruby +require "anthropic" + +anthropic = Anthropic::Client.new(api_key: "my-anthropic-api-key") + +beta_user_profile = anthropic.beta.user_profiles.retrieve("id") + +puts(beta_user_profile) +``` diff --git a/content/en/api/ruby/beta/user_profiles/update.md b/content/en/api/ruby/beta/user_profiles/update.md new file mode 100644 index 000000000..74b5e124c --- /dev/null +++ b/content/en/api/ruby/beta/user_profiles/update.md @@ -0,0 +1,105 @@ +## Update + +`beta.user_profiles.update(id, **kwargs) -> BetaUserProfile` + +**post** `/v1/user_profiles/{id}` + +Update User Profile + +### Parameters + +- `id: String` + +- `external_id: String` + +- `metadata: Hash[Symbol, String]` + + Key-value pairs to merge into the stored metadata. Keys provided overwrite existing values. To remove a key, set its value to an empty string. Keys not provided are left unchanged. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. + +- `betas: Array[AnthropicBeta]` + + Optional header to specify the beta version(s) you want to use. + + - `String` + + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` + + - `:"message-batches-2024-09-24"` + + - `:"prompt-caching-2024-07-31"` + + - `:"computer-use-2024-10-22"` + + - `:"computer-use-2025-01-24"` + + - `:"pdfs-2024-09-25"` + + - `:"token-counting-2024-11-01"` + + - `:"token-efficient-tools-2025-02-19"` + + - `:"output-128k-2025-02-19"` + + - `:"files-api-2025-04-14"` + + - `:"mcp-client-2025-04-04"` + + - `:"mcp-client-2025-11-20"` + + - `:"dev-full-thinking-2025-05-14"` + + - `:"interleaved-thinking-2025-05-14"` + + - `:"code-execution-2025-05-22"` + + - `:"extended-cache-ttl-2025-04-11"` + + - `:"context-1m-2025-08-07"` + + - `:"context-management-2025-06-27"` + + - `:"model-context-window-exceeded-2025-08-26"` + + - `:"skills-2025-10-02"` + + - `:"fast-mode-2026-02-01"` + + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + +### Returns + +- `class BetaUserProfile` + + - `id: String` + + - `created_at: Time` + + A timestamp in RFC 3339 format + + - `metadata: Hash[Symbol, String]` + + - `trust_grants: Hash[Symbol, BetaUserProfileTrustGrant]` + + - `status: String` + + - `type: String` + + - `updated_at: Time` + + A timestamp in RFC 3339 format + + - `external_id: String` + +### Example + +```ruby +require "anthropic" + +anthropic = Anthropic::Client.new(api_key: "my-anthropic-api-key") + +beta_user_profile = anthropic.beta.user_profiles.update("id") + +puts(beta_user_profile) +``` diff --git a/content/en/api/ruby/completions.md b/content/en/api/ruby/completions.md index 20b7894eb..197e463e1 100644 --- a/content/en/api/ruby/completions.md +++ b/content/en/api/ruby/completions.md @@ -168,7 +168,7 @@ Future models and features will not be compatible with Text Completions. See our - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -210,6 +210,10 @@ Future models and features will not be compatible with Text Completions. See our - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class Completion` diff --git a/content/en/api/ruby/completions/create.md b/content/en/api/ruby/completions/create.md index ca7d6590f..4a10a6330 100644 --- a/content/en/api/ruby/completions/create.md +++ b/content/en/api/ruby/completions/create.md @@ -166,7 +166,7 @@ Future models and features will not be compatible with Text Completions. See our - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -208,6 +208,10 @@ Future models and features will not be compatible with Text Completions. See our - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class Completion` diff --git a/content/en/api/ruby/messages.md b/content/en/api/ruby/messages.md index 1c49bb745..7d78be1b9 100644 --- a/content/en/api/ruby/messages.md +++ b/content/en/api/ruby/messages.md @@ -4608,6 +4608,30 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `:assistant` + - `stop_details: RefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: StopReason` The reason that we stopped. @@ -14262,6 +14286,30 @@ puts(message_tokens_count) - `:assistant` + - `stop_details: RefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: StopReason` The reason that we stopped. @@ -18761,7 +18809,7 @@ puts(message_tokens_count) - `class RawMessageDeltaEvent` - - `delta: { container, stop_reason, stop_sequence}` + - `delta: { container, stop_details, stop_reason, stop_sequence}` - `container: Container` @@ -18775,6 +18823,30 @@ puts(message_tokens_count) The time at which the container will expire. + - `stop_details: RefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: StopReason` - `:end_turn` @@ -19626,6 +19698,30 @@ puts(message_tokens_count) - `:assistant` + - `stop_details: RefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: StopReason` The reason that we stopped. @@ -20538,6 +20634,30 @@ puts(message_tokens_count) - `:assistant` + - `stop_details: RefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: StopReason` The reason that we stopped. @@ -20651,7 +20771,7 @@ puts(message_tokens_count) - `class RawMessageDeltaEvent` - - `delta: { container, stop_reason, stop_sequence}` + - `delta: { container, stop_details, stop_reason, stop_sequence}` - `container: Container` @@ -20665,6 +20785,30 @@ puts(message_tokens_count) The time at which the container will expire. + - `stop_details: RefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: StopReason` - `:end_turn` @@ -21563,6 +21707,32 @@ puts(message_tokens_count) - `:redacted_thinking` +### Refusal Stop Details + +- `class RefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + ### Search Result Block Param - `class SearchResultBlockParam` @@ -32343,6 +32513,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `:assistant` + - `stop_details: RefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: StopReason` The reason that we stopped. @@ -33587,6 +33781,30 @@ puts(message_batch_individual_response) - `:assistant` + - `stop_details: RefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: StopReason` The reason that we stopped. @@ -34627,6 +34845,30 @@ puts(message_batch_individual_response) - `:assistant` + - `stop_details: RefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: StopReason` The reason that we stopped. @@ -35629,6 +35871,30 @@ puts(message_batch_individual_response) - `:assistant` + - `stop_details: RefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: StopReason` The reason that we stopped. diff --git a/content/en/api/ruby/messages/batches.md b/content/en/api/ruby/messages/batches.md index 78a968aed..ef0287ef3 100644 --- a/content/en/api/ruby/messages/batches.md +++ b/content/en/api/ruby/messages/batches.md @@ -5181,6 +5181,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `:assistant` + - `stop_details: RefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: StopReason` The reason that we stopped. @@ -6425,6 +6449,30 @@ puts(message_batch_individual_response) - `:assistant` + - `stop_details: RefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: StopReason` The reason that we stopped. @@ -7465,6 +7513,30 @@ puts(message_batch_individual_response) - `:assistant` + - `stop_details: RefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: StopReason` The reason that we stopped. @@ -8467,6 +8539,30 @@ puts(message_batch_individual_response) - `:assistant` + - `stop_details: RefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: StopReason` The reason that we stopped. diff --git a/content/en/api/ruby/messages/batches/results.md b/content/en/api/ruby/messages/batches/results.md index bd274df61..0b673d040 100644 --- a/content/en/api/ruby/messages/batches/results.md +++ b/content/en/api/ruby/messages/batches/results.md @@ -823,6 +823,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `:assistant` + - `stop_details: RefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: StopReason` The reason that we stopped. diff --git a/content/en/api/ruby/messages/create.md b/content/en/api/ruby/messages/create.md index 48f3905b7..4ac905929 100644 --- a/content/en/api/ruby/messages/create.md +++ b/content/en/api/ruby/messages/create.md @@ -4606,6 +4606,30 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `:assistant` + - `stop_details: RefusalStopDetails` + + Structured information about a refusal. + + - `category: :cyber | :bio` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `:cyber` + + - `:bio` + + - `explanation: String` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: :refusal` + + - `:refusal` + - `stop_reason: StopReason` The reason that we stopped. diff --git a/content/en/api/ruby/models.md b/content/en/api/ruby/models.md index eb4e5fbdf..cce4b7d15 100644 --- a/content/en/api/ruby/models.md +++ b/content/en/api/ruby/models.md @@ -32,7 +32,7 @@ The Models API response can be used to determine which models are available for - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -74,6 +74,10 @@ The Models API response can be used to determine which models are available for - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class ModelInfo` @@ -292,7 +296,7 @@ The Models API response can be used to determine information about a specific mo - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -334,6 +338,10 @@ The Models API response can be used to determine information about a specific mo - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class ModelInfo` diff --git a/content/en/api/ruby/models/list.md b/content/en/api/ruby/models/list.md index 9ca5d8066..e8562a007 100644 --- a/content/en/api/ruby/models/list.md +++ b/content/en/api/ruby/models/list.md @@ -30,7 +30,7 @@ The Models API response can be used to determine which models are available for - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -72,6 +72,10 @@ The Models API response can be used to determine which models are available for - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class ModelInfo` diff --git a/content/en/api/ruby/models/retrieve.md b/content/en/api/ruby/models/retrieve.md index 9c04f56b5..f0ed7a6cf 100644 --- a/content/en/api/ruby/models/retrieve.md +++ b/content/en/api/ruby/models/retrieve.md @@ -20,7 +20,7 @@ The Models API response can be used to determine information about a specific mo - `String` - - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 17 more` + - `:"message-batches-2024-09-24" | :"prompt-caching-2024-07-31" | :"computer-use-2024-10-22" | 19 more` - `:"message-batches-2024-09-24"` @@ -62,6 +62,10 @@ The Models API response can be used to determine information about a specific mo - `:"fast-mode-2026-02-01"` + - `:"output-300k-2026-03-24"` + + - `:"user-profiles-2026-03-24"` + ### Returns - `class ModelInfo` diff --git a/content/en/api/service-tiers.md b/content/en/api/service-tiers.md index 01c3f4e8a..5b145059e 100644 --- a/content/en/api/service-tiers.md +++ b/content/en/api/service-tiers.md @@ -112,18 +112,7 @@ The ratio of input to output tokens you purchase matters. Sizing your Priority T ### Supported models -Priority Tier is supported by: - -- Claude Opus 4.6 -- Claude Opus 4.5 -- Claude Opus 4.1 -- Claude Opus 4 -- Claude Sonnet 4.6 -- Claude Sonnet 4.5 -- Claude Sonnet 4 -- Claude Sonnet 3.7 ([deprecated](/docs/en/about-claude/model-deprecations)) -- Claude Haiku 4.5 -- Claude Haiku 3.5 ([deprecated](/docs/en/about-claude/model-deprecations)) +Priority Tier is supported on all available Claude models except [Claude Mythos Preview](https://anthropic.com/glasswing). Check the [model overview page](/docs/en/about-claude/models/overview) for more details on available models. diff --git a/content/en/api/terraform/beta.md b/content/en/api/terraform/beta.md index 2d8051c7e..dc93e3831 100644 --- a/content/en/api/terraform/beta.md +++ b/content/en/api/terraform/beta.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                    \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                      \ No newline at end of file diff --git a/content/en/api/terraform/beta/files.md b/content/en/api/terraform/beta/files.md index 0f5c847c8..6f670025d 100644 --- a/content/en/api/terraform/beta/files.md +++ b/content/en/api/terraform/beta/files.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                        \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                          \ No newline at end of file diff --git a/content/en/api/terraform/beta/files/delete.md b/content/en/api/terraform/beta/files/delete.md index 070e79507..828a357cf 100644 --- a/content/en/api/terraform/beta/files/delete.md +++ b/content/en/api/terraform/beta/files/delete.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                            \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                              \ No newline at end of file diff --git a/content/en/api/terraform/beta/files/download.md b/content/en/api/terraform/beta/files/download.md index 8635e49bc..9f88e1acb 100644 --- a/content/en/api/terraform/beta/files/download.md +++ b/content/en/api/terraform/beta/files/download.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                  \ No newline at end of file diff --git a/content/en/api/terraform/beta/files/list.md b/content/en/api/terraform/beta/files/list.md index cbcfd9db4..c821b45eb 100644 --- a/content/en/api/terraform/beta/files/list.md +++ b/content/en/api/terraform/beta/files/list.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                    \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                      \ No newline at end of file diff --git a/content/en/api/terraform/beta/files/retrieve_metadata.md b/content/en/api/terraform/beta/files/retrieve_metadata.md index 90cabc1ac..57fe64f4c 100644 --- a/content/en/api/terraform/beta/files/retrieve_metadata.md +++ b/content/en/api/terraform/beta/files/retrieve_metadata.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                        \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                          \ No newline at end of file diff --git a/content/en/api/terraform/beta/files/upload.md b/content/en/api/terraform/beta/files/upload.md index b08eda882..d9c28f0f0 100644 --- a/content/en/api/terraform/beta/files/upload.md +++ b/content/en/api/terraform/beta/files/upload.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                            \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                              \ No newline at end of file diff --git a/content/en/api/terraform/beta/messages.md b/content/en/api/terraform/beta/messages.md index b7d9fed0c..6902e46bd 100644 --- a/content/en/api/terraform/beta/messages.md +++ b/content/en/api/terraform/beta/messages.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                  \ No newline at end of file diff --git a/content/en/api/terraform/beta/messages/batches.md b/content/en/api/terraform/beta/messages/batches.md index 2a77c8514..ad657b4da 100644 --- a/content/en/api/terraform/beta/messages/batches.md +++ b/content/en/api/terraform/beta/messages/batches.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                    \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                      \ No newline at end of file diff --git a/content/en/api/terraform/beta/messages/batches/cancel.md b/content/en/api/terraform/beta/messages/batches/cancel.md index 1eaaa3470..2ad9c1872 100644 --- a/content/en/api/terraform/beta/messages/batches/cancel.md +++ b/content/en/api/terraform/beta/messages/batches/cancel.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                        \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                          \ No newline at end of file diff --git a/content/en/api/terraform/beta/messages/batches/create.md b/content/en/api/terraform/beta/messages/batches/create.md index e835f6db8..1286fdd98 100644 --- a/content/en/api/terraform/beta/messages/batches/create.md +++ b/content/en/api/terraform/beta/messages/batches/create.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                            \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                              \ No newline at end of file diff --git a/content/en/api/terraform/beta/messages/batches/delete.md b/content/en/api/terraform/beta/messages/batches/delete.md index d6931d9e5..2a95a4297 100644 --- a/content/en/api/terraform/beta/messages/batches/delete.md +++ b/content/en/api/terraform/beta/messages/batches/delete.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                  \ No newline at end of file diff --git a/content/en/api/terraform/beta/messages/batches/list.md b/content/en/api/terraform/beta/messages/batches/list.md index 0b7afa84a..3b3895a2b 100644 --- a/content/en/api/terraform/beta/messages/batches/list.md +++ b/content/en/api/terraform/beta/messages/batches/list.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                    \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                      \ No newline at end of file diff --git a/content/en/api/terraform/beta/messages/batches/results.md b/content/en/api/terraform/beta/messages/batches/results.md index 06f6ff611..e8174026f 100644 --- a/content/en/api/terraform/beta/messages/batches/results.md +++ b/content/en/api/terraform/beta/messages/batches/results.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                        \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                          \ No newline at end of file diff --git a/content/en/api/terraform/beta/messages/batches/retrieve.md b/content/en/api/terraform/beta/messages/batches/retrieve.md index d9b11fffb..9dd920090 100644 --- a/content/en/api/terraform/beta/messages/batches/retrieve.md +++ b/content/en/api/terraform/beta/messages/batches/retrieve.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                            \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                              \ No newline at end of file diff --git a/content/en/api/terraform/beta/messages/count_tokens.md b/content/en/api/terraform/beta/messages/count_tokens.md index 789052ea2..bafa06e21 100644 --- a/content/en/api/terraform/beta/messages/count_tokens.md +++ b/content/en/api/terraform/beta/messages/count_tokens.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                  \ No newline at end of file diff --git a/content/en/api/terraform/beta/messages/create.md b/content/en/api/terraform/beta/messages/create.md index 263ea26ce..e385e4aaf 100644 --- a/content/en/api/terraform/beta/messages/create.md +++ b/content/en/api/terraform/beta/messages/create.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                    \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                      \ No newline at end of file diff --git a/content/en/api/terraform/beta/models.md b/content/en/api/terraform/beta/models.md index 27170d998..48a083e9e 100644 --- a/content/en/api/terraform/beta/models.md +++ b/content/en/api/terraform/beta/models.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                        \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                          \ No newline at end of file diff --git a/content/en/api/terraform/beta/models/list.md b/content/en/api/terraform/beta/models/list.md index b30902f43..526e53467 100644 --- a/content/en/api/terraform/beta/models/list.md +++ b/content/en/api/terraform/beta/models/list.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                            \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                              \ No newline at end of file diff --git a/content/en/api/terraform/beta/models/retrieve.md b/content/en/api/terraform/beta/models/retrieve.md index edad680d6..0ae2c7a88 100644 --- a/content/en/api/terraform/beta/models/retrieve.md +++ b/content/en/api/terraform/beta/models/retrieve.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  \ No newline at end of file diff --git a/content/en/api/terraform/beta/skills.md b/content/en/api/terraform/beta/skills.md index c4c06cbe5..18d83ef6a 100644 --- a/content/en/api/terraform/beta/skills.md +++ b/content/en/api/terraform/beta/skills.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      \ No newline at end of file diff --git a/content/en/api/terraform/beta/skills/create.md b/content/en/api/terraform/beta/skills/create.md index d2d815c8d..3bbd6e565 100644 --- a/content/en/api/terraform/beta/skills/create.md +++ b/content/en/api/terraform/beta/skills/create.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          \ No newline at end of file diff --git a/content/en/api/terraform/beta/skills/delete.md b/content/en/api/terraform/beta/skills/delete.md index 7cb1e7a12..633194019 100644 --- a/content/en/api/terraform/beta/skills/delete.md +++ b/content/en/api/terraform/beta/skills/delete.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              \ No newline at end of file diff --git a/content/en/api/terraform/beta/skills/list.md b/content/en/api/terraform/beta/skills/list.md index cc5668c7a..07f0c50e5 100644 --- a/content/en/api/terraform/beta/skills/list.md +++ b/content/en/api/terraform/beta/skills/list.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  \ No newline at end of file diff --git a/content/en/api/terraform/beta/skills/retrieve.md b/content/en/api/terraform/beta/skills/retrieve.md index e8d9442f0..18e0a5770 100644 --- a/content/en/api/terraform/beta/skills/retrieve.md +++ b/content/en/api/terraform/beta/skills/retrieve.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      \ No newline at end of file diff --git a/content/en/api/terraform/beta/skills/versions.md b/content/en/api/terraform/beta/skills/versions.md index 90c2a05f0..62555094f 100644 --- a/content/en/api/terraform/beta/skills/versions.md +++ b/content/en/api/terraform/beta/skills/versions.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          \ No newline at end of file diff --git a/content/en/api/terraform/beta/skills/versions/create.md b/content/en/api/terraform/beta/skills/versions/create.md index fb2ccbb00..731164857 100644 --- a/content/en/api/terraform/beta/skills/versions/create.md +++ b/content/en/api/terraform/beta/skills/versions/create.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              \ No newline at end of file diff --git a/content/en/api/terraform/beta/skills/versions/delete.md b/content/en/api/terraform/beta/skills/versions/delete.md index 4b10d826e..bbab78072 100644 --- a/content/en/api/terraform/beta/skills/versions/delete.md +++ b/content/en/api/terraform/beta/skills/versions/delete.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  \ No newline at end of file diff --git a/content/en/api/terraform/beta/skills/versions/list.md b/content/en/api/terraform/beta/skills/versions/list.md index 3c27d0c46..1d81a3ec7 100644 --- a/content/en/api/terraform/beta/skills/versions/list.md +++ b/content/en/api/terraform/beta/skills/versions/list.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      \ No newline at end of file diff --git a/content/en/api/terraform/beta/skills/versions/retrieve.md b/content/en/api/terraform/beta/skills/versions/retrieve.md index b5f1bcaa1..09d2bc8c0 100644 --- a/content/en/api/terraform/beta/skills/versions/retrieve.md +++ b/content/en/api/terraform/beta/skills/versions/retrieve.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          \ No newline at end of file diff --git a/content/en/api/terraform/beta/user_profiles.md b/content/en/api/terraform/beta/user_profiles.md new file mode 100644 index 000000000..146669195 --- /dev/null +++ b/content/en/api/terraform/beta/user_profiles.md @@ -0,0 +1 @@ +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            \ No newline at end of file diff --git a/content/en/api/terraform/beta/user_profiles/create.md b/content/en/api/terraform/beta/user_profiles/create.md new file mode 100644 index 000000000..4affd6217 --- /dev/null +++ b/content/en/api/terraform/beta/user_profiles/create.md @@ -0,0 +1 @@ +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              \ No newline at end of file diff --git a/content/en/api/terraform/beta/user_profiles/create_enrollment_url.md b/content/en/api/terraform/beta/user_profiles/create_enrollment_url.md new file mode 100644 index 000000000..07e699403 --- /dev/null +++ b/content/en/api/terraform/beta/user_profiles/create_enrollment_url.md @@ -0,0 +1 @@ +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                \ No newline at end of file diff --git a/content/en/api/terraform/beta/user_profiles/list.md b/content/en/api/terraform/beta/user_profiles/list.md new file mode 100644 index 000000000..9f6696c8b --- /dev/null +++ b/content/en/api/terraform/beta/user_profiles/list.md @@ -0,0 +1 @@ +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  \ No newline at end of file diff --git a/content/en/api/terraform/beta/user_profiles/retrieve.md b/content/en/api/terraform/beta/user_profiles/retrieve.md new file mode 100644 index 000000000..ea3a3afda --- /dev/null +++ b/content/en/api/terraform/beta/user_profiles/retrieve.md @@ -0,0 +1 @@ +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    \ No newline at end of file diff --git a/content/en/api/terraform/beta/user_profiles/update.md b/content/en/api/terraform/beta/user_profiles/update.md new file mode 100644 index 000000000..62c77ace8 --- /dev/null +++ b/content/en/api/terraform/beta/user_profiles/update.md @@ -0,0 +1 @@ +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      \ No newline at end of file diff --git a/content/en/api/terraform/completions.md b/content/en/api/terraform/completions.md index 49d962dde..6f06c6359 100644 --- a/content/en/api/terraform/completions.md +++ b/content/en/api/terraform/completions.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          \ No newline at end of file diff --git a/content/en/api/terraform/completions/create.md b/content/en/api/terraform/completions/create.md index f2d482820..078ba5ada 100644 --- a/content/en/api/terraform/completions/create.md +++ b/content/en/api/terraform/completions/create.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              \ No newline at end of file diff --git a/content/en/api/terraform/messages.md b/content/en/api/terraform/messages.md index e9e619c94..ecd84a91f 100644 --- a/content/en/api/terraform/messages.md +++ b/content/en/api/terraform/messages.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  \ No newline at end of file diff --git a/content/en/api/terraform/messages/batches.md b/content/en/api/terraform/messages/batches.md index ffeb327f5..42e147bc3 100644 --- a/content/en/api/terraform/messages/batches.md +++ b/content/en/api/terraform/messages/batches.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      \ No newline at end of file diff --git a/content/en/api/terraform/messages/batches/cancel.md b/content/en/api/terraform/messages/batches/cancel.md index 3fba9e9f2..7ccb7491d 100644 --- a/content/en/api/terraform/messages/batches/cancel.md +++ b/content/en/api/terraform/messages/batches/cancel.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          \ No newline at end of file diff --git a/content/en/api/terraform/messages/batches/create.md b/content/en/api/terraform/messages/batches/create.md index 5dac311b4..3ee6e46c1 100644 --- a/content/en/api/terraform/messages/batches/create.md +++ b/content/en/api/terraform/messages/batches/create.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              \ No newline at end of file diff --git a/content/en/api/terraform/messages/batches/delete.md b/content/en/api/terraform/messages/batches/delete.md index 4e6f665ca..0043cad98 100644 --- a/content/en/api/terraform/messages/batches/delete.md +++ b/content/en/api/terraform/messages/batches/delete.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  \ No newline at end of file diff --git a/content/en/api/terraform/messages/batches/list.md b/content/en/api/terraform/messages/batches/list.md index 9e9a71928..541f3ce93 100644 --- a/content/en/api/terraform/messages/batches/list.md +++ b/content/en/api/terraform/messages/batches/list.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      \ No newline at end of file diff --git a/content/en/api/terraform/messages/batches/results.md b/content/en/api/terraform/messages/batches/results.md index 3ad3f9cd1..2d4e934d7 100644 --- a/content/en/api/terraform/messages/batches/results.md +++ b/content/en/api/terraform/messages/batches/results.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          \ No newline at end of file diff --git a/content/en/api/terraform/messages/batches/retrieve.md b/content/en/api/terraform/messages/batches/retrieve.md index bd2df194b..f519fef79 100644 --- a/content/en/api/terraform/messages/batches/retrieve.md +++ b/content/en/api/terraform/messages/batches/retrieve.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              \ No newline at end of file diff --git a/content/en/api/terraform/messages/count_tokens.md b/content/en/api/terraform/messages/count_tokens.md index 0cba4562f..a8d4d39f7 100644 --- a/content/en/api/terraform/messages/count_tokens.md +++ b/content/en/api/terraform/messages/count_tokens.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  \ No newline at end of file diff --git a/content/en/api/terraform/messages/create.md b/content/en/api/terraform/messages/create.md index 626882f64..19ca14a24 100644 --- a/content/en/api/terraform/messages/create.md +++ b/content/en/api/terraform/messages/create.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      \ No newline at end of file diff --git a/content/en/api/terraform/models.md b/content/en/api/terraform/models.md index fba630e7d..0bbc3c8fb 100644 --- a/content/en/api/terraform/models.md +++ b/content/en/api/terraform/models.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          \ No newline at end of file diff --git a/content/en/api/terraform/models/list.md b/content/en/api/terraform/models/list.md index 2fe83c8b4..b9dc440e0 100644 --- a/content/en/api/terraform/models/list.md +++ b/content/en/api/terraform/models/list.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              \ No newline at end of file diff --git a/content/en/api/terraform/models/retrieve.md b/content/en/api/terraform/models/retrieve.md index 2437d2f92..e5f17d910 100644 --- a/content/en/api/terraform/models/retrieve.md +++ b/content/en/api/terraform/models/retrieve.md @@ -1 +1 @@ -Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                \ No newline at end of file +Not Found - Claude API Docs
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  \ No newline at end of file diff --git a/content/en/api/typescript/beta.md b/content/en/api/typescript/beta.md index 748b9e530..ee45d768f 100644 --- a/content/en/api/typescript/beta.md +++ b/content/en/api/typescript/beta.md @@ -4,11 +4,11 @@ ### Anthropic Beta -- `AnthropicBeta = (string & {}) | "message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` +- `AnthropicBeta = (string & {}) | "message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -50,6 +50,10 @@ - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Beta API Error - `BetaAPIError` @@ -336,7 +340,7 @@ The Models API response can be used to determine which models are available for - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -378,6 +382,10 @@ The Models API response can be used to determine which models are available for - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaModelInfo` @@ -601,7 +609,7 @@ The Models API response can be used to determine information about a specific mo - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -643,6 +651,10 @@ The Models API response can be used to determine information about a specific mo - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaModelInfo` @@ -5999,13 +6011,17 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en Recommended for advanced use cases only. You usually only need to use `temperature`. + - `user_profile_id?: string | null` + + Body param: The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + - `betas?: Array` Header param: Optional header to specify the beta version(s) you want to use. - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -6047,6 +6063,10 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + - `MessageCreateParamsNonStreaming extends MessageCreateParamsBase` - `stream?: false` @@ -7062,6 +7082,30 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `"assistant"` + - `stop_details: BetaRefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason | null` The reason that we stopped. @@ -11861,7 +11905,7 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -11903,6 +11947,10 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaMessageTokensCount` @@ -19193,6 +19241,30 @@ console.log(betaMessageTokensCount.context_management); - `"assistant"` + - `stop_details: BetaRefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason | null` The reason that we stopped. @@ -23338,6 +23410,30 @@ console.log(betaMessageTokensCount.context_management); Skill version or 'latest' for most recent version + - `stop_details: BetaRefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason | null` - `"end_turn"` @@ -24485,6 +24581,30 @@ console.log(betaMessageTokensCount.context_management); - `"assistant"` + - `stop_details: BetaRefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason | null` The reason that we stopped. @@ -25701,6 +25821,30 @@ console.log(betaMessageTokensCount.context_management); - `"assistant"` + - `stop_details: BetaRefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason | null` The reason that we stopped. @@ -25986,6 +26130,30 @@ console.log(betaMessageTokensCount.context_management); Skill version or 'latest' for most recent version + - `stop_details: BetaRefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason | null` - `"end_turn"` @@ -27130,6 +27298,32 @@ console.log(betaMessageTokensCount.context_management); - `"redacted_thinking"` +### Beta Refusal Stop Details + +- `BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + ### Beta Request Document Block - `BetaRequestDocumentBlock` @@ -38766,13 +38960,17 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Recommended for advanced use cases only. You usually only need to use `temperature`. + - `user_profile_id?: string | null` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + - `betas?: Array` Header param: Optional header to specify the beta version(s) you want to use. - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -38814,6 +39012,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaMessageBatch` @@ -38953,7 +39155,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -38995,6 +39197,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaMessageBatch` @@ -39133,7 +39339,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -39175,178 +39381,186 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` -### Returns - -- `BetaMessageBatch` - - - `id: string` - - Unique object identifier. - - The format and length of IDs may change over time. - - - `archived_at: string | null` - - RFC 3339 datetime string representing the time at which the Message Batch was archived and its results became unavailable. - - - `cancel_initiated_at: string | null` - - RFC 3339 datetime string representing the time at which cancellation was initiated for the Message Batch. Specified only if cancellation was initiated. - - - `created_at: string` - - RFC 3339 datetime string representing the time at which the Message Batch was created. - - - `ended_at: string | null` - - RFC 3339 datetime string representing the time at which processing for the Message Batch ended. Specified only once processing ends. - - Processing ends when every request in a Message Batch has either succeeded, errored, canceled, or expired. - - - `expires_at: string` - - RFC 3339 datetime string representing the time at which the Message Batch will expire and end processing, which is 24 hours after creation. - - - `processing_status: "in_progress" | "canceling" | "ended"` - - Processing status of the Message Batch. - - - `"in_progress"` - - - `"canceling"` - - - `"ended"` - - - `request_counts: BetaMessageBatchRequestCounts` - - Tallies requests within the Message Batch, categorized by their status. - - Requests start as `processing` and move to one of the other statuses only once processing of the entire batch ends. The sum of all values always matches the total number of requests in the batch. - - - `canceled: number` - - Number of requests in the Message Batch that have been canceled. - - This is zero until processing of the entire Message Batch has ended. - - - `errored: number` - - Number of requests in the Message Batch that encountered an error. - - This is zero until processing of the entire Message Batch has ended. - - - `expired: number` - - Number of requests in the Message Batch that have expired. - - This is zero until processing of the entire Message Batch has ended. - - - `processing: number` - - Number of requests in the Message Batch that are processing. - - - `succeeded: number` - - Number of requests in the Message Batch that have completed successfully. - - This is zero until processing of the entire Message Batch has ended. - - - `results_url: string | null` - - URL to a `.jsonl` file containing the results of the Message Batch requests. Specified only once processing ends. - - Results in the file are not guaranteed to be in the same order as requests. Use the `custom_id` field to match results to requests. - - - `type: "message_batch"` - - Object type. - - For Message Batches, this is always `"message_batch"`. - - - `"message_batch"` - -### Example - -```typescript -import Anthropic from '@anthropic-ai/sdk'; - -const client = new Anthropic({ - apiKey: process.env['ANTHROPIC_API_KEY'], // This is the default and can be omitted -}); - -// Automatically fetches more pages as needed. -for await (const betaMessageBatch of client.beta.messages.batches.list()) { - console.log(betaMessageBatch.id); -} -``` - -## Cancel - -`client.beta.messages.batches.cancel(stringmessageBatchID, BatchCancelParamsparams?, RequestOptionsoptions?): BetaMessageBatch` - -**post** `/v1/messages/batches/{message_batch_id}/cancel` - -Batches may be canceled any time before processing ends. Once cancellation is initiated, the batch enters a `canceling` state, at which time the system may complete any in-progress, non-interruptible requests before finalizing cancellation. - -The number of canceled requests is specified in `request_counts`. To determine which requests were canceled, check the individual results within the batch. Note that cancellation may not result in any canceled requests if they were non-interruptible. - -Learn more about the Message Batches API in our [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing) - -### Parameters - -- `messageBatchID: string` - - ID of the Message Batch. - -- `params: BatchCancelParams` - - - `betas?: Array` - - Optional header to specify the beta version(s) you want to use. - - - `(string & {})` - - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` - - - `"message-batches-2024-09-24"` - - - `"prompt-caching-2024-07-31"` + - `"output-300k-2026-03-24"` - - `"computer-use-2024-10-22"` - - - `"computer-use-2025-01-24"` - - - `"pdfs-2024-09-25"` - - - `"token-counting-2024-11-01"` - - - `"token-efficient-tools-2025-02-19"` - - - `"output-128k-2025-02-19"` - - - `"files-api-2025-04-14"` - - - `"mcp-client-2025-04-04"` - - - `"mcp-client-2025-11-20"` - - - `"dev-full-thinking-2025-05-14"` - - - `"interleaved-thinking-2025-05-14"` - - - `"code-execution-2025-05-22"` - - - `"extended-cache-ttl-2025-04-11"` - - - `"context-1m-2025-08-07"` - - - `"context-management-2025-06-27"` - - - `"model-context-window-exceeded-2025-08-26"` - - - `"skills-2025-10-02"` - - - `"fast-mode-2026-02-01"` + - `"user-profiles-2026-03-24"` + +### Returns + +- `BetaMessageBatch` + + - `id: string` + + Unique object identifier. + + The format and length of IDs may change over time. + + - `archived_at: string | null` + + RFC 3339 datetime string representing the time at which the Message Batch was archived and its results became unavailable. + + - `cancel_initiated_at: string | null` + + RFC 3339 datetime string representing the time at which cancellation was initiated for the Message Batch. Specified only if cancellation was initiated. + + - `created_at: string` + + RFC 3339 datetime string representing the time at which the Message Batch was created. + + - `ended_at: string | null` + + RFC 3339 datetime string representing the time at which processing for the Message Batch ended. Specified only once processing ends. + + Processing ends when every request in a Message Batch has either succeeded, errored, canceled, or expired. + + - `expires_at: string` + + RFC 3339 datetime string representing the time at which the Message Batch will expire and end processing, which is 24 hours after creation. + + - `processing_status: "in_progress" | "canceling" | "ended"` + + Processing status of the Message Batch. + + - `"in_progress"` + + - `"canceling"` + + - `"ended"` + + - `request_counts: BetaMessageBatchRequestCounts` + + Tallies requests within the Message Batch, categorized by their status. + + Requests start as `processing` and move to one of the other statuses only once processing of the entire batch ends. The sum of all values always matches the total number of requests in the batch. + + - `canceled: number` + + Number of requests in the Message Batch that have been canceled. + + This is zero until processing of the entire Message Batch has ended. + + - `errored: number` + + Number of requests in the Message Batch that encountered an error. + + This is zero until processing of the entire Message Batch has ended. + + - `expired: number` + + Number of requests in the Message Batch that have expired. + + This is zero until processing of the entire Message Batch has ended. + + - `processing: number` + + Number of requests in the Message Batch that are processing. + + - `succeeded: number` + + Number of requests in the Message Batch that have completed successfully. + + This is zero until processing of the entire Message Batch has ended. + + - `results_url: string | null` + + URL to a `.jsonl` file containing the results of the Message Batch requests. Specified only once processing ends. + + Results in the file are not guaranteed to be in the same order as requests. Use the `custom_id` field to match results to requests. + + - `type: "message_batch"` + + Object type. + + For Message Batches, this is always `"message_batch"`. + + - `"message_batch"` + +### Example + +```typescript +import Anthropic from '@anthropic-ai/sdk'; + +const client = new Anthropic({ + apiKey: process.env['ANTHROPIC_API_KEY'], // This is the default and can be omitted +}); + +// Automatically fetches more pages as needed. +for await (const betaMessageBatch of client.beta.messages.batches.list()) { + console.log(betaMessageBatch.id); +} +``` + +## Cancel + +`client.beta.messages.batches.cancel(stringmessageBatchID, BatchCancelParamsparams?, RequestOptionsoptions?): BetaMessageBatch` + +**post** `/v1/messages/batches/{message_batch_id}/cancel` + +Batches may be canceled any time before processing ends. Once cancellation is initiated, the batch enters a `canceling` state, at which time the system may complete any in-progress, non-interruptible requests before finalizing cancellation. + +The number of canceled requests is specified in `request_counts`. To determine which requests were canceled, check the individual results within the batch. Note that cancellation may not result in any canceled requests if they were non-interruptible. + +Learn more about the Message Batches API in our [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing) + +### Parameters + +- `messageBatchID: string` + + ID of the Message Batch. + +- `params: BatchCancelParams` + + - `betas?: Array` + + Optional header to specify the beta version(s) you want to use. + + - `(string & {})` + + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` ### Returns @@ -39478,7 +39692,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -39520,6 +39734,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaDeletedMessageBatch` @@ -39576,7 +39794,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -39618,6 +39836,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaMessageBatchIndividualResponse` @@ -40631,6 +40853,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"assistant"` + - `stop_details: BetaRefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason | null` The reason that we stopped. @@ -42183,6 +42429,30 @@ console.log(betaMessageBatchIndividualResponse.custom_id); - `"assistant"` + - `stop_details: BetaRefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason | null` The reason that we stopped. @@ -43527,6 +43797,30 @@ console.log(betaMessageBatchIndividualResponse.custom_id); - `"assistant"` + - `stop_details: BetaRefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason | null` The reason that we stopped. @@ -44833,6 +45127,30 @@ console.log(betaMessageBatchIndividualResponse.custom_id); - `"assistant"` + - `stop_details: BetaRefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason | null` The reason that we stopped. @@ -45066,7 +45384,7 @@ Upload File - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -45108,131 +45426,139 @@ Upload File - `"fast-mode-2026-02-01"` -### Returns - -- `FileMetadata` - - - `id: string` - - Unique object identifier. - - The format and length of IDs may change over time. - - - `created_at: string` - - RFC 3339 datetime string representing when the file was created. - - - `filename: string` - - Original filename of the uploaded file. - - - `mime_type: string` - - MIME type of the file. - - - `size_bytes: number` - - Size of the file in bytes. + - `"output-300k-2026-03-24"` - - `type: "file"` - - Object type. - - For files, this is always `"file"`. - - - `"file"` - - - `downloadable?: boolean` - - Whether the file can be downloaded. - -### Example - -```typescript -import Anthropic from '@anthropic-ai/sdk'; - -const client = new Anthropic({ - apiKey: process.env['ANTHROPIC_API_KEY'], // This is the default and can be omitted -}); - -const fileMetadata = await client.beta.files.upload({ file: fs.createReadStream('path/to/file') }); - -console.log(fileMetadata.id); -``` - -## List - -`client.beta.files.list(FileListParamsparams?, RequestOptionsoptions?): Page` - -**get** `/v1/files` - -List Files - -### Parameters - -- `params: FileListParams` - - - `after_id?: string` - - Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object. - - - `before_id?: string` - - Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object. - - - `limit?: number` - - Query param: Number of items to return per page. - - Defaults to `20`. Ranges from `1` to `1000`. - - - `betas?: Array` - - Header param: Optional header to specify the beta version(s) you want to use. - - - `(string & {})` - - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` - - - `"message-batches-2024-09-24"` - - - `"prompt-caching-2024-07-31"` - - - `"computer-use-2024-10-22"` - - - `"computer-use-2025-01-24"` - - - `"pdfs-2024-09-25"` - - - `"token-counting-2024-11-01"` - - - `"token-efficient-tools-2025-02-19"` - - - `"output-128k-2025-02-19"` - - - `"files-api-2025-04-14"` - - - `"mcp-client-2025-04-04"` - - - `"mcp-client-2025-11-20"` - - - `"dev-full-thinking-2025-05-14"` - - - `"interleaved-thinking-2025-05-14"` - - - `"code-execution-2025-05-22"` - - - `"extended-cache-ttl-2025-04-11"` - - - `"context-1m-2025-08-07"` - - - `"context-management-2025-06-27"` - - - `"model-context-window-exceeded-2025-08-26"` - - - `"skills-2025-10-02"` - - - `"fast-mode-2026-02-01"` + - `"user-profiles-2026-03-24"` + +### Returns + +- `FileMetadata` + + - `id: string` + + Unique object identifier. + + The format and length of IDs may change over time. + + - `created_at: string` + + RFC 3339 datetime string representing when the file was created. + + - `filename: string` + + Original filename of the uploaded file. + + - `mime_type: string` + + MIME type of the file. + + - `size_bytes: number` + + Size of the file in bytes. + + - `type: "file"` + + Object type. + + For files, this is always `"file"`. + + - `"file"` + + - `downloadable?: boolean` + + Whether the file can be downloaded. + +### Example + +```typescript +import Anthropic from '@anthropic-ai/sdk'; + +const client = new Anthropic({ + apiKey: process.env['ANTHROPIC_API_KEY'], // This is the default and can be omitted +}); + +const fileMetadata = await client.beta.files.upload({ file: fs.createReadStream('path/to/file') }); + +console.log(fileMetadata.id); +``` + +## List + +`client.beta.files.list(FileListParamsparams?, RequestOptionsoptions?): Page` + +**get** `/v1/files` + +List Files + +### Parameters + +- `params: FileListParams` + + - `after_id?: string` + + Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object. + + - `before_id?: string` + + Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object. + + - `limit?: number` + + Query param: Number of items to return per page. + + Defaults to `20`. Ranges from `1` to `1000`. + + - `betas?: Array` + + Header param: Optional header to specify the beta version(s) you want to use. + + - `(string & {})` + + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` ### Returns @@ -45309,7 +45635,7 @@ Download File - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -45351,6 +45677,10 @@ Download File - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `unnamed_schema_1 = Response` @@ -45394,7 +45724,7 @@ Get File Metadata - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -45436,6 +45766,10 @@ Get File Metadata - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `FileMetadata` @@ -45510,7 +45844,7 @@ Delete File - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -45552,6 +45886,10 @@ Delete File - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `DeletedFile` @@ -45670,7 +46008,7 @@ Create Skill - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -45712,6 +46050,10 @@ Create Skill - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `SkillCreateResponse` @@ -45810,7 +46152,7 @@ List Skills - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -45852,135 +46194,143 @@ List Skills - `"fast-mode-2026-02-01"` -### Returns - -- `SkillListResponse` - - - `id: string` - - Unique identifier for the skill. - - The format and length of IDs may change over time. - - - `created_at: string` - - ISO 8601 timestamp of when the skill was created. - - - `display_title: string | null` - - Display title for the skill. - - This is a human-readable label that is not included in the prompt sent to the model. - - - `latest_version: string | null` - - The latest version identifier for the skill. - - This represents the most recent version of the skill that has been created. - - - `source: string` - - Source of the skill. - - This may be one of the following values: - - * `"custom"`: the skill was created by a user - * `"anthropic"`: the skill was created by Anthropic - - - `type: string` - - Object type. - - For Skills, this is always `"skill"`. - - - `updated_at: string` - - ISO 8601 timestamp of when the skill was last updated. - -### Example - -```typescript -import Anthropic from '@anthropic-ai/sdk'; - -const client = new Anthropic({ - apiKey: process.env['ANTHROPIC_API_KEY'], // This is the default and can be omitted -}); - -// Automatically fetches more pages as needed. -for await (const skillListResponse of client.beta.skills.list()) { - console.log(skillListResponse.id); -} -``` - -## Retrieve - -`client.beta.skills.retrieve(stringskillID, SkillRetrieveParamsparams?, RequestOptionsoptions?): SkillRetrieveResponse` - -**get** `/v1/skills/{skill_id}` - -Get Skill - -### Parameters - -- `skillID: string` - - Unique identifier for the skill. - - The format and length of IDs may change over time. - -- `params: SkillRetrieveParams` + - `"output-300k-2026-03-24"` - - `betas?: Array` - - Optional header to specify the beta version(s) you want to use. - - - `(string & {})` - - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` - - - `"message-batches-2024-09-24"` - - - `"prompt-caching-2024-07-31"` - - - `"computer-use-2024-10-22"` - - - `"computer-use-2025-01-24"` - - - `"pdfs-2024-09-25"` - - - `"token-counting-2024-11-01"` - - - `"token-efficient-tools-2025-02-19"` - - - `"output-128k-2025-02-19"` - - - `"files-api-2025-04-14"` - - - `"mcp-client-2025-04-04"` - - - `"mcp-client-2025-11-20"` - - - `"dev-full-thinking-2025-05-14"` - - - `"interleaved-thinking-2025-05-14"` - - - `"code-execution-2025-05-22"` - - - `"extended-cache-ttl-2025-04-11"` - - - `"context-1m-2025-08-07"` - - - `"context-management-2025-06-27"` - - - `"model-context-window-exceeded-2025-08-26"` - - - `"skills-2025-10-02"` - - - `"fast-mode-2026-02-01"` + - `"user-profiles-2026-03-24"` ### Returns -- `SkillRetrieveResponse` +- `SkillListResponse` + + - `id: string` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + + - `created_at: string` + + ISO 8601 timestamp of when the skill was created. + + - `display_title: string | null` + + Display title for the skill. + + This is a human-readable label that is not included in the prompt sent to the model. + + - `latest_version: string | null` + + The latest version identifier for the skill. + + This represents the most recent version of the skill that has been created. + + - `source: string` + + Source of the skill. + + This may be one of the following values: + + * `"custom"`: the skill was created by a user + * `"anthropic"`: the skill was created by Anthropic + + - `type: string` + + Object type. + + For Skills, this is always `"skill"`. + + - `updated_at: string` + + ISO 8601 timestamp of when the skill was last updated. + +### Example + +```typescript +import Anthropic from '@anthropic-ai/sdk'; + +const client = new Anthropic({ + apiKey: process.env['ANTHROPIC_API_KEY'], // This is the default and can be omitted +}); + +// Automatically fetches more pages as needed. +for await (const skillListResponse of client.beta.skills.list()) { + console.log(skillListResponse.id); +} +``` + +## Retrieve + +`client.beta.skills.retrieve(stringskillID, SkillRetrieveParamsparams?, RequestOptionsoptions?): SkillRetrieveResponse` + +**get** `/v1/skills/{skill_id}` + +Get Skill + +### Parameters + +- `skillID: string` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + +- `params: SkillRetrieveParams` + + - `betas?: Array` + + Optional header to specify the beta version(s) you want to use. + + - `(string & {})` + + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `SkillRetrieveResponse` - `id: string` @@ -46061,7 +46411,7 @@ Delete Skill - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -46103,6 +46453,10 @@ Delete Skill - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `SkillDeleteResponse` @@ -46133,6 +46487,159 @@ const skill = await client.beta.skills.delete('skill_id'); console.log(skill.id); ``` +## Domain Types + +### Skill Create Response + +- `SkillCreateResponse` + + - `id: string` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + + - `created_at: string` + + ISO 8601 timestamp of when the skill was created. + + - `display_title: string | null` + + Display title for the skill. + + This is a human-readable label that is not included in the prompt sent to the model. + + - `latest_version: string | null` + + The latest version identifier for the skill. + + This represents the most recent version of the skill that has been created. + + - `source: string` + + Source of the skill. + + This may be one of the following values: + + * `"custom"`: the skill was created by a user + * `"anthropic"`: the skill was created by Anthropic + + - `type: string` + + Object type. + + For Skills, this is always `"skill"`. + + - `updated_at: string` + + ISO 8601 timestamp of when the skill was last updated. + +### Skill List Response + +- `SkillListResponse` + + - `id: string` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + + - `created_at: string` + + ISO 8601 timestamp of when the skill was created. + + - `display_title: string | null` + + Display title for the skill. + + This is a human-readable label that is not included in the prompt sent to the model. + + - `latest_version: string | null` + + The latest version identifier for the skill. + + This represents the most recent version of the skill that has been created. + + - `source: string` + + Source of the skill. + + This may be one of the following values: + + * `"custom"`: the skill was created by a user + * `"anthropic"`: the skill was created by Anthropic + + - `type: string` + + Object type. + + For Skills, this is always `"skill"`. + + - `updated_at: string` + + ISO 8601 timestamp of when the skill was last updated. + +### Skill Retrieve Response + +- `SkillRetrieveResponse` + + - `id: string` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + + - `created_at: string` + + ISO 8601 timestamp of when the skill was created. + + - `display_title: string | null` + + Display title for the skill. + + This is a human-readable label that is not included in the prompt sent to the model. + + - `latest_version: string | null` + + The latest version identifier for the skill. + + This represents the most recent version of the skill that has been created. + + - `source: string` + + Source of the skill. + + This may be one of the following values: + + * `"custom"`: the skill was created by a user + * `"anthropic"`: the skill was created by Anthropic + + - `type: string` + + Object type. + + For Skills, this is always `"skill"`. + + - `updated_at: string` + + ISO 8601 timestamp of when the skill was last updated. + +### Skill Delete Response + +- `SkillDeleteResponse` + + - `id: string` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + + - `type: string` + + Deleted object type. + + For Skills, this is always `"skill_deleted"`. + # Versions ## Create @@ -46165,7 +46672,7 @@ Create Skill Version - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -46207,6 +46714,10 @@ Create Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `VersionCreateResponse` @@ -46303,7 +46814,7 @@ List Skill Versions - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -46345,6 +46856,10 @@ List Skill Versions - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `VersionListResponse` @@ -46438,7 +46953,7 @@ Get Skill Version - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -46480,6 +46995,10 @@ Get Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `VersionRetrieveResponse` @@ -46572,7 +47091,7 @@ Delete Skill Version - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -46614,6 +47133,10 @@ Delete Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `VersionDeleteResponse` @@ -46643,3 +47166,748 @@ const version = await client.beta.skills.versions.delete('version', { skill_id: console.log(version.id); ``` + +## Domain Types + +### Version Create Response + +- `VersionCreateResponse` + + - `id: string` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: string` + + ISO 8601 timestamp of when the skill version was created. + + - `description: string` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: string` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: string` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: string` + + Identifier for the skill that this version belongs to. + + - `type: string` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: string` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version List Response + +- `VersionListResponse` + + - `id: string` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: string` + + ISO 8601 timestamp of when the skill version was created. + + - `description: string` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: string` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: string` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: string` + + Identifier for the skill that this version belongs to. + + - `type: string` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: string` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version Retrieve Response + +- `VersionRetrieveResponse` + + - `id: string` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: string` + + ISO 8601 timestamp of when the skill version was created. + + - `description: string` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: string` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: string` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: string` + + Identifier for the skill that this version belongs to. + + - `type: string` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: string` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version Delete Response + +- `VersionDeleteResponse` + + - `id: string` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + + - `type: string` + + Deleted object type. + + For Skill Versions, this is always `"skill_version_deleted"`. + +# User Profiles + +## Create + +`client.beta.userProfiles.create(UserProfileCreateParamsparams, RequestOptionsoptions?): BetaUserProfile` + +**post** `/v1/user_profiles` + +Create User Profile + +### Parameters + +- `params: UserProfileCreateParams` + + - `external_id?: string | null` + + Body param + + - `metadata?: Record` + + Body param: Free-form key-value data to attach to this user profile. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. Values must be non-empty strings. + + - `betas?: Array` + + Header param: Optional header to specify the beta version(s) you want to use. + + - `(string & {})` + + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `BetaUserProfile` + + - `id: string` + + - `created_at: string` + + A timestamp in RFC 3339 format + + - `metadata: Record` + + - `trust_grants: Record` + + - `status: string` + + - `type: string` + + - `updated_at: string` + + A timestamp in RFC 3339 format + + - `external_id?: string | null` + +### Example + +```typescript +import Anthropic from '@anthropic-ai/sdk'; + +const client = new Anthropic({ + apiKey: process.env['ANTHROPIC_API_KEY'], // This is the default and can be omitted +}); + +const betaUserProfile = await client.beta.userProfiles.create(); + +console.log(betaUserProfile.id); +``` + +## List + +`client.beta.userProfiles.list(UserProfileListParamsparams?, RequestOptionsoptions?): PageCursorV2` + +**get** `/v1/user_profiles` + +List User Profiles + +### Parameters + +- `params: UserProfileListParams` + + - `limit?: number` + + Query param: Query parameter for limit + + - `order?: "asc" | "desc"` + + Query param: Query parameter for order + + - `"asc"` + + - `"desc"` + + - `page?: string` + + Query param: Query parameter for page + + - `betas?: Array` + + Header param: Optional header to specify the beta version(s) you want to use. + + - `(string & {})` + + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `BetaUserProfile` + + - `id: string` + + - `created_at: string` + + A timestamp in RFC 3339 format + + - `metadata: Record` + + - `trust_grants: Record` + + - `status: string` + + - `type: string` + + - `updated_at: string` + + A timestamp in RFC 3339 format + + - `external_id?: string | null` + +### Example + +```typescript +import Anthropic from '@anthropic-ai/sdk'; + +const client = new Anthropic({ + apiKey: process.env['ANTHROPIC_API_KEY'], // This is the default and can be omitted +}); + +// Automatically fetches more pages as needed. +for await (const betaUserProfile of client.beta.userProfiles.list()) { + console.log(betaUserProfile.id); +} +``` + +## Retrieve + +`client.beta.userProfiles.retrieve(stringid, UserProfileRetrieveParamsparams?, RequestOptionsoptions?): BetaUserProfile` + +**get** `/v1/user_profiles/{id}` + +Get User Profile + +### Parameters + +- `id: string` + +- `params: UserProfileRetrieveParams` + + - `betas?: Array` + + Optional header to specify the beta version(s) you want to use. + + - `(string & {})` + + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `BetaUserProfile` + + - `id: string` + + - `created_at: string` + + A timestamp in RFC 3339 format + + - `metadata: Record` + + - `trust_grants: Record` + + - `status: string` + + - `type: string` + + - `updated_at: string` + + A timestamp in RFC 3339 format + + - `external_id?: string | null` + +### Example + +```typescript +import Anthropic from '@anthropic-ai/sdk'; + +const client = new Anthropic({ + apiKey: process.env['ANTHROPIC_API_KEY'], // This is the default and can be omitted +}); + +const betaUserProfile = await client.beta.userProfiles.retrieve('id'); + +console.log(betaUserProfile.id); +``` + +## Update + +`client.beta.userProfiles.update(stringid, UserProfileUpdateParamsparams, RequestOptionsoptions?): BetaUserProfile` + +**post** `/v1/user_profiles/{id}` + +Update User Profile + +### Parameters + +- `id: string` + +- `params: UserProfileUpdateParams` + + - `external_id?: string | null` + + Body param + + - `metadata?: Record` + + Body param: Key-value pairs to merge into the stored metadata. Keys provided overwrite existing values. To remove a key, set its value to an empty string. Keys not provided are left unchanged. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. + + - `betas?: Array` + + Header param: Optional header to specify the beta version(s) you want to use. + + - `(string & {})` + + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `BetaUserProfile` + + - `id: string` + + - `created_at: string` + + A timestamp in RFC 3339 format + + - `metadata: Record` + + - `trust_grants: Record` + + - `status: string` + + - `type: string` + + - `updated_at: string` + + A timestamp in RFC 3339 format + + - `external_id?: string | null` + +### Example + +```typescript +import Anthropic from '@anthropic-ai/sdk'; + +const client = new Anthropic({ + apiKey: process.env['ANTHROPIC_API_KEY'], // This is the default and can be omitted +}); + +const betaUserProfile = await client.beta.userProfiles.update('id'); + +console.log(betaUserProfile.id); +``` + +## Create Enrollment URL + +`client.beta.userProfiles.createEnrollmentURL(stringid, UserProfileCreateEnrollmentURLParamsparams?, RequestOptionsoptions?): BetaUserProfileEnrollmentURL` + +**post** `/v1/user_profiles/{id}/enrollment_url` + +Create Enrollment URL + +### Parameters + +- `id: string` + +- `params: UserProfileCreateEnrollmentURLParams` + + - `betas?: Array` + + Optional header to specify the beta version(s) you want to use. + + - `(string & {})` + + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `BetaUserProfileEnrollmentURL` + + - `expires_at: string` + + A timestamp in RFC 3339 format + + - `type: string` + + - `url: string` + +### Example + +```typescript +import Anthropic from '@anthropic-ai/sdk'; + +const client = new Anthropic({ + apiKey: process.env['ANTHROPIC_API_KEY'], // This is the default and can be omitted +}); + +const betaUserProfileEnrollmentURL = await client.beta.userProfiles.createEnrollmentURL('id'); + +console.log(betaUserProfileEnrollmentURL.expires_at); +``` + +## Domain Types + +### Beta User Profile + +- `BetaUserProfile` + + - `id: string` + + - `created_at: string` + + A timestamp in RFC 3339 format + + - `metadata: Record` + + - `trust_grants: Record` + + - `status: string` + + - `type: string` + + - `updated_at: string` + + A timestamp in RFC 3339 format + + - `external_id?: string | null` + +### Beta User Profile Enrollment URL + +- `BetaUserProfileEnrollmentURL` + + - `expires_at: string` + + A timestamp in RFC 3339 format + + - `type: string` + + - `url: string` + +### Beta User Profile Trust Grant + +- `BetaUserProfileTrustGrant` + + - `status: string` diff --git a/content/en/api/typescript/beta/files.md b/content/en/api/typescript/beta/files.md index 0d400eacf..c097dc2fa 100644 --- a/content/en/api/typescript/beta/files.md +++ b/content/en/api/typescript/beta/files.md @@ -22,7 +22,7 @@ Upload File - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -64,6 +64,10 @@ Upload File - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `FileMetadata` @@ -148,7 +152,7 @@ List Files - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -190,6 +194,10 @@ List Files - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `FileMetadata` @@ -265,7 +273,7 @@ Download File - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -307,6 +315,10 @@ Download File - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `unnamed_schema_1 = Response` @@ -350,7 +362,7 @@ Get File Metadata - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -392,6 +404,10 @@ Get File Metadata - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `FileMetadata` @@ -466,7 +482,7 @@ Delete File - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -508,6 +524,10 @@ Delete File - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `DeletedFile` diff --git a/content/en/api/typescript/beta/files/delete.md b/content/en/api/typescript/beta/files/delete.md index 419314ace..1bb06b909 100644 --- a/content/en/api/typescript/beta/files/delete.md +++ b/content/en/api/typescript/beta/files/delete.md @@ -20,7 +20,7 @@ Delete File - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -62,6 +62,10 @@ Delete File - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `DeletedFile` diff --git a/content/en/api/typescript/beta/files/download.md b/content/en/api/typescript/beta/files/download.md index 48c05f4d2..11b4a663c 100644 --- a/content/en/api/typescript/beta/files/download.md +++ b/content/en/api/typescript/beta/files/download.md @@ -20,7 +20,7 @@ Download File - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -62,6 +62,10 @@ Download File - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `unnamed_schema_1 = Response` diff --git a/content/en/api/typescript/beta/files/list.md b/content/en/api/typescript/beta/files/list.md index f3973d7dc..1c91938d9 100644 --- a/content/en/api/typescript/beta/files/list.md +++ b/content/en/api/typescript/beta/files/list.md @@ -30,7 +30,7 @@ List Files - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -72,6 +72,10 @@ List Files - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `FileMetadata` diff --git a/content/en/api/typescript/beta/files/retrieve_metadata.md b/content/en/api/typescript/beta/files/retrieve_metadata.md index 2e43d433f..143221aa3 100644 --- a/content/en/api/typescript/beta/files/retrieve_metadata.md +++ b/content/en/api/typescript/beta/files/retrieve_metadata.md @@ -20,7 +20,7 @@ Get File Metadata - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -62,6 +62,10 @@ Get File Metadata - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `FileMetadata` diff --git a/content/en/api/typescript/beta/files/upload.md b/content/en/api/typescript/beta/files/upload.md index 8d363b93d..2aa08c9d4 100644 --- a/content/en/api/typescript/beta/files/upload.md +++ b/content/en/api/typescript/beta/files/upload.md @@ -20,7 +20,7 @@ Upload File - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -62,6 +62,10 @@ Upload File - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `FileMetadata` diff --git a/content/en/api/typescript/beta/messages.md b/content/en/api/typescript/beta/messages.md index 30749744c..2bd345bec 100644 --- a/content/en/api/typescript/beta/messages.md +++ b/content/en/api/typescript/beta/messages.md @@ -4678,13 +4678,17 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en Recommended for advanced use cases only. You usually only need to use `temperature`. + - `user_profile_id?: string | null` + + Body param: The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + - `betas?: Array` Header param: Optional header to specify the beta version(s) you want to use. - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -4726,6 +4730,10 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + - `MessageCreateParamsNonStreaming extends MessageCreateParamsBase` - `stream?: false` @@ -5741,6 +5749,30 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `"assistant"` + - `stop_details: BetaRefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason | null` The reason that we stopped. @@ -10540,7 +10572,7 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -10582,6 +10614,10 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaMessageTokensCount` @@ -17872,6 +17908,30 @@ console.log(betaMessageTokensCount.context_management); - `"assistant"` + - `stop_details: BetaRefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason | null` The reason that we stopped. @@ -22017,6 +22077,30 @@ console.log(betaMessageTokensCount.context_management); Skill version or 'latest' for most recent version + - `stop_details: BetaRefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason | null` - `"end_turn"` @@ -23164,6 +23248,30 @@ console.log(betaMessageTokensCount.context_management); - `"assistant"` + - `stop_details: BetaRefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason | null` The reason that we stopped. @@ -24380,6 +24488,30 @@ console.log(betaMessageTokensCount.context_management); - `"assistant"` + - `stop_details: BetaRefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason | null` The reason that we stopped. @@ -24665,6 +24797,30 @@ console.log(betaMessageTokensCount.context_management); Skill version or 'latest' for most recent version + - `stop_details: BetaRefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason | null` - `"end_turn"` @@ -25809,6 +25965,32 @@ console.log(betaMessageTokensCount.context_management); - `"redacted_thinking"` +### Beta Refusal Stop Details + +- `BetaRefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + ### Beta Request Document Block - `BetaRequestDocumentBlock` @@ -37445,13 +37627,17 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Recommended for advanced use cases only. You usually only need to use `temperature`. + - `user_profile_id?: string | null` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + - `betas?: Array` Header param: Optional header to specify the beta version(s) you want to use. - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -37493,6 +37679,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaMessageBatch` @@ -37632,7 +37822,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -37674,6 +37864,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaMessageBatch` @@ -37812,7 +38006,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -37854,6 +38048,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaMessageBatch` @@ -37985,7 +38183,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -38027,6 +38225,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaMessageBatch` @@ -38157,7 +38359,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -38199,6 +38401,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaDeletedMessageBatch` @@ -38255,7 +38461,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -38297,6 +38503,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaMessageBatchIndividualResponse` @@ -39310,6 +39520,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"assistant"` + - `stop_details: BetaRefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason | null` The reason that we stopped. @@ -40862,6 +41096,30 @@ console.log(betaMessageBatchIndividualResponse.custom_id); - `"assistant"` + - `stop_details: BetaRefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason | null` The reason that we stopped. @@ -42206,6 +42464,30 @@ console.log(betaMessageBatchIndividualResponse.custom_id); - `"assistant"` + - `stop_details: BetaRefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason | null` The reason that we stopped. @@ -43512,6 +43794,30 @@ console.log(betaMessageBatchIndividualResponse.custom_id); - `"assistant"` + - `stop_details: BetaRefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason | null` The reason that we stopped. diff --git a/content/en/api/typescript/beta/messages/batches.md b/content/en/api/typescript/beta/messages/batches.md index 146fdb4b5..e0da020fe 100644 --- a/content/en/api/typescript/beta/messages/batches.md +++ b/content/en/api/typescript/beta/messages/batches.md @@ -4690,13 +4690,17 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Recommended for advanced use cases only. You usually only need to use `temperature`. + - `user_profile_id?: string | null` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + - `betas?: Array` Header param: Optional header to specify the beta version(s) you want to use. - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -4738,6 +4742,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaMessageBatch` @@ -4877,7 +4885,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -4919,6 +4927,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaMessageBatch` @@ -5057,7 +5069,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -5099,6 +5111,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaMessageBatch` @@ -5230,7 +5246,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -5272,6 +5288,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaMessageBatch` @@ -5402,7 +5422,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -5444,6 +5464,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaDeletedMessageBatch` @@ -5500,7 +5524,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -5542,6 +5566,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaMessageBatchIndividualResponse` @@ -6555,6 +6583,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"assistant"` + - `stop_details: BetaRefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason | null` The reason that we stopped. @@ -8107,6 +8159,30 @@ console.log(betaMessageBatchIndividualResponse.custom_id); - `"assistant"` + - `stop_details: BetaRefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason | null` The reason that we stopped. @@ -9451,6 +9527,30 @@ console.log(betaMessageBatchIndividualResponse.custom_id); - `"assistant"` + - `stop_details: BetaRefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason | null` The reason that we stopped. @@ -10757,6 +10857,30 @@ console.log(betaMessageBatchIndividualResponse.custom_id); - `"assistant"` + - `stop_details: BetaRefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason | null` The reason that we stopped. diff --git a/content/en/api/typescript/beta/messages/batches/cancel.md b/content/en/api/typescript/beta/messages/batches/cancel.md index 224b5b66e..6c502136d 100644 --- a/content/en/api/typescript/beta/messages/batches/cancel.md +++ b/content/en/api/typescript/beta/messages/batches/cancel.md @@ -24,7 +24,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -66,6 +66,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaMessageBatch` diff --git a/content/en/api/typescript/beta/messages/batches/create.md b/content/en/api/typescript/beta/messages/batches/create.md index c2629c83d..1001517bb 100644 --- a/content/en/api/typescript/beta/messages/batches/create.md +++ b/content/en/api/typescript/beta/messages/batches/create.md @@ -4688,13 +4688,17 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude Recommended for advanced use cases only. You usually only need to use `temperature`. + - `user_profile_id?: string | null` + + The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + - `betas?: Array` Header param: Optional header to specify the beta version(s) you want to use. - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -4736,6 +4740,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaMessageBatch` diff --git a/content/en/api/typescript/beta/messages/batches/delete.md b/content/en/api/typescript/beta/messages/batches/delete.md index 2a2425218..637b50a6e 100644 --- a/content/en/api/typescript/beta/messages/batches/delete.md +++ b/content/en/api/typescript/beta/messages/batches/delete.md @@ -24,7 +24,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -66,6 +66,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaDeletedMessageBatch` diff --git a/content/en/api/typescript/beta/messages/batches/list.md b/content/en/api/typescript/beta/messages/batches/list.md index 1829182aa..0be19f368 100644 --- a/content/en/api/typescript/beta/messages/batches/list.md +++ b/content/en/api/typescript/beta/messages/batches/list.md @@ -32,7 +32,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -74,6 +74,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaMessageBatch` diff --git a/content/en/api/typescript/beta/messages/batches/results.md b/content/en/api/typescript/beta/messages/batches/results.md index 848c2e82a..0d9c73e7e 100644 --- a/content/en/api/typescript/beta/messages/batches/results.md +++ b/content/en/api/typescript/beta/messages/batches/results.md @@ -24,7 +24,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -66,6 +66,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaMessageBatchIndividualResponse` @@ -1079,6 +1083,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"assistant"` + - `stop_details: BetaRefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason | null` The reason that we stopped. diff --git a/content/en/api/typescript/beta/messages/batches/retrieve.md b/content/en/api/typescript/beta/messages/batches/retrieve.md index 2fb412ffa..15b8ade12 100644 --- a/content/en/api/typescript/beta/messages/batches/retrieve.md +++ b/content/en/api/typescript/beta/messages/batches/retrieve.md @@ -22,7 +22,7 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -64,6 +64,10 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaMessageBatch` diff --git a/content/en/api/typescript/beta/messages/count_tokens.md b/content/en/api/typescript/beta/messages/count_tokens.md index b331bcb3c..4e13c4d0b 100644 --- a/content/en/api/typescript/beta/messages/count_tokens.md +++ b/content/en/api/typescript/beta/messages/count_tokens.md @@ -4574,7 +4574,7 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -4616,6 +4616,10 @@ Learn more about token counting in our [user guide](https://docs.claude.com/en/d - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaMessageTokensCount` diff --git a/content/en/api/typescript/beta/messages/create.md b/content/en/api/typescript/beta/messages/create.md index baaa55ed6..04e68e15b 100644 --- a/content/en/api/typescript/beta/messages/create.md +++ b/content/en/api/typescript/beta/messages/create.md @@ -4676,13 +4676,17 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en Recommended for advanced use cases only. You usually only need to use `temperature`. + - `user_profile_id?: string | null` + + Body param: The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. + - `betas?: Array` Header param: Optional header to specify the beta version(s) you want to use. - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -4724,6 +4728,10 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + - `MessageCreateParamsNonStreaming extends MessageCreateParamsBase` - `stream?: false` @@ -5739,6 +5747,30 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `"assistant"` + - `stop_details: BetaRefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: BetaStopReason | null` The reason that we stopped. diff --git a/content/en/api/typescript/beta/models.md b/content/en/api/typescript/beta/models.md index be39a0085..9c57c027f 100644 --- a/content/en/api/typescript/beta/models.md +++ b/content/en/api/typescript/beta/models.md @@ -34,7 +34,7 @@ The Models API response can be used to determine which models are available for - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -76,6 +76,10 @@ The Models API response can be used to determine which models are available for - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaModelInfo` @@ -299,7 +303,7 @@ The Models API response can be used to determine information about a specific mo - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -341,6 +345,10 @@ The Models API response can be used to determine information about a specific mo - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaModelInfo` diff --git a/content/en/api/typescript/beta/models/list.md b/content/en/api/typescript/beta/models/list.md index 7f6c46861..9d859b0c8 100644 --- a/content/en/api/typescript/beta/models/list.md +++ b/content/en/api/typescript/beta/models/list.md @@ -32,7 +32,7 @@ The Models API response can be used to determine which models are available for - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -74,6 +74,10 @@ The Models API response can be used to determine which models are available for - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaModelInfo` diff --git a/content/en/api/typescript/beta/models/retrieve.md b/content/en/api/typescript/beta/models/retrieve.md index f9c563b1a..7456fda4f 100644 --- a/content/en/api/typescript/beta/models/retrieve.md +++ b/content/en/api/typescript/beta/models/retrieve.md @@ -22,7 +22,7 @@ The Models API response can be used to determine information about a specific mo - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -64,6 +64,10 @@ The Models API response can be used to determine information about a specific mo - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `BetaModelInfo` diff --git a/content/en/api/typescript/beta/skills.md b/content/en/api/typescript/beta/skills.md index 295f40dcb..35c86039b 100644 --- a/content/en/api/typescript/beta/skills.md +++ b/content/en/api/typescript/beta/skills.md @@ -30,7 +30,7 @@ Create Skill - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -72,6 +72,10 @@ Create Skill - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `SkillCreateResponse` @@ -170,7 +174,7 @@ List Skills - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -212,6 +216,10 @@ List Skills - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `SkillListResponse` @@ -296,7 +304,7 @@ Get Skill - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -338,6 +346,10 @@ Get Skill - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `SkillRetrieveResponse` @@ -421,7 +433,7 @@ Delete Skill - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -463,6 +475,10 @@ Delete Skill - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `SkillDeleteResponse` @@ -493,6 +509,159 @@ const skill = await client.beta.skills.delete('skill_id'); console.log(skill.id); ``` +## Domain Types + +### Skill Create Response + +- `SkillCreateResponse` + + - `id: string` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + + - `created_at: string` + + ISO 8601 timestamp of when the skill was created. + + - `display_title: string | null` + + Display title for the skill. + + This is a human-readable label that is not included in the prompt sent to the model. + + - `latest_version: string | null` + + The latest version identifier for the skill. + + This represents the most recent version of the skill that has been created. + + - `source: string` + + Source of the skill. + + This may be one of the following values: + + * `"custom"`: the skill was created by a user + * `"anthropic"`: the skill was created by Anthropic + + - `type: string` + + Object type. + + For Skills, this is always `"skill"`. + + - `updated_at: string` + + ISO 8601 timestamp of when the skill was last updated. + +### Skill List Response + +- `SkillListResponse` + + - `id: string` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + + - `created_at: string` + + ISO 8601 timestamp of when the skill was created. + + - `display_title: string | null` + + Display title for the skill. + + This is a human-readable label that is not included in the prompt sent to the model. + + - `latest_version: string | null` + + The latest version identifier for the skill. + + This represents the most recent version of the skill that has been created. + + - `source: string` + + Source of the skill. + + This may be one of the following values: + + * `"custom"`: the skill was created by a user + * `"anthropic"`: the skill was created by Anthropic + + - `type: string` + + Object type. + + For Skills, this is always `"skill"`. + + - `updated_at: string` + + ISO 8601 timestamp of when the skill was last updated. + +### Skill Retrieve Response + +- `SkillRetrieveResponse` + + - `id: string` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + + - `created_at: string` + + ISO 8601 timestamp of when the skill was created. + + - `display_title: string | null` + + Display title for the skill. + + This is a human-readable label that is not included in the prompt sent to the model. + + - `latest_version: string | null` + + The latest version identifier for the skill. + + This represents the most recent version of the skill that has been created. + + - `source: string` + + Source of the skill. + + This may be one of the following values: + + * `"custom"`: the skill was created by a user + * `"anthropic"`: the skill was created by Anthropic + + - `type: string` + + Object type. + + For Skills, this is always `"skill"`. + + - `updated_at: string` + + ISO 8601 timestamp of when the skill was last updated. + +### Skill Delete Response + +- `SkillDeleteResponse` + + - `id: string` + + Unique identifier for the skill. + + The format and length of IDs may change over time. + + - `type: string` + + Deleted object type. + + For Skills, this is always `"skill_deleted"`. + # Versions ## Create @@ -525,7 +694,7 @@ Create Skill Version - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -567,6 +736,10 @@ Create Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `VersionCreateResponse` @@ -663,7 +836,7 @@ List Skill Versions - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -705,6 +878,10 @@ List Skill Versions - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `VersionListResponse` @@ -798,7 +975,7 @@ Get Skill Version - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -840,6 +1017,10 @@ Get Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `VersionRetrieveResponse` @@ -932,7 +1113,7 @@ Delete Skill Version - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -974,6 +1155,10 @@ Delete Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `VersionDeleteResponse` @@ -1003,3 +1188,165 @@ const version = await client.beta.skills.versions.delete('version', { skill_id: console.log(version.id); ``` + +## Domain Types + +### Version Create Response + +- `VersionCreateResponse` + + - `id: string` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: string` + + ISO 8601 timestamp of when the skill version was created. + + - `description: string` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: string` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: string` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: string` + + Identifier for the skill that this version belongs to. + + - `type: string` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: string` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version List Response + +- `VersionListResponse` + + - `id: string` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: string` + + ISO 8601 timestamp of when the skill version was created. + + - `description: string` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: string` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: string` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: string` + + Identifier for the skill that this version belongs to. + + - `type: string` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: string` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version Retrieve Response + +- `VersionRetrieveResponse` + + - `id: string` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: string` + + ISO 8601 timestamp of when the skill version was created. + + - `description: string` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: string` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: string` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: string` + + Identifier for the skill that this version belongs to. + + - `type: string` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: string` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version Delete Response + +- `VersionDeleteResponse` + + - `id: string` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + + - `type: string` + + Deleted object type. + + For Skill Versions, this is always `"skill_version_deleted"`. diff --git a/content/en/api/typescript/beta/skills/create.md b/content/en/api/typescript/beta/skills/create.md index 6d75c7169..8b3cb9784 100644 --- a/content/en/api/typescript/beta/skills/create.md +++ b/content/en/api/typescript/beta/skills/create.md @@ -28,7 +28,7 @@ Create Skill - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -70,6 +70,10 @@ Create Skill - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `SkillCreateResponse` diff --git a/content/en/api/typescript/beta/skills/delete.md b/content/en/api/typescript/beta/skills/delete.md index 5b0a46549..6224fd18c 100644 --- a/content/en/api/typescript/beta/skills/delete.md +++ b/content/en/api/typescript/beta/skills/delete.md @@ -22,7 +22,7 @@ Delete Skill - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -64,6 +64,10 @@ Delete Skill - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `SkillDeleteResponse` diff --git a/content/en/api/typescript/beta/skills/list.md b/content/en/api/typescript/beta/skills/list.md index 94821d98d..c20bf7698 100644 --- a/content/en/api/typescript/beta/skills/list.md +++ b/content/en/api/typescript/beta/skills/list.md @@ -37,7 +37,7 @@ List Skills - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -79,6 +79,10 @@ List Skills - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `SkillListResponse` diff --git a/content/en/api/typescript/beta/skills/retrieve.md b/content/en/api/typescript/beta/skills/retrieve.md index a4c51cf74..77a323a1e 100644 --- a/content/en/api/typescript/beta/skills/retrieve.md +++ b/content/en/api/typescript/beta/skills/retrieve.md @@ -22,7 +22,7 @@ Get Skill - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -64,6 +64,10 @@ Get Skill - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `SkillRetrieveResponse` diff --git a/content/en/api/typescript/beta/skills/versions.md b/content/en/api/typescript/beta/skills/versions.md index f6852d633..51d41beed 100644 --- a/content/en/api/typescript/beta/skills/versions.md +++ b/content/en/api/typescript/beta/skills/versions.md @@ -30,7 +30,7 @@ Create Skill Version - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -72,6 +72,10 @@ Create Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `VersionCreateResponse` @@ -168,7 +172,7 @@ List Skill Versions - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -210,6 +214,10 @@ List Skill Versions - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `VersionListResponse` @@ -303,7 +311,7 @@ Get Skill Version - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -345,6 +353,10 @@ Get Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `VersionRetrieveResponse` @@ -437,7 +449,7 @@ Delete Skill Version - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -479,6 +491,10 @@ Delete Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `VersionDeleteResponse` @@ -508,3 +524,165 @@ const version = await client.beta.skills.versions.delete('version', { skill_id: console.log(version.id); ``` + +## Domain Types + +### Version Create Response + +- `VersionCreateResponse` + + - `id: string` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: string` + + ISO 8601 timestamp of when the skill version was created. + + - `description: string` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: string` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: string` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: string` + + Identifier for the skill that this version belongs to. + + - `type: string` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: string` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version List Response + +- `VersionListResponse` + + - `id: string` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: string` + + ISO 8601 timestamp of when the skill version was created. + + - `description: string` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: string` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: string` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: string` + + Identifier for the skill that this version belongs to. + + - `type: string` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: string` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version Retrieve Response + +- `VersionRetrieveResponse` + + - `id: string` + + Unique identifier for the skill version. + + The format and length of IDs may change over time. + + - `created_at: string` + + ISO 8601 timestamp of when the skill version was created. + + - `description: string` + + Description of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `directory: string` + + Directory name of the skill version. + + This is the top-level directory name that was extracted from the uploaded files. + + - `name: string` + + Human-readable name of the skill version. + + This is extracted from the SKILL.md file in the skill upload. + + - `skill_id: string` + + Identifier for the skill that this version belongs to. + + - `type: string` + + Object type. + + For Skill Versions, this is always `"skill_version"`. + + - `version: string` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + +### Version Delete Response + +- `VersionDeleteResponse` + + - `id: string` + + Version identifier for the skill. + + Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). + + - `type: string` + + Deleted object type. + + For Skill Versions, this is always `"skill_version_deleted"`. diff --git a/content/en/api/typescript/beta/skills/versions/create.md b/content/en/api/typescript/beta/skills/versions/create.md index 51f7e5e6b..0c67a795f 100644 --- a/content/en/api/typescript/beta/skills/versions/create.md +++ b/content/en/api/typescript/beta/skills/versions/create.md @@ -28,7 +28,7 @@ Create Skill Version - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -70,6 +70,10 @@ Create Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `VersionCreateResponse` diff --git a/content/en/api/typescript/beta/skills/versions/delete.md b/content/en/api/typescript/beta/skills/versions/delete.md index 93b240d4a..5e5d517af 100644 --- a/content/en/api/typescript/beta/skills/versions/delete.md +++ b/content/en/api/typescript/beta/skills/versions/delete.md @@ -28,7 +28,7 @@ Delete Skill Version - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -70,6 +70,10 @@ Delete Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `VersionDeleteResponse` diff --git a/content/en/api/typescript/beta/skills/versions/list.md b/content/en/api/typescript/beta/skills/versions/list.md index 1b01ec023..ae5d1fae6 100644 --- a/content/en/api/typescript/beta/skills/versions/list.md +++ b/content/en/api/typescript/beta/skills/versions/list.md @@ -32,7 +32,7 @@ List Skill Versions - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -74,6 +74,10 @@ List Skill Versions - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `VersionListResponse` diff --git a/content/en/api/typescript/beta/skills/versions/retrieve.md b/content/en/api/typescript/beta/skills/versions/retrieve.md index 38de077f3..8abc41308 100644 --- a/content/en/api/typescript/beta/skills/versions/retrieve.md +++ b/content/en/api/typescript/beta/skills/versions/retrieve.md @@ -28,7 +28,7 @@ Get Skill Version - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -70,6 +70,10 @@ Get Skill Version - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `VersionRetrieveResponse` diff --git a/content/en/api/typescript/beta/user_profiles.md b/content/en/api/typescript/beta/user_profiles.md new file mode 100644 index 000000000..bf1644857 --- /dev/null +++ b/content/en/api/typescript/beta/user_profiles.md @@ -0,0 +1,582 @@ +# User Profiles + +## Create + +`client.beta.userProfiles.create(UserProfileCreateParamsparams, RequestOptionsoptions?): BetaUserProfile` + +**post** `/v1/user_profiles` + +Create User Profile + +### Parameters + +- `params: UserProfileCreateParams` + + - `external_id?: string | null` + + Body param + + - `metadata?: Record` + + Body param: Free-form key-value data to attach to this user profile. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. Values must be non-empty strings. + + - `betas?: Array` + + Header param: Optional header to specify the beta version(s) you want to use. + + - `(string & {})` + + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `BetaUserProfile` + + - `id: string` + + - `created_at: string` + + A timestamp in RFC 3339 format + + - `metadata: Record` + + - `trust_grants: Record` + + - `status: string` + + - `type: string` + + - `updated_at: string` + + A timestamp in RFC 3339 format + + - `external_id?: string | null` + +### Example + +```typescript +import Anthropic from '@anthropic-ai/sdk'; + +const client = new Anthropic({ + apiKey: process.env['ANTHROPIC_API_KEY'], // This is the default and can be omitted +}); + +const betaUserProfile = await client.beta.userProfiles.create(); + +console.log(betaUserProfile.id); +``` + +## List + +`client.beta.userProfiles.list(UserProfileListParamsparams?, RequestOptionsoptions?): PageCursorV2` + +**get** `/v1/user_profiles` + +List User Profiles + +### Parameters + +- `params: UserProfileListParams` + + - `limit?: number` + + Query param: Query parameter for limit + + - `order?: "asc" | "desc"` + + Query param: Query parameter for order + + - `"asc"` + + - `"desc"` + + - `page?: string` + + Query param: Query parameter for page + + - `betas?: Array` + + Header param: Optional header to specify the beta version(s) you want to use. + + - `(string & {})` + + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `BetaUserProfile` + + - `id: string` + + - `created_at: string` + + A timestamp in RFC 3339 format + + - `metadata: Record` + + - `trust_grants: Record` + + - `status: string` + + - `type: string` + + - `updated_at: string` + + A timestamp in RFC 3339 format + + - `external_id?: string | null` + +### Example + +```typescript +import Anthropic from '@anthropic-ai/sdk'; + +const client = new Anthropic({ + apiKey: process.env['ANTHROPIC_API_KEY'], // This is the default and can be omitted +}); + +// Automatically fetches more pages as needed. +for await (const betaUserProfile of client.beta.userProfiles.list()) { + console.log(betaUserProfile.id); +} +``` + +## Retrieve + +`client.beta.userProfiles.retrieve(stringid, UserProfileRetrieveParamsparams?, RequestOptionsoptions?): BetaUserProfile` + +**get** `/v1/user_profiles/{id}` + +Get User Profile + +### Parameters + +- `id: string` + +- `params: UserProfileRetrieveParams` + + - `betas?: Array` + + Optional header to specify the beta version(s) you want to use. + + - `(string & {})` + + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `BetaUserProfile` + + - `id: string` + + - `created_at: string` + + A timestamp in RFC 3339 format + + - `metadata: Record` + + - `trust_grants: Record` + + - `status: string` + + - `type: string` + + - `updated_at: string` + + A timestamp in RFC 3339 format + + - `external_id?: string | null` + +### Example + +```typescript +import Anthropic from '@anthropic-ai/sdk'; + +const client = new Anthropic({ + apiKey: process.env['ANTHROPIC_API_KEY'], // This is the default and can be omitted +}); + +const betaUserProfile = await client.beta.userProfiles.retrieve('id'); + +console.log(betaUserProfile.id); +``` + +## Update + +`client.beta.userProfiles.update(stringid, UserProfileUpdateParamsparams, RequestOptionsoptions?): BetaUserProfile` + +**post** `/v1/user_profiles/{id}` + +Update User Profile + +### Parameters + +- `id: string` + +- `params: UserProfileUpdateParams` + + - `external_id?: string | null` + + Body param + + - `metadata?: Record` + + Body param: Key-value pairs to merge into the stored metadata. Keys provided overwrite existing values. To remove a key, set its value to an empty string. Keys not provided are left unchanged. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. + + - `betas?: Array` + + Header param: Optional header to specify the beta version(s) you want to use. + + - `(string & {})` + + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `BetaUserProfile` + + - `id: string` + + - `created_at: string` + + A timestamp in RFC 3339 format + + - `metadata: Record` + + - `trust_grants: Record` + + - `status: string` + + - `type: string` + + - `updated_at: string` + + A timestamp in RFC 3339 format + + - `external_id?: string | null` + +### Example + +```typescript +import Anthropic from '@anthropic-ai/sdk'; + +const client = new Anthropic({ + apiKey: process.env['ANTHROPIC_API_KEY'], // This is the default and can be omitted +}); + +const betaUserProfile = await client.beta.userProfiles.update('id'); + +console.log(betaUserProfile.id); +``` + +## Create Enrollment URL + +`client.beta.userProfiles.createEnrollmentURL(stringid, UserProfileCreateEnrollmentURLParamsparams?, RequestOptionsoptions?): BetaUserProfileEnrollmentURL` + +**post** `/v1/user_profiles/{id}/enrollment_url` + +Create Enrollment URL + +### Parameters + +- `id: string` + +- `params: UserProfileCreateEnrollmentURLParams` + + - `betas?: Array` + + Optional header to specify the beta version(s) you want to use. + + - `(string & {})` + + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `BetaUserProfileEnrollmentURL` + + - `expires_at: string` + + A timestamp in RFC 3339 format + + - `type: string` + + - `url: string` + +### Example + +```typescript +import Anthropic from '@anthropic-ai/sdk'; + +const client = new Anthropic({ + apiKey: process.env['ANTHROPIC_API_KEY'], // This is the default and can be omitted +}); + +const betaUserProfileEnrollmentURL = await client.beta.userProfiles.createEnrollmentURL('id'); + +console.log(betaUserProfileEnrollmentURL.expires_at); +``` + +## Domain Types + +### Beta User Profile + +- `BetaUserProfile` + + - `id: string` + + - `created_at: string` + + A timestamp in RFC 3339 format + + - `metadata: Record` + + - `trust_grants: Record` + + - `status: string` + + - `type: string` + + - `updated_at: string` + + A timestamp in RFC 3339 format + + - `external_id?: string | null` + +### Beta User Profile Enrollment URL + +- `BetaUserProfileEnrollmentURL` + + - `expires_at: string` + + A timestamp in RFC 3339 format + + - `type: string` + + - `url: string` + +### Beta User Profile Trust Grant + +- `BetaUserProfileTrustGrant` + + - `status: string` diff --git a/content/en/api/typescript/beta/user_profiles/create.md b/content/en/api/typescript/beta/user_profiles/create.md new file mode 100644 index 000000000..61c679f0a --- /dev/null +++ b/content/en/api/typescript/beta/user_profiles/create.md @@ -0,0 +1,109 @@ +## Create + +`client.beta.userProfiles.create(UserProfileCreateParamsparams, RequestOptionsoptions?): BetaUserProfile` + +**post** `/v1/user_profiles` + +Create User Profile + +### Parameters + +- `params: UserProfileCreateParams` + + - `external_id?: string | null` + + Body param + + - `metadata?: Record` + + Body param: Free-form key-value data to attach to this user profile. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. Values must be non-empty strings. + + - `betas?: Array` + + Header param: Optional header to specify the beta version(s) you want to use. + + - `(string & {})` + + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `BetaUserProfile` + + - `id: string` + + - `created_at: string` + + A timestamp in RFC 3339 format + + - `metadata: Record` + + - `trust_grants: Record` + + - `status: string` + + - `type: string` + + - `updated_at: string` + + A timestamp in RFC 3339 format + + - `external_id?: string | null` + +### Example + +```typescript +import Anthropic from '@anthropic-ai/sdk'; + +const client = new Anthropic({ + apiKey: process.env['ANTHROPIC_API_KEY'], // This is the default and can be omitted +}); + +const betaUserProfile = await client.beta.userProfiles.create(); + +console.log(betaUserProfile.id); +``` diff --git a/content/en/api/typescript/beta/user_profiles/create_enrollment_url.md b/content/en/api/typescript/beta/user_profiles/create_enrollment_url.md new file mode 100644 index 000000000..b31abc3c9 --- /dev/null +++ b/content/en/api/typescript/beta/user_profiles/create_enrollment_url.md @@ -0,0 +1,91 @@ +## Create Enrollment URL + +`client.beta.userProfiles.createEnrollmentURL(stringid, UserProfileCreateEnrollmentURLParamsparams?, RequestOptionsoptions?): BetaUserProfileEnrollmentURL` + +**post** `/v1/user_profiles/{id}/enrollment_url` + +Create Enrollment URL + +### Parameters + +- `id: string` + +- `params: UserProfileCreateEnrollmentURLParams` + + - `betas?: Array` + + Optional header to specify the beta version(s) you want to use. + + - `(string & {})` + + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `BetaUserProfileEnrollmentURL` + + - `expires_at: string` + + A timestamp in RFC 3339 format + + - `type: string` + + - `url: string` + +### Example + +```typescript +import Anthropic from '@anthropic-ai/sdk'; + +const client = new Anthropic({ + apiKey: process.env['ANTHROPIC_API_KEY'], // This is the default and can be omitted +}); + +const betaUserProfileEnrollmentURL = await client.beta.userProfiles.createEnrollmentURL('id'); + +console.log(betaUserProfileEnrollmentURL.expires_at); +``` diff --git a/content/en/api/typescript/beta/user_profiles/list.md b/content/en/api/typescript/beta/user_profiles/list.md new file mode 100644 index 000000000..777ff900d --- /dev/null +++ b/content/en/api/typescript/beta/user_profiles/list.md @@ -0,0 +1,118 @@ +## List + +`client.beta.userProfiles.list(UserProfileListParamsparams?, RequestOptionsoptions?): PageCursorV2` + +**get** `/v1/user_profiles` + +List User Profiles + +### Parameters + +- `params: UserProfileListParams` + + - `limit?: number` + + Query param: Query parameter for limit + + - `order?: "asc" | "desc"` + + Query param: Query parameter for order + + - `"asc"` + + - `"desc"` + + - `page?: string` + + Query param: Query parameter for page + + - `betas?: Array` + + Header param: Optional header to specify the beta version(s) you want to use. + + - `(string & {})` + + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `BetaUserProfile` + + - `id: string` + + - `created_at: string` + + A timestamp in RFC 3339 format + + - `metadata: Record` + + - `trust_grants: Record` + + - `status: string` + + - `type: string` + + - `updated_at: string` + + A timestamp in RFC 3339 format + + - `external_id?: string | null` + +### Example + +```typescript +import Anthropic from '@anthropic-ai/sdk'; + +const client = new Anthropic({ + apiKey: process.env['ANTHROPIC_API_KEY'], // This is the default and can be omitted +}); + +// Automatically fetches more pages as needed. +for await (const betaUserProfile of client.beta.userProfiles.list()) { + console.log(betaUserProfile.id); +} +``` diff --git a/content/en/api/typescript/beta/user_profiles/retrieve.md b/content/en/api/typescript/beta/user_profiles/retrieve.md new file mode 100644 index 000000000..9f4613e03 --- /dev/null +++ b/content/en/api/typescript/beta/user_profiles/retrieve.md @@ -0,0 +1,103 @@ +## Retrieve + +`client.beta.userProfiles.retrieve(stringid, UserProfileRetrieveParamsparams?, RequestOptionsoptions?): BetaUserProfile` + +**get** `/v1/user_profiles/{id}` + +Get User Profile + +### Parameters + +- `id: string` + +- `params: UserProfileRetrieveParams` + + - `betas?: Array` + + Optional header to specify the beta version(s) you want to use. + + - `(string & {})` + + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `BetaUserProfile` + + - `id: string` + + - `created_at: string` + + A timestamp in RFC 3339 format + + - `metadata: Record` + + - `trust_grants: Record` + + - `status: string` + + - `type: string` + + - `updated_at: string` + + A timestamp in RFC 3339 format + + - `external_id?: string | null` + +### Example + +```typescript +import Anthropic from '@anthropic-ai/sdk'; + +const client = new Anthropic({ + apiKey: process.env['ANTHROPIC_API_KEY'], // This is the default and can be omitted +}); + +const betaUserProfile = await client.beta.userProfiles.retrieve('id'); + +console.log(betaUserProfile.id); +``` diff --git a/content/en/api/typescript/beta/user_profiles/update.md b/content/en/api/typescript/beta/user_profiles/update.md new file mode 100644 index 000000000..59ecd881f --- /dev/null +++ b/content/en/api/typescript/beta/user_profiles/update.md @@ -0,0 +1,111 @@ +## Update + +`client.beta.userProfiles.update(stringid, UserProfileUpdateParamsparams, RequestOptionsoptions?): BetaUserProfile` + +**post** `/v1/user_profiles/{id}` + +Update User Profile + +### Parameters + +- `id: string` + +- `params: UserProfileUpdateParams` + + - `external_id?: string | null` + + Body param + + - `metadata?: Record` + + Body param: Key-value pairs to merge into the stored metadata. Keys provided overwrite existing values. To remove a key, set its value to an empty string. Keys not provided are left unchanged. Maximum 16 keys, with keys up to 64 characters and values up to 512 characters. + + - `betas?: Array` + + Header param: Optional header to specify the beta version(s) you want to use. + + - `(string & {})` + + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + +### Returns + +- `BetaUserProfile` + + - `id: string` + + - `created_at: string` + + A timestamp in RFC 3339 format + + - `metadata: Record` + + - `trust_grants: Record` + + - `status: string` + + - `type: string` + + - `updated_at: string` + + A timestamp in RFC 3339 format + + - `external_id?: string | null` + +### Example + +```typescript +import Anthropic from '@anthropic-ai/sdk'; + +const client = new Anthropic({ + apiKey: process.env['ANTHROPIC_API_KEY'], // This is the default and can be omitted +}); + +const betaUserProfile = await client.beta.userProfiles.update('id'); + +console.log(betaUserProfile.id); +``` diff --git a/content/en/api/typescript/completions.md b/content/en/api/typescript/completions.md index 3e4dfc2bf..c93142d1d 100644 --- a/content/en/api/typescript/completions.md +++ b/content/en/api/typescript/completions.md @@ -170,7 +170,7 @@ Future models and features will not be compatible with Text Completions. See our - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -212,6 +212,10 @@ Future models and features will not be compatible with Text Completions. See our - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + - `CompletionCreateParamsNonStreaming extends CompletionCreateParamsBase` - `stream?: false` diff --git a/content/en/api/typescript/completions/create.md b/content/en/api/typescript/completions/create.md index db19519f4..79ec54874 100644 --- a/content/en/api/typescript/completions/create.md +++ b/content/en/api/typescript/completions/create.md @@ -168,7 +168,7 @@ Future models and features will not be compatible with Text Completions. See our - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -210,6 +210,10 @@ Future models and features will not be compatible with Text Completions. See our - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + - `CompletionCreateParamsNonStreaming extends CompletionCreateParamsBase` - `stream?: false` diff --git a/content/en/api/typescript/messages.md b/content/en/api/typescript/messages.md index f2d948d57..2d733d205 100644 --- a/content/en/api/typescript/messages.md +++ b/content/en/api/typescript/messages.md @@ -4626,6 +4626,30 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `"assistant"` + - `stop_details: RefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: StopReason | null` The reason that we stopped. @@ -14281,6 +14305,30 @@ console.log(messageTokensCount.input_tokens); - `"assistant"` + - `stop_details: RefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: StopReason | null` The reason that we stopped. @@ -18790,6 +18838,30 @@ console.log(messageTokensCount.input_tokens); The time at which the container will expire. + - `stop_details: RefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: StopReason | null` - `"end_turn"` @@ -19637,6 +19709,30 @@ console.log(messageTokensCount.input_tokens); - `"assistant"` + - `stop_details: RefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: StopReason | null` The reason that we stopped. @@ -20545,6 +20641,30 @@ console.log(messageTokensCount.input_tokens); - `"assistant"` + - `stop_details: RefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: StopReason | null` The reason that we stopped. @@ -20672,6 +20792,30 @@ console.log(messageTokensCount.input_tokens); The time at which the container will expire. + - `stop_details: RefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: StopReason | null` - `"end_turn"` @@ -21570,6 +21714,32 @@ console.log(messageTokensCount.input_tokens); - `"redacted_thinking"` +### Refusal Stop Details + +- `RefusalStopDetails` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + ### Search Result Block Param - `SearchResultBlockParam` @@ -32361,6 +32531,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"assistant"` + - `stop_details: RefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: StopReason | null` The reason that we stopped. @@ -33603,6 +33797,30 @@ console.log(messageBatchIndividualResponse.custom_id); - `"assistant"` + - `stop_details: RefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: StopReason | null` The reason that we stopped. @@ -34639,6 +34857,30 @@ console.log(messageBatchIndividualResponse.custom_id); - `"assistant"` + - `stop_details: RefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: StopReason | null` The reason that we stopped. @@ -35637,6 +35879,30 @@ console.log(messageBatchIndividualResponse.custom_id); - `"assistant"` + - `stop_details: RefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: StopReason | null` The reason that we stopped. diff --git a/content/en/api/typescript/messages/batches.md b/content/en/api/typescript/messages/batches.md index cc7b4752e..2b8ac9e1f 100644 --- a/content/en/api/typescript/messages/batches.md +++ b/content/en/api/typescript/messages/batches.md @@ -5192,6 +5192,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"assistant"` + - `stop_details: RefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: StopReason | null` The reason that we stopped. @@ -6434,6 +6458,30 @@ console.log(messageBatchIndividualResponse.custom_id); - `"assistant"` + - `stop_details: RefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: StopReason | null` The reason that we stopped. @@ -7470,6 +7518,30 @@ console.log(messageBatchIndividualResponse.custom_id); - `"assistant"` + - `stop_details: RefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: StopReason | null` The reason that we stopped. @@ -8468,6 +8540,30 @@ console.log(messageBatchIndividualResponse.custom_id); - `"assistant"` + - `stop_details: RefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: StopReason | null` The reason that we stopped. diff --git a/content/en/api/typescript/messages/batches/results.md b/content/en/api/typescript/messages/batches/results.md index e987c8d0a..191117e46 100644 --- a/content/en/api/typescript/messages/batches/results.md +++ b/content/en/api/typescript/messages/batches/results.md @@ -819,6 +819,30 @@ Learn more about the Message Batches API in our [user guide](https://docs.claude - `"assistant"` + - `stop_details: RefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: StopReason | null` The reason that we stopped. diff --git a/content/en/api/typescript/messages/create.md b/content/en/api/typescript/messages/create.md index 1ba4b8dda..76b1255d7 100644 --- a/content/en/api/typescript/messages/create.md +++ b/content/en/api/typescript/messages/create.md @@ -4624,6 +4624,30 @@ Learn more about the Messages API in our [user guide](https://docs.claude.com/en - `"assistant"` + - `stop_details: RefusalStopDetails | null` + + Structured information about a refusal. + + - `category: "cyber" | "bio" | null` + + The policy category that triggered the refusal. + + `null` when the refusal doesn't map to a named category. + + - `"cyber"` + + - `"bio"` + + - `explanation: string | null` + + Human-readable explanation of the refusal. + + This text is not guaranteed to be stable. `null` when no explanation is available for the category. + + - `type: "refusal"` + + - `"refusal"` + - `stop_reason: StopReason | null` The reason that we stopped. diff --git a/content/en/api/typescript/models.md b/content/en/api/typescript/models.md index a9cb948e9..6158278c5 100644 --- a/content/en/api/typescript/models.md +++ b/content/en/api/typescript/models.md @@ -34,7 +34,7 @@ The Models API response can be used to determine which models are available for - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -76,6 +76,10 @@ The Models API response can be used to determine which models are available for - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `ModelInfo` @@ -299,7 +303,7 @@ The Models API response can be used to determine information about a specific mo - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -341,6 +345,10 @@ The Models API response can be used to determine information about a specific mo - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `ModelInfo` diff --git a/content/en/api/typescript/models/list.md b/content/en/api/typescript/models/list.md index f3d55520f..c2a0455fb 100644 --- a/content/en/api/typescript/models/list.md +++ b/content/en/api/typescript/models/list.md @@ -32,7 +32,7 @@ The Models API response can be used to determine which models are available for - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -74,6 +74,10 @@ The Models API response can be used to determine which models are available for - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `ModelInfo` diff --git a/content/en/api/typescript/models/retrieve.md b/content/en/api/typescript/models/retrieve.md index a6f058402..505aba597 100644 --- a/content/en/api/typescript/models/retrieve.md +++ b/content/en/api/typescript/models/retrieve.md @@ -22,7 +22,7 @@ The Models API response can be used to determine information about a specific mo - `(string & {})` - - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 17 more` + - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 19 more` - `"message-batches-2024-09-24"` @@ -64,6 +64,10 @@ The Models API response can be used to determine information about a specific mo - `"fast-mode-2026-02-01"` + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + ### Returns - `ModelInfo` diff --git a/content/en/build-with-claude/adaptive-thinking.md b/content/en/build-with-claude/adaptive-thinking.md index d62a260cd..cef064344 100644 --- a/content/en/build-with-claude/adaptive-thinking.md +++ b/content/en/build-with-claude/adaptive-thinking.md @@ -8,7 +8,7 @@ Let Claude dynamically determine when and how much to use extended thinking with This feature is eligible for [Zero Data Retention (ZDR)](/docs/en/build-with-claude/api-and-data-retention). When your organization has a ZDR arrangement, data sent through this feature is not stored after the API response is returned.
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  -Adaptive thinking is the recommended way to use [extended thinking](/docs/en/build-with-claude/extended-thinking) with Claude Opus 4.6 and Sonnet 4.6. Instead of manually setting a thinking token budget, adaptive thinking lets Claude dynamically determine when and how much to use extended thinking based on the complexity of each request. +Adaptive thinking is the recommended way to use [extended thinking](/docs/en/build-with-claude/extended-thinking) with Claude Opus 4.6 and Claude Sonnet 4.6, and is the default mode on [Claude Mythos Preview](https://anthropic.com/glasswing) (where it auto-applies whenever `thinking` is unset). Instead of manually setting a thinking token budget, adaptive thinking lets Claude dynamically determine when and how much to use extended thinking based on the complexity of each request. Adaptive thinking can drive better performance than extended thinking with a fixed `budget_tokens` for many workloads, especially bimodal tasks and long-horizon agentic workflows. No beta header is required. @@ -20,6 +20,7 @@ If your workload requires predictable latency or precise control over thinking c Adaptive thinking is supported on the following models: +- Claude Mythos Preview (`claude-mythos-preview`), adaptive thinking is the default; `thinking: {type: "disabled"}` is not supported - Claude Opus 4.6 (`claude-opus-4-6`) - Claude Sonnet 4.6 (`claude-sonnet-4-6`) @@ -731,15 +732,15 @@ end | Mode | Config | Availability | When to use | |:-----|:-------|:-------------|:------------| -| **Adaptive** | `thinking: {type: "adaptive"}` | Opus 4.6, Sonnet 4.6 | Claude determines when and how much to use extended thinking. Use `effort` to guide. | +| **Adaptive** | `thinking: {type: "adaptive"}` | Claude Mythos Preview (default), Opus 4.6, Sonnet 4.6 | Claude determines when and how much to use extended thinking. Use `effort` to guide. | | **Manual** | `thinking: {type: "enabled", budget_tokens: N}` | All models. Deprecated on Opus 4.6 and Sonnet 4.6 (consider adaptive mode instead). | When you need precise control over thinking token spend. | -| **Disabled** | Omit `thinking` parameter or pass `{type: "disabled"}` | All models | When you don't need extended thinking and want the lowest latency. | +| **Disabled** | Omit `thinking` parameter or pass `{type: "disabled"}` | All models except Claude Mythos Preview | When you don't need extended thinking and want the lowest latency. | -Adaptive thinking is available on Opus 4.6 and Sonnet 4.6. Older models only support `type: "enabled"` with `budget_tokens`. On both Opus 4.6 and Sonnet 4.6, `type: "enabled"` with `budget_tokens` is still functional but deprecated. +Adaptive thinking is available on Claude Mythos Preview, Opus 4.6, and Sonnet 4.6. On Mythos Preview, adaptive thinking is the default and applies automatically whenever `thinking` is unset. Older models only support `type: "enabled"` with `budget_tokens`. On Opus 4.6 and Sonnet 4.6, `type: "enabled"` with `budget_tokens` is still functional but deprecated. **Interleaved thinking availability by mode:** -- **Adaptive mode:** Interleaved thinking is automatically enabled on both Opus 4.6 and Sonnet 4.6. +- **Adaptive mode:** Interleaved thinking is automatically enabled on Claude Mythos Preview, Opus 4.6, and Sonnet 4.6. On Mythos Preview, inter-tool reasoning always lives inside thinking blocks. - **Manual mode on Sonnet 4.6:** Interleaved thinking works via the `interleaved-thinking-2025-05-14` beta header. - **Manual mode on Opus 4.6:** Interleaved thinking is not available. If your agentic workflow requires thinking between tool calls on Opus 4.6, use adaptive mode. @@ -780,13 +781,13 @@ The following concepts apply to all models that support extended thinking, regar ### Summarized thinking -With extended thinking enabled, the Messages API for Claude 4 models returns a summary of Claude's full thinking process. Summarized thinking provides the full intelligence benefits of extended thinking, while preventing misuse. This is the default behavior when the `display` field on the thinking configuration is unset or set to `"summarized"`. +With extended thinking enabled, the Messages API for Claude 4 models returns a summary of Claude's full thinking process. Summarized thinking provides the full intelligence benefits of extended thinking, while preventing misuse. This is the default behavior on Claude 4 models when the `display` field on the thinking configuration is unset or set to `"summarized"`. On [Claude Mythos Preview](https://anthropic.com/glasswing), `display` defaults to `"omitted"` instead, so you must set `display: "summarized"` explicitly to receive summarized thinking. Here are some important considerations for summarized thinking: - You're charged for the full thinking tokens generated by the original request, not the summary tokens. - The billed output token count will **not match** the count of tokens you see in the response. -- The first few lines of thinking output are more verbose, providing detailed reasoning that's particularly helpful for prompt engineering purposes. +- On Claude 4 models, the first few lines of thinking output are more verbose, providing detailed reasoning that's particularly helpful for prompt engineering purposes. [Claude Mythos Preview](https://anthropic.com/glasswing) summarizes from the first token, so its thinking blocks do not show this verbose preamble. - As Anthropic seeks to improve the extended thinking feature, summarization behavior is subject to change. - Summarization preserves the key ideas of Claude's thinking process with minimal added latency, enabling a streamable user experience and easy migration from Claude Sonnet 3.7 to Claude 4 and later models. - Summarization is processed by a different model than the one you target in your requests. The thinking model does not see the summarized output. @@ -801,8 +802,8 @@ In rare cases where you need access to full thinking output for Claude 4 models, The `display` field on the thinking configuration controls how thinking content is returned in API responses. It accepts two values: -- `"summarized"` (default): Thinking blocks contain summarized thinking text. See [Summarized thinking](#summarized-thinking) for details. -- `"omitted"`: Thinking blocks are returned with an empty `thinking` field. The `signature` field still carries the encrypted full thinking for multi-turn continuity (see [Thinking encryption](#thinking-encryption)). +- `"summarized"`: Thinking blocks contain summarized thinking text. See [Summarized thinking](#summarized-thinking) for details. This is the default on Claude 4 models. +- `"omitted"`: Thinking blocks are returned with an empty `thinking` field. The `signature` field still carries the encrypted full thinking for multi-turn continuity (see [Thinking encryption](#thinking-encryption)). This is the default on [Claude Mythos Preview](https://anthropic.com/glasswing). Setting `display: "omitted"` is useful when your application doesn't surface thinking content to users. The primary benefit is **faster time-to-first-text-token when streaming:** The server skips streaming thinking tokens entirely and delivers only the signature, so the final text response begins streaming sooner. diff --git a/content/en/build-with-claude/api-and-data-retention.md b/content/en/build-with-claude/api-and-data-retention.md index f7adbcf5e..699f03e06 100644 --- a/content/en/build-with-claude/api-and-data-retention.md +++ b/content/en/build-with-claude/api-and-data-retention.md @@ -160,7 +160,7 @@ The following table lists which Claude API features are eligible for ZDR and HIP | [Agent skills](/docs/en/agents-and-tools/agent-skills/overview) | `/v1/messages` (with `skills`) / `/v1/skills` | No | No | Skill data retained per standard policy. See [Agent skills](/docs/en/agents-and-tools/agent-skills/overview#data-retention). | | [MCP connector](/docs/en/agents-and-tools/mcp-connector) | `/v1/messages` (with `mcp_servers`) | No | No | Data retained per standard policy. See [MCP connector](/docs/en/agents-and-tools/mcp-connector#data-retention). | -1 [Dynamic filtering](/docs/en/agents-and-tools/tool-use/web-search-tool#dynamic-filtering-with-opus-4-6-and-sonnet-4-6) is not eligible for ZDR or HIPAA. +1 [Dynamic filtering](/docs/en/agents-and-tools/tool-use/web-search-tool#dynamic-filtering) is not eligible for ZDR or HIPAA. 2 While web fetch is ZDR-eligible, website publishers may retain request data (such as fetched URLs and request metadata) according to their own policies. diff --git a/content/en/build-with-claude/claude-in-amazon-bedrock.md b/content/en/build-with-claude/claude-in-amazon-bedrock.md new file mode 100644 index 000000000..784f5af7f --- /dev/null +++ b/content/en/build-with-claude/claude-in-amazon-bedrock.md @@ -0,0 +1,344 @@ +# Claude in Amazon Bedrock + +Access Claude models through Amazon Bedrock with AWS-native authentication, billing, and security boundaries. + +--- + +This guide walks you through setting up and making API calls to Claude in Amazon Bedrock. Claude in Amazon Bedrock runs on AWS-managed infrastructure with zero operator access (Anthropic personnel have no access to the inference infrastructure), letting you build sensitive applications entirely inside the AWS security boundary while using the same Messages API shape you use with Anthropic's first-party API. + + +This page covers the new Claude in Amazon Bedrock offering, which exposes the Messages API at `/anthropic/v1/messages`. For the legacy Bedrock integration (the `InvokeModel` API with ARN-versioned model identifiers and AWS event-stream encoding), see [Claude on Amazon Bedrock](/docs/en/build-with-claude/claude-on-amazon-bedrock). + + +## Research preview + +Claude in Amazon Bedrock is in research preview, available in the US East (N. Virginia) `us-east-1` region at launch. Contact your Anthropic account executive to request access. + +## Prerequisites + +Before you begin, ensure you have: + +- A **new AWS account** in `us-east-1`. The research preview requires a dedicated account for isolation. Your Anthropic account executive will submit your account ID to the Bedrock Marketplace team for allowlisting (typically processed within 24 hours). +- The [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) installed and configured (optional, for credential management) +- After allowlisting, AWS sends a welcome email with your model ID and additional setup details. + +## Authentication + +Claude in Amazon Bedrock supports three authentication paths. Choose the one that best fits your security requirements. + +### Bedrock service role (recommended) + +Use a Bedrock service role with AWS-managed keys for the most secure, long-lived access: + + + +An AWS administrator provisions a Bedrock service role and grants developers `iam:PassRole` permission on the service role ARN. + + +When calling the API, pass the service role ARN as a request parameter. Bedrock assumes the role on your behalf and signs requests with AWS-managed credentials. A code example showing where the ARN parameter goes will be added when the SDK packages publish. + + + +### IAM assumed roles + +For identity-federated access with a 12-hour maximum session: + + + +Create an IAM role scoped to your Claude models. The trust policy names your identity provider (SAML, OIDC, or AWS Identity Center). The permissions policy grants `bedrock-mantle:CreateInference` only on the allowed model ARNs. + + +Authenticate through your corporate identity provider, then assume the IAM role. AWS STS issues temporary credentials that the SDK or CLI uses to sign requests. + + + +### Bearer tokens + +For short-term access without IAM roles (12-hour maximum, least preferred): + + + +Block long-term keys by attaching a policy that denies `bedrock:CallWithBearerToken` unless the `bedrock:BearerTokenType` condition matches a short-term token. + + +Use the `aws-bedrock-token-generator` CLI (link pending publication) to mint a bearer token. Pass it in the `x-api-key` header on each request. + + + +## Install an SDK + +Anthropic's [client SDKs](/docs/en/api/client-sdks) support Claude in Amazon Bedrock through a Bedrock-specific package or module. + + + +```bash +pip install -U "anthropic[bedrock]" +``` + + + +```bash +npm install @anthropic-ai/bedrock-sdk +``` + + + +```bash +dotnet add package Anthropic.Bedrock +``` + + + +```bash +go get github.com/anthropics/anthropic-sdk-go/bedrock +``` + + + + + +```kotlin +implementation("com.anthropic:anthropic-java-bedrock:2.18.0") +``` + + +```xml + + com.anthropic + anthropic-java-bedrock + 2.18.0 + +``` + + + + + +```bash +composer require anthropic-ai/sdk aws/aws-sdk-php +``` + + + +```bash +# Gemfile +gem "anthropic" +gem "aws-sigv4" +``` + + + +## Making your first request + +The endpoint follows the pattern `https://bedrock-mantle.{region}.api.aws/anthropic/v1/messages`. Unlike the legacy Bedrock integration, this endpoint uses standard SSE streaming and the same request body shape as Anthropic's first-party API. + +The SDK resolves credentials and region using the standard AWS precedence: constructor arguments, then environment variables (`AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_SESSION_TOKEN`, `AWS_REGION`), then the AWS config file and credential chain (SSO, assumed roles, ECS task role, IMDS). + + + +```bash Shell nocheck +curl https://bedrock-mantle.us-east-1.api.aws/anthropic/v1/messages \ + --aws-sigv4 "aws:amz:us-east-1:bedrock-mantle" \ + --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \ + -H "x-amz-security-token: $AWS_SESSION_TOKEN" \ + -H "content-type: application/json" \ + -H "anthropic-version: 2023-06-01" \ + -d '{ + "model": "CLAUDE_MODEL_ID", + "max_tokens": 1024, + "messages": [ + {"role": "user", "content": "Hello, Claude"} + ] + }' +``` + +```python Python nocheck +from anthropic import AnthropicBedrockMantle + +client = AnthropicBedrockMantle(aws_region="us-east-1") + +message = client.messages.create( + model="CLAUDE_MODEL_ID", + max_tokens=1024, + messages=[{"role": "user", "content": "Hello, Claude"}], +) + +print(message.content[0].text) +``` + +```typescript TypeScript nocheck +import AnthropicBedrockMantle from "@anthropic-ai/bedrock-sdk"; + +const client = new AnthropicBedrockMantle({ + awsRegion: "us-east-1", +}); + +const message = await client.messages.create({ + model: "CLAUDE_MODEL_ID", + max_tokens: 1024, + messages: [{ role: "user", content: "Hello, Claude" }], +}); + +const block = message.content[0]; +if (block.type === "text") { + console.log(block.text); +} +``` + +```csharp C# nocheck +using Anthropic.Bedrock; +using Anthropic.Models.Messages; + +var client = new AnthropicBedrockMantleClient(region: "us-east-1"); + +var message = await client.Messages.Create(new() +{ + Model = "CLAUDE_MODEL_ID", + MaxTokens = 1024, + Messages = [new() { Role = Role.User, Content = "Hello, Claude" }], +}); + +if (message.Content[0].Value is TextBlock block) + Console.WriteLine(block.Text); +``` + +```go Go nocheck hidelines={1..2,11..12,-1} +package main + +import ( + "context" + "fmt" + + "github.com/anthropics/anthropic-sdk-go" + "github.com/anthropics/anthropic-sdk-go/bedrock" + "github.com/aws/aws-sdk-go-v2/config" +) + +func main() { + client := anthropic.NewClient( + bedrock.WithLoadDefaultConfig(context.Background(), config.WithRegion("us-east-1")), + ) + + message, err := client.Messages.New(context.Background(), anthropic.MessageNewParams{ + Model: "CLAUDE_MODEL_ID", + MaxTokens: 1024, + Messages: []anthropic.MessageParam{ + anthropic.NewUserMessage(anthropic.NewTextBlock("Hello, Claude")), + }, + }) + if err != nil { + panic(err) + } + + fmt.Println(message.Content[0].Text) +} +``` + +```java Java nocheck hidelines={6..7,-1} +import com.anthropic.bedrock.backends.BedrockMantleBackend; +import com.anthropic.client.AnthropicClient; +import com.anthropic.client.okhttp.AnthropicOkHttpClient; +import com.anthropic.models.messages.Message; +import com.anthropic.models.messages.MessageCreateParams; + +void main() { + AnthropicClient client = AnthropicOkHttpClient.builder() + .backend(BedrockMantleBackend.fromEnv()) + .build(); + + Message message = client.messages().create( + MessageCreateParams.builder() + .model("CLAUDE_MODEL_ID") + .maxTokens(1024) + .addUserMessage("Hello, Claude") + .build() + ); + + IO.println(message.content().getFirst().asText().text()); +} +``` + +```php PHP nocheck hidelines={1..2} +messages->create( + model: 'CLAUDE_MODEL_ID', + maxTokens: 1024, + messages: [ + ['role' => 'user', 'content' => 'Hello, Claude'], + ], +); + +echo $message->content[0]->text; +``` + +```ruby Ruby nocheck +require "anthropic" + +client = Anthropic::BedrockMantleClient.new(aws_region: "us-east-1") + +message = client.messages.create( + model: "CLAUDE_MODEL_ID", + max_tokens: 1024, + messages: [{role: "user", content: "Hello, Claude"}] +) + +puts message.content[0].text +``` + + + + +If the dedicated `AnthropicBedrockMantle` client is not yet available in your language's SDK release, you can use the standard `Anthropic` client instead: set `base_url` to `https://bedrock-mantle.{region}.api.aws/anthropic` and pass your bearer token as `api_key`. This path supports bearer-token authentication only. SigV4 signing requires the dedicated client. + + +## Supported models + +Model IDs in Claude in Amazon Bedrock carry an `anthropic.` provider prefix. Model capabilities and behaviors are documented on the [Models overview](/docs/en/about-claude/models/overview) page. See your AWS welcome email for the exact model ID enabled for your account. + +## Feature availability + +Claude in Amazon Bedrock supports features that run inside the model. Features that require Anthropic-operated infrastructure are not available. + +**Supported:** + +- Messages API (`/v1/messages`) +- Prompt caching +- Extended thinking +- Tool use (client-defined tools) +- Citations +- Structured outputs +- In-region inference (requests stay in a single AWS region) + +**Not supported:** + +- Anthropic-defined tools (Web Search, Web Fetch, Remote MCP, Memory, Files API, Computer Use, Skills, Code Execution) +- Agent API +- Message Batches API +- `/v1/users` endpoint + +## Regions + +The research preview is available in `us-east-1` (IAD) only. + +## Quotas + +Default quota is 2 million input tokens per minute (TPM). You can request up to 4 million input TPM without additional Anthropic approval. AWS enforces requests-per-minute (RPM) limits on the Bedrock side; contact AWS support for RPM adjustments. + +## Data retention + +All inference data is retained for 30 days in your AWS storage. There is no zero-data-retention opt-out on this offering. For standard customers, Anthropic can inspect stored data for safety and abuse review. For Select-tier customers, only AWS can inspect data; Anthropic can run automated operations but not manual review. For details on Select-tier eligibility, contact your Anthropic account executive. + +If your application requires zero data retention (ZDR), consider Claude Platform on AWS, where ZDR is available by contacting sales. + +## Observability + +Claude in Amazon Bedrock emits logs to both CloudWatch and CloudTrail. Anthropic recommends retaining activity logs on at least a 30-day rolling basis to understand usage patterns and investigate potential issues. + +## Support + +For research preview support, contact **bedrock-ant-eap@amazon.com**. Include your AWS account ID and the `request-id` from any failed API responses. \ No newline at end of file diff --git a/content/en/build-with-claude/claude-in-microsoft-foundry.md b/content/en/build-with-claude/claude-in-microsoft-foundry.md index 2f7511e37..3f27eb143 100644 --- a/content/en/build-with-claude/claude-in-microsoft-foundry.md +++ b/content/en/build-with-claude/claude-in-microsoft-foundry.md @@ -471,7 +471,7 @@ Claude on Foundry supports most of Claude's powerful features. You can find all ### Context window -Claude Opus 4.6 and Sonnet 4.6 have a [1M-token context window](/docs/en/build-with-claude/context-windows) on Microsoft Foundry. Other Claude models, including Sonnet 4.5, have a 200k-token context window. +Claude Opus 4.6 and Claude Sonnet 4.6 have a [1M-token context window](/docs/en/build-with-claude/context-windows) on Microsoft Foundry. Other Claude models, including Sonnet 4.5, have a 200k-token context window. ### Features not supported @@ -549,6 +549,10 @@ Foundry does not include Anthropic's standard rate limit headers (`anthropic-rat - **Solution:** The model parameter should contain your deployment name, which can be customized in the Foundry portal. Verify the deployment exists and is properly configured. + +[Claude Mythos Preview](https://anthropic.com/glasswing) is a research preview available to invited customers on Microsoft Foundry. For more information, see [Project Glasswing](https://anthropic.com/glasswing). + + ## Additional resources - **Foundry documentation:** [ai.azure.com/catalog](https://ai.azure.com/catalog/publishers/anthropic) diff --git a/content/en/build-with-claude/claude-on-amazon-bedrock.md b/content/en/build-with-claude/claude-on-amazon-bedrock.md index 90f9233d1..10b14a741 100644 --- a/content/en/build-with-claude/claude-on-amazon-bedrock.md +++ b/content/en/build-with-claude/claude-on-amazon-bedrock.md @@ -4,6 +4,10 @@ Anthropic's Claude models are now generally available through Amazon Bedrock. --- + +This page covers the legacy Amazon Bedrock integration (the `InvokeModel` API with ARN-versioned model identifiers and AWS event-stream encoding). For the new AWS-managed offering with the Messages API at `/anthropic/v1/messages` and SSE streaming, see [Claude in Amazon Bedrock](/docs/en/build-with-claude/claude-in-amazon-bedrock). + + Calling Claude through Bedrock slightly differs from how you would call Claude when using Anthropic's client SDKs. This guide walks you through completing an API call to Claude on Bedrock using one of Anthropic's [client SDKs](/docs/en/api/client-sdks). Note that this guide assumes you have already signed up for an [AWS account](https://portal.aws.amazon.com/billing/signup) and configured programmatic access. @@ -640,7 +644,7 @@ For more details on the two document processing modes and their limitations, ref ### Context window -Claude Opus 4.6 and Sonnet 4.6 have a [1M-token context window](/docs/en/build-with-claude/context-windows) on Amazon Bedrock. Other Claude models, including Sonnet 4.5 and Sonnet 4, have a 200k-token context window. +Claude Opus 4.6 and Claude Sonnet 4.6 have a [1M-token context window](/docs/en/build-with-claude/context-windows) on Amazon Bedrock. Other Claude models, including Sonnet 4.5 and Sonnet 4, have a 200k-token context window. Amazon Bedrock limits request payloads to 20 MB. When sending large documents or many images, you may reach this limit before the token limit. @@ -936,6 +940,10 @@ message = client.messages.create( ``` + +**Claude Mythos Preview** is a research preview model available to invited customers on Amazon Bedrock. For more information, see [Project Glasswing](https://anthropic.com/glasswing). + + ### Additional resources - **AWS Bedrock pricing:** [aws.amazon.com/bedrock/pricing](https://aws.amazon.com/bedrock/pricing/) diff --git a/content/en/build-with-claude/claude-on-vertex-ai.md b/content/en/build-with-claude/claude-on-vertex-ai.md index 51bebb005..c50f7d768 100644 --- a/content/en/build-with-claude/claude-on-vertex-ai.md +++ b/content/en/build-with-claude/claude-on-vertex-ai.md @@ -333,7 +333,7 @@ The following examples show how to generate text from Claude on Vertex AI: See the [client SDKs](/docs/en/api/client-sdks) and the official [Vertex AI docs](https://cloud.google.com/vertex-ai/docs) for more details. -Claude is also available through [Amazon Bedrock](/docs/en/build-with-claude/claude-on-amazon-bedrock) and [Microsoft Foundry](/docs/en/build-with-claude/claude-in-microsoft-foundry). +Claude is also available through [Amazon Bedrock](/docs/en/build-with-claude/claude-in-amazon-bedrock) and [Microsoft Foundry](/docs/en/build-with-claude/claude-in-microsoft-foundry). ## Activity logging @@ -350,18 +350,19 @@ For all currently supported features on Vertex AI, see [API features overview](/ ### Context window -Claude Opus 4.6 and Sonnet 4.6 have a [1M-token context window](/docs/en/build-with-claude/context-windows) on Vertex AI. Other Claude models, including Sonnet 4.5 and Sonnet 4, have a 200k-token context window. +Claude Opus 4.6 and Claude Sonnet 4.6 have a [1M-token context window](/docs/en/build-with-claude/context-windows) on Vertex AI. Other Claude models, including Sonnet 4.5 and Sonnet 4, have a 200k-token context window. Vertex AI limits request payloads to 30 MB. When sending large documents or many images, you may reach this limit before the token limit. -## Global vs regional endpoints +## Global, multi-region, and regional endpoints -Starting with **Claude Sonnet 4.5 and all future models**, Google Vertex AI offers two endpoint types: +Google Vertex AI offers three endpoint types: - **Global endpoints:** Dynamic routing for maximum availability +- **Multi-region endpoints:** Dynamic routing within a geographic area (for example, the United States) for data residency with high availability - **Regional endpoints:** Guaranteed data routing through specific geographic regions -Regional endpoints include a 10% pricing premium over global endpoints. +Regional and multi-region endpoints include a 10% pricing premium over global endpoints. This applies to Claude Sonnet 4.5 and future models only. Older models (Claude Sonnet 4, Opus 4, and earlier) maintain their existing pricing structures. @@ -376,9 +377,15 @@ This applies to Claude Sonnet 4.5 and future models only. Older models (Claude S - Best for applications where data residency is flexible - Only supports pay-as-you-go traffic (provisioned throughput requires regional endpoints) +**Multi-region endpoints:** +- Dynamically route requests across regions within a geographic area (currently `us`, with `eu` coming soon) +- Useful when you need data residency within a broad geography but want higher availability than a single region +- 10% pricing premium over global endpoints +- Only supports pay-as-you-go traffic (provisioned throughput requires regional endpoints) + **Regional endpoints:** - Route traffic through specific geographic regions -- Required for data residency and compliance requirements +- Required for single-region data residency, strict compliance mandates, or provisioned throughput - Support both pay-as-you-go and provisioned throughput - 10% pricing premium reflects infrastructure costs for dedicated regional capacity @@ -546,6 +553,172 @@ puts message.content.first.text ``` +**Using multi-region endpoints:** + +Set the `region` parameter to a multi-region identifier such as `"us"`. The SDK routes requests to the multi-region endpoint (for example, `https://aiplatform.us.rep.googleapis.com`), which dynamically balances traffic across regions within that geography. + + + +```python Python nocheck +from anthropic import AnthropicVertex + +project_id = "MY_PROJECT_ID" +region = "us" # Multi-region: routes within US regions + +client = AnthropicVertex(project_id=project_id, region=region) + +message = client.messages.create( + model="claude-opus-4-6", + max_tokens=100, + messages=[ + { + "role": "user", + "content": "Hey Claude!", + } + ], +) +print(message) +``` + +```typescript TypeScript nocheck +import { AnthropicVertex } from "@anthropic-ai/vertex-sdk"; + +const projectId = "MY_PROJECT_ID"; +const region = "us"; // Multi-region: routes within US regions + +const client = new AnthropicVertex({ + projectId, + region +}); + +const result = await client.messages.create({ + model: "claude-opus-4-6", + max_tokens: 100, + messages: [ + { + role: "user", + content: "Hey Claude!" + } + ] +}); +``` + +```csharp C# nocheck +using Anthropic; +using Anthropic.Models.Messages; +using Anthropic.Vertex; + +var projectId = "MY_PROJECT_ID"; +var region = "us"; // Multi-region: routes within US regions + +var client = new AnthropicClient +{ + Backend = new VertexBackend(projectId, region) +}; + +var parameters = new MessageCreateParams +{ + Model = Model.ClaudeOpus4_6, + MaxTokens = 100, + Messages = [new() { Role = Role.User, Content = "Hey Claude!" }] +}; + +var message = await client.Messages.Create(parameters); +Console.WriteLine(message); +``` + +```go Go nocheck hidelines={1..2,9..10,-1} +package main + +import ( + "context" + + "github.com/anthropics/anthropic-sdk-go" + "github.com/anthropics/anthropic-sdk-go/vertex" +) + +func main() { + // Multi-region: routes within US regions + client := anthropic.NewClient( + vertex.WithGoogleAuth(context.Background(), "us", "MY_PROJECT_ID"), + ) + + message, _ := client.Messages.New(context.Background(), anthropic.MessageNewParams{ + Model: "claude-opus-4-6", + MaxTokens: 100, + Messages: []anthropic.MessageParam{ + anthropic.NewUserMessage(anthropic.NewTextBlock("Hey Claude!")), + }, + }) + _ = message +} +``` + +```java Java nocheck +import com.anthropic.client.AnthropicClient; +import com.anthropic.client.okhttp.AnthropicOkHttpClient; +import com.anthropic.models.messages.MessageCreateParams; +import com.anthropic.vertex.backends.VertexBackend; + +// Multi-region: routes within US regions +AnthropicClient client = AnthropicOkHttpClient.builder() + .backend( + VertexBackend.builder() + .region("us") + .project("MY_PROJECT_ID") + .build() + ) + .build(); + +var message = client + .messages() + .create( + MessageCreateParams.builder() + .model("claude-opus-4-6") + .maxTokens(100) + .addUserMessage("Hey Claude!") + .build() + ); +``` + +```php PHP nocheck +messages->create( + maxTokens: 100, + messages: [ + ['role' => 'user', 'content' => 'Hey Claude!'] + ], + model: 'claude-opus-4-6', +); +echo $message->content[0]->text; +``` + +```ruby Ruby nocheck +require "anthropic" + +client = Anthropic::VertexClient.new( + region: "us", # Multi-region: routes within US regions + project_id: "MY_PROJECT_ID" +) + +message = client.messages.create( + model: "claude-opus-4-6", + max_tokens: 100, + messages: [{role: "user", content: "Hey Claude!"}] +) + +puts message.content.first.text +``` + + **Using regional endpoints:** Specify a specific region like `"us-east1"` or `"europe-west1"`: @@ -712,6 +885,10 @@ puts message.content.first.text ``` + +Claude Mythos Preview is a research preview available to invited customers on Google Vertex AI. For more information, see [Project Glasswing](https://anthropic.com/glasswing). + + ### Additional resources - **Google Vertex AI pricing:** [cloud.google.com/vertex-ai/generative-ai/pricing](https://cloud.google.com/vertex-ai/generative-ai/pricing) diff --git a/content/en/build-with-claude/compaction.md b/content/en/build-with-claude/compaction.md index 04b8a4e5c..ae17ef859 100644 --- a/content/en/build-with-claude/compaction.md +++ b/content/en/build-with-claude/compaction.md @@ -32,6 +32,7 @@ Compaction is in beta. Include the [beta header](/docs/en/api/beta-headers) `com Compaction is supported on the following models: +- [Claude Mythos Preview](https://anthropic.com/glasswing) (`claude-mythos-preview`) - Claude Opus 4.6 (`claude-opus-4-6`) - Claude Sonnet 4.6 (`claude-sonnet-4-6`) diff --git a/content/en/build-with-claude/context-editing.md b/content/en/build-with-claude/context-editing.md index de83fb8df..d5e94e2ea 100644 --- a/content/en/build-with-claude/context-editing.md +++ b/content/en/build-with-claude/context-editing.md @@ -65,16 +65,7 @@ Context editing's interaction with [prompt caching](/docs/en/build-with-claude/p ## Supported models -Context editing is available on: - -- Claude Opus 4.6 (`claude-opus-4-6`) -- Claude Opus 4.5 (`claude-opus-4-5-20251101`) -- Claude Opus 4.1 (`claude-opus-4-1-20250805`) -- Claude Opus 4 (`claude-opus-4-20250514`) -- Claude Sonnet 4.6 (`claude-sonnet-4-6`) -- Claude Sonnet 4.5 (`claude-sonnet-4-5-20250929`) -- Claude Sonnet 4 (`claude-sonnet-4-20250514`) -- Claude Haiku 4.5 (`claude-haiku-4-5-20251001`) +Context editing is available on all supported Claude models. ## Tool result clearing usage diff --git a/content/en/build-with-claude/context-windows.md b/content/en/build-with-claude/context-windows.md index d76b7d2ff..aa25c1910 100644 --- a/content/en/build-with-claude/context-windows.md +++ b/content/en/build-with-claude/context-windows.md @@ -95,7 +95,7 @@ Claude Sonnet 3.7 does not support interleaved thinking, so there is no interlea For more information about using tools with extended thinking, see the [extended thinking guide](/docs/en/build-with-claude/extended-thinking#extended-thinking-with-tool-use). -Claude Opus 4.6 and Sonnet 4.6 have a 1M-token context window. Other Claude models, including Claude Sonnet 4.5 and Sonnet 4, have a 200k-token context window. +[Claude Mythos Preview](https://anthropic.com/glasswing), Claude Opus 4.6, and Claude Sonnet 4.6 have a 1M-token context window. Other Claude models, including Claude Sonnet 4.5 and Sonnet 4, have a 200k-token context window. A single request can include up to 600 images or PDF pages (100 for models with a 200k-token context window). When sending many images or large documents, you may approach [request size limits](/docs/en/api/overview#request-size-limits) before the token limit. diff --git a/content/en/build-with-claude/effort.md b/content/en/build-with-claude/effort.md index 02a15e137..5f8f99562 100644 --- a/content/en/build-with-claude/effort.md +++ b/content/en/build-with-claude/effort.md @@ -11,7 +11,7 @@ This feature is eligible for [Zero Data Retention (ZDR)](/docs/en/build-with-cla The effort parameter allows you to control how eager Claude is about spending tokens when responding to requests. This gives you the ability to trade off between response thoroughness and token efficiency, all with a single model. The effort parameter is generally available on all supported models with no beta header required. - The effort parameter is supported by Claude Opus 4.6, Claude Sonnet 4.6, and Claude Opus 4.5. + The effort parameter is supported by [Claude Mythos Preview](https://anthropic.com/glasswing), Claude Opus 4.6, Claude Sonnet 4.6, and Claude Opus 4.5. @@ -41,7 +41,7 @@ This approach has two major advantages: | Level | Description | Typical use case | | -------- | -------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | -| `max` | Absolute maximum capability with no constraints on token spending. Available on Claude Opus 4.6 and Claude Sonnet 4.6. | Tasks requiring the deepest possible reasoning and most thorough analysis | +| `max` | Absolute maximum capability with no constraints on token spending. Available on Claude Mythos Preview, Claude Opus 4.6, and Claude Sonnet 4.6. | Tasks requiring the deepest possible reasoning and most thorough analysis | | `high` | High capability. Equivalent to not setting the parameter. | Complex reasoning, difficult coding problems, agentic tasks | | `medium` | Balanced approach with moderate token savings. | Agentic tasks that require a balance of speed, cost, and performance | | `low` | Most efficient. Significant token savings with some capability reduction. | Simpler tasks that need the best speed and lowest costs, such as subagents | @@ -256,7 +256,7 @@ puts message.content.first.text ## When to adjust the effort parameter -- Use **max effort** when you need the absolute highest capability with no constraints: the most thorough reasoning and deepest analysis. Available on Claude Opus 4.6 and Claude Sonnet 4.6. +- Use **max effort** when you need the absolute highest capability with no constraints: the most thorough reasoning and deepest analysis. Available on Claude Mythos Preview, Claude Opus 4.6, and Claude Sonnet 4.6. - Use **high effort** (the default) when you need Claude's best work: complex reasoning, nuanced analysis, difficult coding problems, or any task where quality is the top priority. - Use **medium effort** as a balanced option when you want solid performance without the full token expenditure of high effort. - Use **low effort** when you're optimizing for speed (because Claude answers with fewer tokens) or cost. For example, simple classification tasks, quick lookups, or high-volume use cases where marginal quality improvements don't justify additional latency or spend. @@ -281,6 +281,7 @@ Higher effort levels may: The effort parameter works alongside extended thinking. Its behavior depends on the model: +- **Claude Mythos Preview** uses [adaptive thinking](/docs/en/build-with-claude/adaptive-thinking) by default (no `thinking` configuration required). `thinking: {type: "disabled"}` is rejected. Effort controls thinking depth the same way as on Opus 4.6. - **Claude Opus 4.6** uses [adaptive thinking](/docs/en/build-with-claude/adaptive-thinking) (`thinking: {type: "adaptive"}`), where effort is the recommended control for thinking depth. While `budget_tokens` is still accepted on Opus 4.6, it is deprecated and will be removed in a future release. At `high` and `max` effort, Claude almost always thinks deeply. At lower levels, it may skip thinking for simpler problems. - **Claude Sonnet 4.6** uses [adaptive thinking](/docs/en/build-with-claude/adaptive-thinking) (where effort controls thinking depth). Manual thinking with [interleaved mode](/docs/en/build-with-claude/extended-thinking#interleaved-thinking) (`thinking: {type: "enabled", budget_tokens: N}`) is still functional but deprecated. - **Claude Opus 4.5 and other Claude 4 models** use manual thinking (`thinking: {type: "enabled", budget_tokens: N}`), where effort works alongside the thinking token budget. Set the effort level for your task, then set the thinking token budget based on task complexity. diff --git a/content/en/build-with-claude/extended-thinking.md b/content/en/build-with-claude/extended-thinking.md index 0d871ebbe..eeca50a20 100644 --- a/content/en/build-with-claude/extended-thinking.md +++ b/content/en/build-with-claude/extended-thinking.md @@ -14,17 +14,11 @@ For Claude Opus 4.6 and Claude Sonnet 4.6, use [adaptive thinking](/docs/en/buil ## Supported models -Extended thinking is supported in the following models: - -- Claude Opus 4.6 (`claude-opus-4-6`), [adaptive thinking](/docs/en/build-with-claude/adaptive-thinking) recommended; manual mode (`type: "enabled"`) is deprecated but still functional -- Claude Opus 4.5 (`claude-opus-4-5-20251101`) -- Claude Opus 4.1 (`claude-opus-4-1-20250805`) -- Claude Opus 4 (`claude-opus-4-20250514`) -- Claude Sonnet 4.6 (`claude-sonnet-4-6`), [adaptive thinking](/docs/en/build-with-claude/adaptive-thinking) recommended; manual mode (`type: "enabled"`) with [interleaved mode](#interleaved-thinking) is deprecated but still functional -- Claude Sonnet 4.5 (`claude-sonnet-4-5-20250929`) -- Claude Sonnet 4 (`claude-sonnet-4-20250514`) -- Claude Sonnet 3.7 (`claude-3-7-sonnet-20250219`) ([deprecated](/docs/en/about-claude/model-deprecations)) -- Claude Haiku 4.5 (`claude-haiku-4-5-20251001`) +Extended thinking is supported on all supported Claude models. A few models have mode-specific behavior: + +- **[Claude Mythos Preview](https://anthropic.com/glasswing):** [adaptive thinking](/docs/en/build-with-claude/adaptive-thinking) is the default; `thinking: {type: "enabled", budget_tokens: N}` is also accepted. `thinking: {type: "disabled"}` is not supported, and `display` defaults to `"omitted"` rather than returning thinking content. Pass `display: "summarized"` to receive summaries. +- **Claude Opus 4.6 (`claude-opus-4-6`):** [adaptive thinking](/docs/en/build-with-claude/adaptive-thinking) recommended; manual mode (`type: "enabled"`) is deprecated but still functional. +- **Claude Sonnet 4.6 (`claude-sonnet-4-6`):** [adaptive thinking](/docs/en/build-with-claude/adaptive-thinking) recommended; manual mode (`type: "enabled"`) with [interleaved mode](#interleaved-thinking) is deprecated but still functional. API behavior differs across Claude Sonnet 3.7 and Claude 4 models, but the API shapes remain exactly the same. @@ -320,20 +314,20 @@ The `budget_tokens` parameter determines the maximum number of tokens Claude is -Claude Opus 4.6 supports up to 128k output tokens. Claude Sonnet 4.6 and Claude Haiku 4.5 support up to 64k. See the [models overview](/docs/en/about-claude/models/overview) for limits on legacy models. On the [Message Batches API](/docs/en/build-with-claude/batch-processing#extended-output-beta), the `output-300k-2026-03-24` [beta header](/docs/en/api/beta-headers) raises the output limit to 300k for Opus 4.6 and Sonnet 4.6. +[Claude Mythos Preview](https://anthropic.com/glasswing) and Claude Opus 4.6 support up to 128k output tokens. Claude Sonnet 4.6 and Claude Haiku 4.5 support up to 64k. See the [models overview](/docs/en/about-claude/models/overview) for limits on legacy models. On the [Message Batches API](/docs/en/build-with-claude/batch-processing#extended-output-beta), the `output-300k-2026-03-24` [beta header](/docs/en/api/beta-headers) raises the output limit to 300k for Opus 4.6 and Sonnet 4.6. `budget_tokens` must be set to a value less than `max_tokens`. However, when using [interleaved thinking with tools](#interleaved-thinking), you can exceed this limit as the token limit becomes your entire context window. ### Summarized thinking -With extended thinking enabled, the Messages API for Claude 4 models returns a summary of Claude's full thinking process. Summarized thinking provides the full intelligence benefits of extended thinking, while preventing misuse. This is the default behavior when the `display` field on the thinking configuration is unset or set to `"summarized"`. +With extended thinking enabled, the Messages API for Claude 4 models returns a summary of Claude's full thinking process. Summarized thinking provides the full intelligence benefits of extended thinking, while preventing misuse. This is the default behavior on Claude 4 models when the `display` field on the thinking configuration is unset or set to `"summarized"`. On [Claude Mythos Preview](https://anthropic.com/glasswing), `display` defaults to `"omitted"` instead, so you must set `display: "summarized"` explicitly to receive summarized thinking. Here are some important considerations for summarized thinking: - You're charged for the full thinking tokens generated by the original request, not the summary tokens. - The billed output token count will **not match** the count of tokens you see in the response. -- The first few lines of thinking output are more verbose, providing detailed reasoning that's particularly helpful for prompt engineering purposes. +- On Claude 4 models, the first few lines of thinking output are more verbose, providing detailed reasoning that's particularly helpful for prompt engineering purposes. [Claude Mythos Preview](https://anthropic.com/glasswing) summarizes from the first token, so its thinking blocks do not show this verbose preamble. - As Anthropic seeks to improve the extended thinking feature, summarization behavior is subject to change. - Summarization preserves the key ideas of Claude's thinking process with minimal added latency, enabling a streamable user experience and easy migration from Claude Sonnet 3.7 to Claude 4 and later models. - Summarization is processed by a different model than the one you target in your requests. The thinking model does not see the summarized output. @@ -348,8 +342,8 @@ In rare cases where you need access to full thinking output for Claude 4 models, The `display` field on the thinking configuration controls how thinking content is returned in API responses. It accepts two values: -- `"summarized"` (default): Thinking blocks contain summarized thinking text. See [Summarized thinking](#summarized-thinking) for details. -- `"omitted"`: Thinking blocks are returned with an empty `thinking` field. The `signature` field still carries the encrypted full thinking for multi-turn continuity (see [Thinking encryption](#thinking-encryption)). +- `"summarized"`: Thinking blocks contain summarized thinking text. See [Summarized thinking](#summarized-thinking) for details. This is the default on Claude 4 models. +- `"omitted"`: Thinking blocks are returned with an empty `thinking` field. The `signature` field still carries the encrypted full thinking for multi-turn continuity (see [Thinking encryption](#thinking-encryption)). This is the default on [Claude Mythos Preview](https://anthropic.com/glasswing). Setting `display: "omitted"` is useful when your application doesn't surface thinking content to users. The primary benefit is **faster time-to-first-text-token when streaming:** The server skips streaming thinking tokens entirely and delivers only the signature, so the final text response begins streaming sooner. @@ -368,6 +362,10 @@ Here are some important considerations for omitted thinking: The `signature` field is identical whether `display` is `"summarized"` or `"omitted"`. Switching `display` values between turns in a conversation is supported. + +On [Claude Mythos Preview](https://anthropic.com/glasswing), `display` defaults to `"omitted"`. The examples in this section pass `display` explicitly so they apply to all models, but on Mythos Preview you can leave it unset and receive the same behavior. To receive summarized thinking on Mythos Preview, set `display: "summarized"` explicitly. + + Automated pipelines that never surface thinking content to end users can skip the overhead of receiving thinking tokens over the wire. Latency-sensitive applications get the same reasoning quality without waiting for thinking text to stream before the final response begins. @@ -2039,6 +2037,7 @@ With interleaved thinking, Claude can: - Make more nuanced decisions based on intermediate results **Model support:** +- **[Claude Mythos Preview](https://anthropic.com/glasswing)**: Interleaved thinking happens automatically. Every inter-tool reasoning step moves into a thinking block instead of plain text, and thinking blocks are preserved across turns by default. No beta header is needed or supported. - **Claude Opus 4.6**: Interleaved thinking is automatically enabled when using [adaptive thinking](/docs/en/build-with-claude/adaptive-thinking). No beta header is needed. The `interleaved-thinking-2025-05-14` beta header is **deprecated** on Opus 4.6 and is safely ignored if included. - **Claude Sonnet 4.6**: Interleaved thinking is automatically enabled when using [adaptive thinking](/docs/en/build-with-claude/adaptive-thinking) (recommended). The `interleaved-thinking-2025-05-14` beta header with manual extended thinking (`thinking: {type: "enabled"}`) is still functional but deprecated. - **Other Claude 4 models** (Opus 4.5, Opus 4.1, Opus 4, Sonnet 4.5, Sonnet 4): Add [the beta header](/docs/en/api/beta-headers) `interleaved-thinking-2025-05-14` to your API request to enable interleaved thinking. @@ -3666,17 +3665,38 @@ Here are some important considerations on thinking encryption: - The `signature` field is an opaque field and should not be interpreted or parsed. - `signature` values are compatible across platforms (Claude APIs, [Amazon Bedrock](/docs/en/build-with-claude/claude-on-amazon-bedrock), and [Vertex AI](/docs/en/build-with-claude/claude-on-vertex-ai)). Values generated on one platform will be compatible with another. +## Redacted thinking blocks + +In addition to regular `thinking` blocks, the API may return `redacted_thinking` blocks. A `redacted_thinking` block contains encrypted thinking content in a `data` field, with no readable summary: + +```json +{ + "type": "redacted_thinking", + "data": "..." +} +``` + +The `data` field is opaque and encrypted. Like the `signature` field on regular thinking blocks, you should pass `redacted_thinking` blocks back to the API unchanged when continuing a multi-turn conversation with [tools](/docs/en/build-with-claude/extended-thinking#extended-thinking-with-tool-use). + + +If your code filters content blocks by type (for example, `block.type == "thinking"`) when round-tripping responses with tool use, also include `redacted_thinking` blocks. Filtering on `block.type == "thinking"` alone silently drops `redacted_thinking` blocks and breaks the multi-turn protocol described above. + + + +`redacted_thinking` blocks are a distinct content block type returned by the API when portions of thinking are safety-redacted. This is separate from the [`display: "omitted"`](#controlling-thinking-display) option, which returns regular `thinking` blocks with an empty `thinking` field. + + ## Differences in thinking across model versions The Messages API handles thinking differently across Claude Sonnet 3.7 and Claude 4 models, primarily in summarization behavior. See the table below for a condensed comparison: -| Feature | Claude Sonnet 3.7 | Claude 4 Models (pre-Opus 4.5) | Claude Opus 4.5 | Claude Sonnet 4.6 | Claude Opus 4.6 ([adaptive thinking](/docs/en/build-with-claude/adaptive-thinking)) | -|---------|------------------|-------------------------------|--------------------------|------------------|--------------------------| -| **Thinking Output** | Returns full thinking output | Returns summarized thinking | Returns summarized thinking | Returns summarized thinking | Returns summarized thinking | -| **Interleaved Thinking** | Not supported | Supported with `interleaved-thinking-2025-05-14` beta header | Supported with `interleaved-thinking-2025-05-14` beta header | Supported with `interleaved-thinking-2025-05-14` beta header or automatic with [adaptive thinking](/docs/en/build-with-claude/adaptive-thinking) | Automatic with adaptive thinking (beta header not supported) | -| **Thinking Block Preservation** | Not preserved across turns | Not preserved across turns | **Preserved by default** | **Preserved by default** | **Preserved by default** | +| Feature | Claude Sonnet 3.7 | Claude 4 Models (pre-Opus 4.5) | Claude Opus 4.5 | Claude Sonnet 4.6 | Claude Opus 4.6 ([adaptive thinking](/docs/en/build-with-claude/adaptive-thinking)) | [Claude Mythos Preview](https://anthropic.com/glasswing) ([adaptive thinking](/docs/en/build-with-claude/adaptive-thinking)) | +|---------|------------------|-------------------------------|--------------------------|------------------|--------------------------|--------------------------| +| **Thinking Output** | Returns full thinking output | Returns summarized thinking | Returns summarized thinking | Returns summarized thinking | Returns summarized thinking | Omitted by default; set `display: "summarized"` to receive summarized thinking. Raw thinking tokens are never returned. | +| **Interleaved Thinking** | Not supported | Supported with `interleaved-thinking-2025-05-14` beta header | Supported with `interleaved-thinking-2025-05-14` beta header | Supported with `interleaved-thinking-2025-05-14` beta header or automatic with [adaptive thinking](/docs/en/build-with-claude/adaptive-thinking) | Automatic with adaptive thinking (beta header not supported) | Automatic with adaptive thinking (beta header not supported). Inter-tool reasoning moves into thinking blocks on this model. | +| **Thinking Block Preservation** | Not preserved across turns | Not preserved across turns | **Preserved by default** | **Preserved by default** | **Preserved by default** | **Preserved by default.** Blocks are stripped when continuing the conversation on a model that does not support the Mythos thinking format. | ### Thinking block preservation in Claude Opus 4.5 and later @@ -3690,7 +3710,7 @@ Starting with Claude Opus 4.5 (and continuing in Claude Opus 4.6), **thinking bl **Important considerations:** - **Context usage**: Long conversations will consume more context space since thinking blocks are retained in context -- **Automatic behavior**: This is the default behavior for Claude Opus 4.5 and later models (including Opus 4.6). No code changes or beta headers required +- **Automatic behavior**: This is the default behavior for Claude Opus 4.5 and later models (including [Claude Mythos Preview](https://anthropic.com/glasswing) and Claude Opus 4.6). No code changes or beta headers required - **Backward compatibility**: To leverage this feature, continue passing complete, unmodified thinking blocks back to the API as you would for tool use diff --git a/content/en/build-with-claude/overview.md b/content/en/build-with-claude/overview.md index 4856af994..f42bd47ba 100644 --- a/content/en/build-with-claude/overview.md +++ b/content/en/build-with-claude/overview.md @@ -102,4 +102,4 @@ Manage files and assets for use with Claude. |---------|-----------|----|--------------| | [Files API](/docs/en/build-with-claude/files) | Upload and manage files to use with Claude without re-uploading content with each request. Supports PDFs, images, and text files. | Not ZDR eligible | | -\* **Structured outputs:** Your prompts and Claude's outputs are not stored. Only JSON schemas are cached, for up to 24 hours since last use. **Tool search:** Only tool catalog data (names, descriptions, argument metadata) is stored server-side; custom client-side implementations are fully ZDR-eligible. **Web search and web fetch:** ZDR-eligible except when [dynamic filtering](/docs/en/agents-and-tools/tool-use/web-search-tool#dynamic-filtering-with-opus-4-6-and-sonnet-4-6) is enabled. See [ZDR details](/docs/en/build-with-claude/api-and-data-retention#feature-eligibility). \ No newline at end of file +\* **Structured outputs:** Your prompts and Claude's outputs are not stored. Only JSON schemas are cached, for up to 24 hours since last use. **Tool search:** Only tool catalog data (names, descriptions, argument metadata) is stored server-side; custom client-side implementations are fully ZDR-eligible. **Web search and web fetch:** ZDR-eligible except when [dynamic filtering](/docs/en/agents-and-tools/tool-use/web-search-tool#dynamic-filtering) is enabled. See [ZDR details](/docs/en/build-with-claude/api-and-data-retention#feature-eligibility). \ No newline at end of file diff --git a/content/en/build-with-claude/prompt-caching.md b/content/en/build-with-claude/prompt-caching.md index 602e10019..3113b8598 100644 --- a/content/en/build-with-claude/prompt-caching.md +++ b/content/en/build-with-claude/prompt-caching.md @@ -278,18 +278,7 @@ These multipliers stack with other pricing modifiers such as the Batch API disco ## Supported models -Prompt caching (both automatic and explicit) is currently supported on: -- Claude Opus 4.6 -- Claude Opus 4.5 -- Claude Opus 4.1 -- Claude Opus 4 -- Claude Sonnet 4.6 -- Claude Sonnet 4.5 -- Claude Sonnet 4 -- Claude Sonnet 3.7 ([deprecated](/docs/en/about-claude/model-deprecations)) -- Claude Haiku 4.5 -- Claude Haiku 3.5 ([deprecated](/docs/en/about-claude/model-deprecations)) -- Claude Haiku 3 +Prompt caching (both automatic and explicit) is supported on all [active Claude models](/docs/en/about-claude/models/overview). --- @@ -636,7 +625,7 @@ Adding more `cache_control` breakpoints doesn't increase your costs - you still ### Cache limitations The minimum cacheable prompt length is: -- 4096 tokens for Claude Opus 4.6, Claude Opus 4.5 +- 4096 tokens for [Claude Mythos Preview](https://anthropic.com/glasswing), Claude Opus 4.6, and Claude Opus 4.5 - 2048 tokens for Claude Sonnet 4.6 - 1024 tokens for Claude Sonnet 4.5, Claude Opus 4.1, Claude Opus 4, Claude Sonnet 4, and Claude Sonnet 3.7 ([deprecated](/docs/en/about-claude/model-deprecations)) - 4096 tokens for Claude Haiku 4.5 @@ -2583,7 +2572,7 @@ For ZDR eligibility across all features, see [API and data retention](/docs/en/b
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  - No, prompt caching is currently only available for Claude Opus 4.6, Claude Opus 4.5, Claude Sonnet 4.6, Claude Sonnet 4.5, Claude Opus 4.1, Claude Opus 4, Claude Sonnet 4, Claude Sonnet 3.7 ([deprecated](/docs/en/about-claude/model-deprecations)), Claude Haiku 4.5, Claude Haiku 3.5 ([deprecated](/docs/en/about-claude/model-deprecations)), and Claude Haiku 3. + Prompt caching is supported on all [active Claude models](/docs/en/about-claude/models/overview).
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  diff --git a/content/en/build-with-claude/prompt-engineering/claude-prompting-best-practices.md b/content/en/build-with-claude/prompt-engineering/claude-prompting-best-practices.md index 85b294595..18325fd13 100644 --- a/content/en/build-with-claude/prompt-engineering/claude-prompting-best-practices.md +++ b/content/en/build-with-claude/prompt-engineering/claude-prompting-best-practices.md @@ -245,7 +245,7 @@ Create a professional presentation on [topic]. Include thoughtful design element ### Migrating away from prefilled responses -Starting with Claude 4.6 models, prefilled responses on the last assistant turn are no longer supported. Model intelligence and instruction following has advanced such that most use cases of prefill no longer require it. Existing models will continue to support prefills, and adding assistant messages elsewhere in the conversation is not affected. +Starting with Claude 4.6 models and [Claude Mythos Preview](https://anthropic.com/glasswing), prefilled responses on the last assistant turn are no longer supported. On Mythos Preview, requests with prefilled assistant messages return a 400 error. Model intelligence and instruction following has advanced such that most use cases of prefill no longer require it. Existing models will continue to support prefills, and adding assistant messages elsewhere in the conversation is not affected. Here are common prefill scenarios and how to migrate away from them: diff --git a/content/en/build-with-claude/structured-outputs.md b/content/en/build-with-claude/structured-outputs.md index 942052c12..68109bf6d 100644 --- a/content/en/build-with-claude/structured-outputs.md +++ b/content/en/build-with-claude/structured-outputs.md @@ -12,7 +12,7 @@ Structured outputs constrain Claude's responses to follow a specific schema, ens These features can be used independently or together in the same request. -Structured outputs are generally available on the Claude API and Amazon Bedrock for Claude Opus 4.6, Claude Sonnet 4.6, Claude Sonnet 4.5, Claude Opus 4.5, and Claude Haiku 4.5. Structured outputs are in beta on Microsoft Foundry. +Structured outputs are generally available on the Claude API and Amazon Bedrock for [Claude Mythos Preview](https://anthropic.com/glasswing), Claude Opus 4.6, Claude Sonnet 4.6, Claude Sonnet 4.5, Claude Opus 4.5, and Claude Haiku 4.5. Structured outputs are in beta on Microsoft Foundry. Structured outputs are not supported on Google Cloud's Vertex AI for Claude Mythos Preview. diff --git a/content/en/build-with-claude/working-with-messages.md b/content/en/build-with-claude/working-with-messages.md index a081de081..74cef07b3 100644 --- a/content/en/build-with-claude/working-with-messages.md +++ b/content/en/build-with-claude/working-with-messages.md @@ -577,7 +577,7 @@ You can pre-fill part of Claude's response in the last position of the input mes ``` -Prefilling is not supported on Claude Opus 4.6 and Claude Sonnet 4.6. Requests using prefill with these models return a 400 error. Use [structured outputs](/docs/en/build-with-claude/structured-outputs) or system prompt instructions instead. See the [migration guide](/docs/en/about-claude/models/migration-guide) for migration patterns. +Prefilling is not supported on [Claude Mythos Preview](https://anthropic.com/glasswing), Claude Opus 4.6, and Claude Sonnet 4.6. Requests using prefill with these models return a 400 error. Use [structured outputs](/docs/en/build-with-claude/structured-outputs) or system prompt instructions instead. See the [migration guide](/docs/en/about-claude/models/migration-guide) for migration patterns. ## Vision diff --git a/content/en/docs/claude-code/amazon-bedrock.md b/content/en/docs/claude-code/amazon-bedrock.md index 7d72c2261..5ee31f00e 100644 --- a/content/en/docs/claude-code/amazon-bedrock.md +++ b/content/en/docs/claude-code/amazon-bedrock.md @@ -265,6 +265,78 @@ Example configuration: } ``` +## Use the Mantle endpoint + +Mantle is an Amazon Bedrock endpoint that serves Claude models through the native Anthropic API shape rather than the Bedrock Invoke API. It uses the same AWS credentials, IAM permissions, and `awsAuthRefresh` configuration described earlier on this page. + + + Mantle requires Claude Code v2.1.94 or later. Run `claude --version` to check. + + +### Enable Mantle + +With AWS credentials already configured, set `CLAUDE_CODE_USE_MANTLE` to route requests to the Mantle endpoint: + +```bash theme={null} +export CLAUDE_CODE_USE_MANTLE=1 +export AWS_REGION=us-east-1 +``` + +Claude Code constructs the endpoint URL from `AWS_REGION`. To override it for a custom endpoint or gateway, set `ANTHROPIC_BEDROCK_MANTLE_BASE_URL`. + +Run `/status` inside Claude Code to confirm. The provider line shows `Amazon Bedrock (Mantle)` when Mantle is active. + +### Select a Mantle model + +Mantle uses model IDs prefixed with `anthropic.` and without a version suffix, for example `anthropic.claude-haiku-4-5`. The models available to your account depend on what your organization has been granted; additional model IDs are listed in your onboarding materials from AWS. Contact your AWS account team to request access to allowlisted models. + +Set the model with the `--model` flag or with `/model` inside Claude Code: + +```bash theme={null} +claude --model anthropic.claude-haiku-4-5 +``` + +### Run Mantle alongside the Invoke API + +The models available to you on Mantle may not include every model you use today. Setting both `CLAUDE_CODE_USE_BEDROCK` and `CLAUDE_CODE_USE_MANTLE` lets Claude Code call both endpoints from the same session. Model IDs that match the Mantle format are routed to Mantle, and all other model IDs go to the Bedrock Invoke API. + +```bash theme={null} +export CLAUDE_CODE_USE_BEDROCK=1 +export CLAUDE_CODE_USE_MANTLE=1 +``` + +To surface a Mantle model in the `/model` picker, list its ID in `availableModels` in your [settings file](/en/settings). This setting also restricts the picker to the listed entries, so include every alias you want to keep available: + +```json theme={null} +{ + "availableModels": ["opus", "sonnet", "haiku", "anthropic.claude-haiku-4-5"] +} +``` + +Entries with the `anthropic.` prefix are added as custom picker options and routed to Mantle. Replace `anthropic.claude-haiku-4-5` with the model ID your account has been granted. See [Restrict model selection](/en/model-config#restrict-model-selection) for how `availableModels` interacts with other model settings. + +When both providers are active, `/status` shows `Amazon Bedrock + Amazon Bedrock (Mantle)`. + +### Route Mantle through a gateway + +If your organization routes model traffic through a centralized [LLM gateway](/en/llm-gateway) that injects AWS credentials server-side, disable client-side authentication so Claude Code sends requests without SigV4 signatures or `x-api-key` headers: + +```bash theme={null} +export CLAUDE_CODE_USE_MANTLE=1 +export CLAUDE_CODE_SKIP_MANTLE_AUTH=1 +export ANTHROPIC_BEDROCK_MANTLE_BASE_URL=https://your-gateway.example.com +``` + +### Mantle environment variables + +These variables are specific to the Mantle endpoint. See [Environment variables](/en/env-vars) for the full list. + +| Variable | Purpose | +| :---------------------------------- | :------------------------------------------------ | +| `CLAUDE_CODE_USE_MANTLE` | Enable the Mantle endpoint. Set to `1` or `true`. | +| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Override the default Mantle endpoint URL | +| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Skip client-side authentication for proxy setups | + ## Troubleshooting ### Authentication loop with SSO and corporate proxies @@ -287,6 +359,14 @@ If you receive an error "on-demand throughput isn’t supported": Claude Code uses the Bedrock [Invoke API](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html) and does not support the Converse API. +### Mantle endpoint errors + +If `/status` does not show `Amazon Bedrock (Mantle)` after you set `CLAUDE_CODE_USE_MANTLE`, the variable is not reaching the process. Confirm it is exported in the shell where you launched `claude`, or set it in the `env` block of your [settings file](/en/settings). + +A `403` from the Mantle endpoint with valid credentials means your AWS account has not been granted access to the model you requested. Contact your AWS account team to request access. + +A `400` that names the model ID means that model is not served on Mantle. Mantle has its own model lineup separate from the standard Bedrock catalog, so inference profile IDs such as `us.anthropic.claude-sonnet-4-6` will not work. Use a Mantle-format ID, or enable [both endpoints](#run-mantle-alongside-the-invoke-api) so Claude Code routes each request to the endpoint where the model is available. + ## Additional resources * [Bedrock documentation](https://docs.aws.amazon.com/bedrock/) diff --git a/content/en/docs/claude-code/changelog.md b/content/en/docs/claude-code/changelog.md index 33d7088ba..c5d85db09 100644 --- a/content/en/docs/claude-code/changelog.md +++ b/content/en/docs/claude-code/changelog.md @@ -10,6 +10,34 @@ This page is generated from the [CHANGELOG.md on GitHub](https://github.com/anth Run `claude --version` to check your installed version. + + * Added support for Amazon Bedrock powered by Mantle, set `CLAUDE_CODE_USE_MANTLE=1` + * Changed default effort level from medium to high for API-key, Bedrock/Vertex/Foundry, Team, and Enterprise users (control this with `/effort`) + * Added compact `Slacked #channel` header with a clickable channel link for Slack MCP send-message tool calls + * Added `keep-coding-instructions` frontmatter field support for plugin output styles + * Added `hookSpecificOutput.sessionTitle` to `UserPromptSubmit` hooks for setting the session title + * Plugin skills declared via `"skills": ["./"]` now use the skill's frontmatter `name` for the invocation name instead of the directory basename, giving a stable name across install methods + * Fixed agents appearing stuck after a 429 rate-limit response with a long Retry-After header — the error now surfaces immediately instead of silently waiting + * Fixed Console login on macOS silently failing with "Not logged in" when the login keychain is locked or its password is out of sync — the error is now surfaced and `claude doctor` diagnoses the fix + * Fixed plugin skill hooks defined in YAML frontmatter being silently ignored + * Fixed plugin hooks failing with "No such file or directory" when `CLAUDE_PLUGIN_ROOT` was not set + * Fixed `${CLAUDE_PLUGIN_ROOT}` resolving to the marketplace source directory instead of the installed cache for local-marketplace plugins on startup + * Fixed scrollback showing the same diff repeated and blank pages in long-running sessions + * Fixed multiline user prompts in the transcript indenting wrapped lines under the `❯` caret instead of under the text + * Fixed Shift+Space inserting the literal word "space" instead of a space character in search inputs + * Fixed hyperlinks opening two browser tabs when clicked inside tmux running in an xterm.js-based terminal (VS Code, Hyper, Tabby) + * Fixed an alt-screen rendering bug where content height changes mid-scroll could leave compounding ghost lines + * Fixed `FORCE_HYPERLINK` environment variable being ignored when set via `settings.json` `env` + * Fixed native terminal cursor not tracking the selected tab in dialogs, so screen readers and magnifiers can follow tab navigation + * Fixed Bedrock invocation of Sonnet 3.5 v2 by using the `us.` inference profile ID + * Fixed SDK/print mode not preserving the partial assistant response in conversation history when interrupted mid-stream + * Improved `--resume` to resume sessions from other worktrees of the same repo directly instead of printing a `cd` command + * Fixed CJK and other multibyte text being corrupted with U+FFFD in stream-json input/output when chunk boundaries split a UTF-8 sequence + * \[VSCode] Reduced cold-open subprocess work on starting a session + * \[VSCode] Fixed dropdown menus selecting the wrong item when the mouse was over the list while typing or using arrow keys + * \[VSCode] Added a warning banner when `settings.json` files fail to parse, so users know their permission rules are not being applied + + * Added `forceRemoteSettingsRefresh` policy setting: when set, the CLI blocks startup until remote managed settings are freshly fetched, and exits if the fetch fails (fail-closed) * Added interactive Bedrock setup wizard accessible from the login screen when selecting "3rd-party platform" — guides you through AWS authentication, region configuration, credential verification, and model pinning diff --git a/content/en/docs/claude-code/claude-directory.md b/content/en/docs/claude-code/claude-directory.md index 4331e826b..622564e60 100644 --- a/content/en/docs/claude-code/claude-directory.md +++ b/content/en/docs/claude-code/claude-directory.md @@ -1398,12 +1398,15 @@ This page is an interactive explorer: click files in the tree to see what each o ## What's not shown -The explorer covers the files you'll interact with most. A few things live elsewhere: +The explorer covers files you author and edit. A few authored files live elsewhere: -| File | Location | Purpose | -| ----------------------- | -------------------------- | --------------------------------------------------------------------------------------------------------------------- | -| `managed-settings.json` | System-level, varies by OS | Enterprise-enforced settings that you can't override. See [server-managed settings](/en/server-managed-settings). | -| `CLAUDE.local.md` | Project root | Your private preferences for this project, loaded alongside CLAUDE.md. Create it manually and add it to `.gitignore`. | +| File | Location | Purpose | +| ----------------------- | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `managed-settings.json` | System-level, varies by OS | Enterprise-enforced settings that you can't override. See [server-managed settings](/en/server-managed-settings). | +| `CLAUDE.local.md` | Project root | Your private preferences for this project, loaded alongside CLAUDE.md. Create it manually and add it to `.gitignore`. | +| Installed plugins | `~/.claude/plugins/` | Cloned marketplaces, installed plugin versions, and per-plugin data, managed by `claude plugin` commands. Orphaned versions are deleted 7 days after a plugin update or uninstall. See [plugin caching](/en/plugins-reference#plugin-caching-and-file-resolution). | + +`~/.claude` also holds data Claude Code writes as you work: transcripts, prompt history, file snapshots, caches, and logs. See [application data](#application-data) below. ## File reference @@ -1455,6 +1458,60 @@ The explorer shows what files can exist. To see what actually loaded in your cur Run `/context` first for the overview, then the specific command for the area you want to investigate. +## Application data + +Beyond the config you author, `~/.claude` holds data Claude Code writes during sessions. These files are plaintext. Anything that passes through a tool (file contents, command output, pasted text) lands in a transcript on disk. + +### Swept automatically + +Files older than [`cleanupPeriodDays`](/en/settings#available-settings) (default 30) are deleted on the next startup. + +| Path under `~/.claude/` | Contents | +| -------------------------------------------- | -------------------------------------------------------------------------------------------- | +| `projects//.jsonl` | Full conversation transcript: every message, tool call, and tool result | +| `projects///tool-results/` | Large tool outputs spilled to separate files | +| `file-history//` | Pre-edit snapshots of files Claude changed, used for [checkpoint restore](/en/checkpointing) | +| `plans/` | Plan files written during [plan mode](/en/permission-modes#plan-mode) | +| `debug/` | Per-session debug logs | +| `paste-cache/`, `image-cache/` | Contents of large pastes and attached images | +| `session-env/` | Per-session environment metadata | + +### Not swept + +These persist until you delete them. + +| Path under `~/.claude/` | Contents | +| ----------------------- | ------------------------------------------------------------------------------------- | +| `history.jsonl` | Every prompt you've typed, with timestamp and project path. Used for up-arrow recall. | +| `statsig/` | Feature-flag cache and a stable anonymous device ID | +| `stats-cache.json` | Aggregated token and cost counts shown by `/cost` | +| `backups/` | Timestamped copies of `~/.claude.json` taken before config migrations | +| `downloads/` | Native binary downloads staged by the auto-updater | +| `todos/` | Legacy per-session task lists. No longer written by current versions; safe to delete. | + +`shell-snapshots/` and `sockets/` are runtime files removed when the session exits cleanly. + +### Plaintext storage + +Transcripts and history are not encrypted at rest; OS file permissions are the only protection. If a tool reads a `.env` file or a command prints a credential, that value is written to `projects//.jsonl`. To reduce exposure: + +* Lower `cleanupPeriodDays` to shorten how long transcripts are kept +* For headless runs, pass `--no-session-persistence` with `-p`, or set `persistSession: false` in the SDK, to skip writing transcripts entirely. There is no interactive-mode equivalent. +* Use [permission rules](/en/permissions) to deny reads of credential files + +### Clear local data + +You can delete these at any time. You lose the listed capability for past sessions; new sessions are unaffected. + +| Delete | You lose | +| ------------------------------------------------------------ | ---------------------------------------------- | +| `~/.claude/projects/` | Resume, continue, and rewind for past sessions | +| `~/.claude/history.jsonl` | Up-arrow prompt recall | +| `~/.claude/file-history/` | Checkpoint restore for past sessions | +| `~/.claude/debug/`, `paste-cache/`, `image-cache/`, `todos/` | Nothing user-facing | + +Don't delete `~/.claude.json`, `settings.json`, or `plugins/`: those hold your auth, preferences, and installed plugins. + ## Related resources * [Manage Claude's memory](/en/memory): write and organize CLAUDE.md, rules, and auto memory diff --git a/content/en/docs/claude-code/code-review.md b/content/en/docs/claude-code/code-review.md index f0f71899e..d4ae033fb 100644 --- a/content/en/docs/claude-code/code-review.md +++ b/content/en/docs/claude-code/code-review.md @@ -45,6 +45,12 @@ Each finding is tagged with a severity level: Findings include a collapsible extended reasoning section you can expand to understand why Claude flagged the issue and how it verified the problem. +### Rate and reply to findings + +Each review comment from Claude arrives with 👍 and 👎 already attached so both buttons appear in the GitHub UI for one-click rating. Click 👍 if the finding was useful or 👎 if it was wrong or noisy. Anthropic collects reaction counts after the PR merges and uses them to tune the reviewer. Reactions do not trigger a re-review or change anything on the PR. + +Replying to an inline comment does not prompt Claude to respond or update the PR. To act on a finding, fix the code and push. If the PR is subscribed to push-triggered reviews, the next run resolves the thread when the issue is fixed. To request a fresh review without pushing, comment `@claude review once` as a [top-level PR comment](#manually-trigger-reviews). + ### Check run output Beyond the inline review comments, each review populates the **Claude Code Review** check run that appears alongside your CI checks. Expand its **Details** link to see a summary of every finding in one place, sorted by severity: diff --git a/content/en/docs/claude-code/common-workflows.md b/content/en/docs/claude-code/common-workflows.md index a066e509f..f04d508f4 100644 --- a/content/en/docs/claude-code/common-workflows.md +++ b/content/en/docs/claude-code/common-workflows.md @@ -556,7 +556,7 @@ When starting Claude Code, you can resume a previous session: From inside an active session, use `/resume` to switch to a different conversation. -Sessions are stored per project directory. The `/resume` picker shows interactive sessions from the same git repository, including worktrees. Sessions created by `claude -p` or SDK invocations do not appear in the picker, but you can still resume one by passing its session ID directly to `claude --resume `. +Sessions are stored per project directory. The `/resume` picker shows interactive sessions from the same git repository, including worktrees. When you select a session from another worktree of the same repository, Claude Code resumes it directly without requiring you to switch directories first. Sessions created by `claude -p` or SDK invocations do not appear in the picker, but you can still resume one by passing its session ID directly to `claude --resume `. ### Name your sessions diff --git a/content/en/docs/claude-code/context-window.md b/content/en/docs/claude-code/context-window.md index 7eb7fb0ac..6bef1f126 100644 --- a/content/en/docs/claude-code/context-window.md +++ b/content/en/docs/claude-code/context-window.md @@ -173,7 +173,7 @@ export const ContextWindow = () => { tokens: 120, color: '#B8860B', vis: 'hidden', - desc: 'A PostToolUse hook in `settings.json` runs prettier after every file edit and reports back via `hookSpecificOutput.additionalContext`. That field enters Claude\'s context. Plain stdout on exit 0 does not. It only appears in verbose mode via Ctrl+O.', + desc: 'A PostToolUse hook in `settings.json` runs prettier after every file edit and reports back via `hookSpecificOutput.additionalContext`. That field enters Claude\'s context. Plain stdout on exit 0 does not. It is written to the debug log only.', tip: 'Output JSON with `additionalContext` to send info to Claude. For PostToolUse hooks, exit code 2 surfaces stderr as an error but cannot block since the tool already ran. Keep output concise since it enters context without truncation.', link: '/en/hooks-guide' }, { @@ -617,7 +617,7 @@ export const ContextWindow = () => { if (detailRef.current) detailRef.current.scrollTop = 0; }, [hovEvent]); const focusT = hovEvent ? hovEvent.t : time; - const takeaway = isCompacted ? 'Compaction replaces the conversation with a structured summary. System prompt, CLAUDE.md, memory, and MCP tools reload automatically. The skill listing is the one exception. Only skills you actually invoked are preserved.' : focusT < STARTUP_END ? 'A lot loads before you type anything. CLAUDE.md, memory, skills, and MCP tools are all in context before your first prompt.' : focusT < 0.28 ? "Your prompt is tiny compared to what's already loaded. Most of Claude's context is project knowledge, not your words." : focusT < 0.50 ? 'Each file Claude reads grows the context. Path-scoped rules load automatically alongside matching files.' : focusT < 0.71 ? 'Hooks fire automatically on tool events. Output reaches Claude via additionalContext JSON. Exit code 2 surfaces stderr to Claude. Plain stdout stays in verbose mode only.' : focusT < 0.79 ? 'Follow-up questions keep building on the same context. Everything from earlier is still there.' : focusT < 0.87 ? "The subagent works in its own separate context window. None of its file reads touch yours. Only the final summary comes back." : focusT < 0.88 ? 'Bang commands run in your shell and prefix the output to your next message. Useful for grounding Claude in command results without it running them.' : focusT < 0.90 ? 'User-only skills stay out of context entirely until you invoke them. The skill index at startup only lists skills Claude can call on its own.' : '/compact summarizes the conversation to free space while keeping key information. In a real session, run it when context starts affecting performance or before a long new task.'; + const takeaway = isCompacted ? 'Compaction replaces the conversation with a structured summary. System prompt, CLAUDE.md, memory, and MCP tools reload automatically. The skill listing is the one exception. Only skills you actually invoked are preserved.' : focusT < STARTUP_END ? 'A lot loads before you type anything. CLAUDE.md, memory, skills, and MCP tools are all in context before your first prompt.' : focusT < 0.28 ? "Your prompt is tiny compared to what's already loaded. Most of Claude's context is project knowledge, not your words." : focusT < 0.50 ? 'Each file Claude reads grows the context. Path-scoped rules load automatically alongside matching files.' : focusT < 0.71 ? 'Hooks fire automatically on tool events. Output reaches Claude via additionalContext JSON. Exit code 2 surfaces stderr to Claude. Plain stdout on exit 0 goes to the debug log, not the transcript.' : focusT < 0.79 ? 'Follow-up questions keep building on the same context. Everything from earlier is still there.' : focusT < 0.87 ? "The subagent works in its own separate context window. None of its file reads touch yours. Only the final summary comes back." : focusT < 0.88 ? 'Bang commands run in your shell and prefix the output to your next message. Useful for grounding Claude in command results without it running them.' : focusT < 0.90 ? 'User-only skills stay out of context entirely until you invoke them. The skill index at startup only lists skills Claude can call on its own.' : '/compact summarizes the conversation to free space while keeping key information. In a real session, run it when context starts affecting performance or before a long new task.'; const terminalView = isCompacted ? 'A "Conversation compacted" message. The summarization happens silently.' : focusT < STARTUP_END ? 'The input box, waiting for your first message. Everything above loads silently before you type anything.' : focusT < 0.28 ? 'Your prompt. Claude hasn\'t started working yet.' : focusT < 0.52 ? 'Your prompt and "Reading files...". Rules show as one-line "Loaded" notices, not their content.' : focusT < 0.72 ? "Claude's response and file diffs. Hooks fire silently. Tool output like npm test shows as a brief summary, not the full content." : focusT < 0.79 ? 'Your follow-up prompt.' : focusT < 0.86 ? "A brief notice that a subagent is working, then its result. You don't see the subagent's individual file reads." : focusT < 0.90 ? "Claude's response, your git status output, and the commit-push skill running." : 'Your full conversation. /compact is available to run.'; const mono = 'var(--font-mono, ui-monospace, SFMono-Regular, Menlo, monospace)'; const renderWithCode = s => s.split('`').map((part, i) => i % 2 === 1 ? __` prefix on tool names from SDK-created MCP servers. Tools use their original names. SDK usage only | @@ -118,6 +119,7 @@ Claude Code supports the following environment variables to control its behavior | `CLAUDE_CODE_SIMPLE` | Set to `1` to run with a minimal system prompt and only the Bash, file read, and file edit tools. MCP tools from `--mcp-config` are still available. Disables auto-discovery of hooks, skills, plugins, MCP servers, auto memory, and CLAUDE.md. The [`--bare`](/en/headless#start-faster-with-bare-mode) CLI flag sets this | | `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Skip AWS authentication for Bedrock (for example, when using an LLM gateway) | | `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Skip Azure authentication for Microsoft Foundry (for example, when using an LLM gateway) | +| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Skip AWS authentication for Bedrock Mantle (for example, when using an LLM gateway) | | `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Skip Google authentication for Vertex (for example, when using an LLM gateway) | | `CLAUDE_CODE_SUBAGENT_MODEL` | See [Model configuration](/en/model-config) | | `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Set to `1` to strip Anthropic and cloud provider credentials from subprocess environments (Bash tool, hooks, MCP stdio servers). The parent Claude process keeps these credentials for API calls, but child processes cannot read them, reducing exposure to prompt injection attacks that attempt to exfiltrate secrets via shell expansion. `claude-code-action` sets this automatically when `allowed_non_write_users` is configured | @@ -129,6 +131,7 @@ Claude Code supports the following environment variables to control its behavior | `CLAUDE_CODE_TMPDIR` | Override the temp directory used for internal temp files. Claude Code appends `/claude-{uid}/` (Unix) or `/claude/` (Windows) to this path. Default: `/tmp` on macOS, `os.tmpdir()` on Linux/Windows | | `CLAUDE_CODE_USE_BEDROCK` | Use [Bedrock](/en/amazon-bedrock) | | `CLAUDE_CODE_USE_FOUNDRY` | Use [Microsoft Foundry](/en/microsoft-foundry) | +| `CLAUDE_CODE_USE_MANTLE` | Use the Bedrock [Mantle endpoint](/en/amazon-bedrock#use-the-mantle-endpoint) | | `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Set to `1` to enable the PowerShell tool on Windows (opt-in preview). When enabled, Claude can run PowerShell commands natively instead of routing through Git Bash. Only supported on native Windows, not WSL. See [PowerShell tool](/en/tools-reference#powershell-tool) | | `CLAUDE_CODE_USE_VERTEX` | Use [Vertex](/en/google-vertex-ai) | | `CLAUDE_CONFIG_DIR` | Override the configuration directory (default: `~/.claude`). All settings, credentials, session history, and plugins are stored under this path. Useful for running multiple accounts side by side: for example, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'` | @@ -171,8 +174,8 @@ Claude Code supports the following environment variables to control its behavior | `MCP_OAUTH_CALLBACK_PORT` | Fixed port for the OAuth redirect callback, as an alternative to `--callback-port` when adding an MCP server with [pre-configured credentials](/en/mcp#use-pre-configured-oauth-credentials) | | `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Maximum number of remote MCP servers (HTTP/SSE) to connect in parallel during startup (default: 20) | | `MCP_SERVER_CONNECTION_BATCH_SIZE` | Maximum number of local MCP servers (stdio) to connect in parallel during startup (default: 3) | -| `MCP_TIMEOUT` | Timeout in milliseconds for MCP server startup | -| `MCP_TOOL_TIMEOUT` | Timeout in milliseconds for MCP tool execution | +| `MCP_TIMEOUT` | Timeout in milliseconds for MCP server startup (default: 30000, or 30 seconds) | +| `MCP_TOOL_TIMEOUT` | Timeout in milliseconds for MCP tool execution (default: 100000000, about 28 hours) | | `NO_PROXY` | List of domains and IPs to which requests will be directly issued, bypassing proxy | | `OTEL_LOG_TOOL_CONTENT` | Set to `1` to include tool input and output content in OpenTelemetry span events. Disabled by default to protect sensitive data. See [Monitoring](/en/monitoring-usage) | | `OTEL_LOG_TOOL_DETAILS` | Set to `1` to include MCP server names and tool details in telemetry. Disabled by default to protect PII. See [Monitoring](/en/monitoring-usage) | diff --git a/content/en/docs/claude-code/hooks-guide.md b/content/en/docs/claude-code/hooks-guide.md index c973c8387..eeb2ddaa3 100644 --- a/content/en/docs/claude-code/hooks-guide.md +++ b/content/en/docs/claude-code/hooks-guide.md @@ -468,7 +468,7 @@ The exit code determines what happens next: * **Exit 0**: the action proceeds. For `UserPromptSubmit` and `SessionStart` hooks, anything you write to stdout is added to Claude's context. * **Exit 2**: the action is blocked. Write a reason to stderr, and Claude receives it as feedback so it can adjust. -* **Any other exit code**: the action proceeds. Stderr is logged but not shown to Claude. Toggle verbose mode with `Ctrl+O` to see these messages in the transcript. +* **Any other exit code**: the action proceeds. The transcript shows a one-line error notice; the full stderr goes to the [debug log](/en/hooks#debug-hooks). #### Structured JSON output @@ -572,7 +572,7 @@ A few more examples showing matchers on different event types: MCP tools use a different naming convention than built-in tools: `mcp____`, where `` is the MCP server name and `` is the tool it provides. For example, `mcp__github__search_repositories` or `mcp__filesystem__read_file`. Use a regex matcher to target all tools from a specific server, or match across servers with a pattern like `mcp__.*__write.*`. See [Match MCP tools](/en/hooks#match-mcp-tools) in the reference for the full list of examples. - The command below extracts the tool name from the hook's JSON input with `jq` and writes it to stderr, where it shows up in verbose mode (`Ctrl+O`): + The command below extracts the tool name from the hook's JSON input with `jq` and writes it to stderr. Writing to stderr keeps stdout clean for JSON output and sends the message to the [debug log](/en/hooks#debug-hooks): ```json theme={null} { @@ -849,7 +849,9 @@ The `$-` variable contains shell flags, and `i` means interactive. Hooks run in ### Debug techniques -Toggle verbose mode with `Ctrl+O` to see hook output in the transcript, or run `claude --debug` for full execution details including which hooks matched and their exit codes. +The transcript view, toggled with `Ctrl+O`, shows a one-line summary for each hook that fired: success is silent, blocking errors show stderr, and non-blocking errors show only the hook name. + +For full execution details including which hooks matched, their exit codes, stdout, and stderr, read the debug log. Start Claude Code with `claude --debug-file /tmp/claude.log` to write to a known path, then `tail -f /tmp/claude.log` in another terminal. If you started without that flag, run `/debug` mid-session to enable logging and find the log path. ## Learn more diff --git a/content/en/docs/claude-code/hooks.md b/content/en/docs/claude-code/hooks.md index 9665b5f85..a7e4956f6 100644 --- a/content/en/docs/claude-code/hooks.md +++ b/content/en/docs/claude-code/hooks.md @@ -499,11 +499,11 @@ The `tool_name` and `tool_input` fields are event-specific. Each [hook event](#h The exit code from your hook command tells Claude Code whether the action should proceed, be blocked, or be ignored. -**Exit 0** means success. Claude Code parses stdout for [JSON output fields](#json-output). JSON output is only processed on exit 0. For most events, stdout is only shown in verbose mode (`Ctrl+O`). The exceptions are `UserPromptSubmit` and `SessionStart`, where stdout is added as context that Claude can see and act on. +**Exit 0** means success. Claude Code parses stdout for [JSON output fields](#json-output). JSON output is only processed on exit 0. For most events, stdout is written to the debug log but not shown in the transcript. The exceptions are `UserPromptSubmit` and `SessionStart`, where stdout is added as context that Claude can see and act on. **Exit 2** means a blocking error. Claude Code ignores stdout and any JSON in it. Instead, stderr text is fed back to Claude as an error message. The effect depends on the event: `PreToolUse` blocks the tool call, `UserPromptSubmit` rejects the prompt, and so on. See [exit code 2 behavior](#exit-code-2-behavior-per-event) for the full list. -**Any other exit code** is a non-blocking error. stderr is shown in verbose mode (`Ctrl+O`) and execution continues. +**Any other exit code** is a non-blocking error for most hook events. The transcript shows a one-line ` hook error` notice and execution continues. The full stderr is written to the debug log. For example, a hook command script that blocks dangerous Bash commands: @@ -520,6 +520,10 @@ fi exit 0 # Success: tool call proceeds ``` + + For most hook events, only exit code 2 blocks the action. Claude Code treats exit code 1 as a non-blocking error and proceeds with the action, even though 1 is the conventional Unix failure code. If your hook is meant to enforce a policy, use `exit 2`. The exception is `WorktreeCreate`, where any non-zero exit code aborts worktree creation. + + #### Exit code 2 behavior per event Exit code 2 is the way a hook signals "stop, don't do this." The effect depends on the event, because some events represent actions that can be blocked (like a tool call that hasn't happened yet) and others represent things that already happened or can't be prevented. @@ -587,7 +591,7 @@ The JSON object supports three kinds of fields: | :--------------- | :------ | :------------------------------------------------------------------------------------------------------------------------- | | `continue` | `true` | If `false`, Claude stops processing entirely after the hook runs. Takes precedence over any event-specific decision fields | | `stopReason` | none | Message shown to the user when `continue` is `false`. Not shown to Claude | -| `suppressOutput` | `false` | If `true`, hides stdout from verbose mode output | +| `suppressOutput` | `false` | If `true`, omits stdout from the debug log | | `systemMessage` | none | Warning message shown to the user | To stop Claude entirely regardless of event type: @@ -829,6 +833,7 @@ To block a prompt, return a JSON object with `decision` set to `"block"`: | `decision` | `"block"` prevents the prompt from being processed and erases it from context. Omit to allow the prompt to proceed | | `reason` | Shown to the user when `decision` is `"block"`. Not added to context | | `additionalContext` | String added to Claude's context | +| `sessionTitle` | Sets the session title, same effect as `/rename`. Use to name sessions automatically based on the prompt content | ```json theme={null} { @@ -836,7 +841,8 @@ To block a prompt, return a JSON object with `decision` set to `"block"`: "reason": "Explanation for decision", "hookSpecificOutput": { "hookEventName": "UserPromptSubmit", - "additionalContext": "My additional context here" + "additionalContext": "My additional context here", + "sessionTitle": "My session title" } } ``` @@ -2346,7 +2352,7 @@ On Windows, you can run individual hooks in PowerShell by setting `"shell": "pow ## Debug hooks -Run `claude --debug` to see hook execution details, including which hooks matched, their exit codes, and output. +Hook execution details, including which hooks matched, their exit codes, and full stdout and stderr, are written to the debug log file. Start Claude Code with `claude --debug-file ` to write the log to a known location, or run `claude --debug` and read the log at `~/.claude/debug/.txt`. The `--debug` flag does not print to the terminal. ```text theme={null} [DEBUG] Executing hooks for PostToolUse:Write diff --git a/content/en/docs/claude-code/how-claude-code-works.md b/content/en/docs/claude-code/how-claude-code-works.md index 4bf6caa3d..3cadc310d 100644 --- a/content/en/docs/claude-code/how-claude-code-works.md +++ b/content/en/docs/claude-code/how-claude-code-works.md @@ -94,7 +94,7 @@ You can access Claude Code through the terminal, the [desktop app](/en/desktop), ## Work with sessions -Claude Code saves your conversation locally as you work. Each message, tool use, and result is stored, which enables [rewinding](#undo-changes-with-checkpoints), [resuming, and forking](#resume-or-fork-sessions) sessions. Before Claude makes code changes, it also snapshots the affected files so you can revert if needed. +Claude Code saves your conversation locally as you work. Each message, tool use, and result is written to a plaintext JSONL file under `~/.claude/projects/`, which enables [rewinding](#undo-changes-with-checkpoints), [resuming, and forking](#resume-or-fork-sessions) sessions. Before Claude makes code changes, it also snapshots the affected files so you can revert if needed. For paths, retention, and how to clear this data, see [application data in `~/.claude`](/en/claude-directory#application-data). **Sessions are independent.** Each new session starts with a fresh context window, without the conversation history from previous sessions. Claude can persist learnings across sessions using [auto memory](/en/memory#auto-memory), and you can add your own persistent instructions in [CLAUDE.md](/en/memory). diff --git a/content/en/docs/claude-code/interactive-mode.md b/content/en/docs/claude-code/interactive-mode.md index 3a332bdd6..e5c27dcaa 100644 --- a/content/en/docs/claude-code/interactive-mode.md +++ b/content/en/docs/claude-code/interactive-mode.md @@ -28,7 +28,7 @@ | `Ctrl+X Ctrl+K` | Kill all background agents. Press twice within 3 seconds to confirm | Background agent control | | `Ctrl+D` | Exit Claude Code session | EOF signal | | `Ctrl+G` or `Ctrl+X Ctrl+E` | Open in default text editor | Edit your prompt or custom response in your default text editor. `Ctrl+X Ctrl+E` is the readline-native binding | -| `Ctrl+L` | Redraw the screen | Repaints the current UI without clearing conversation history | +| `Ctrl+L` | Clear prompt input | Clears typed text, keeps conversation history | | `Ctrl+O` | Toggle verbose output | Shows detailed tool usage and execution. Also expands MCP read and search calls, which collapse to a single line like "Queried slack" by default | | `Ctrl+R` | Reverse search command history | Search through previous commands interactively | | `Ctrl+V` or `Cmd+V` (iTerm2) or `Alt+V` (Windows) | Paste image from clipboard | Inserts an `[Image #N]` chip at the cursor so you can reference it positionally in your prompt | diff --git a/content/en/docs/claude-code/keybindings.md b/content/en/docs/claude-code/keybindings.md index 1cd64f1af..ffa8c860d 100644 --- a/content/en/docs/claude-code/keybindings.md +++ b/content/en/docs/claude-code/keybindings.md @@ -75,13 +75,13 @@ Actions follow a `namespace:action` format, such as `chat:submit` to send a mess Actions available in the `Global` context: -| Action | Default | Description | -| :--------------------- | :------ | :-------------------------- | -| `app:interrupt` | Ctrl+C | Cancel current operation | -| `app:exit` | Ctrl+D | Exit Claude Code | -| `app:redraw` | Ctrl+L | Redraw the screen | -| `app:toggleTodos` | Ctrl+T | Toggle task list visibility | -| `app:toggleTranscript` | Ctrl+O | Toggle verbose transcript | +| Action | Default | Description | +| :--------------------- | :-------- | :-------------------------- | +| `app:interrupt` | Ctrl+C | Cancel current operation | +| `app:exit` | Ctrl+D | Exit Claude Code | +| `app:redraw` | (unbound) | Force terminal redraw | +| `app:toggleTodos` | Ctrl+T | Toggle task list visibility | +| `app:toggleTranscript` | Ctrl+O | Toggle verbose transcript | ### History actions @@ -100,6 +100,7 @@ Actions available in the `Chat` context: | Action | Default | Description | | :-------------------- | :------------------------ | :---------------------------------- | | `chat:cancel` | Escape | Cancel current input | +| `chat:clearInput` | Ctrl+L | Clear prompt input | | `chat:killAgents` | Ctrl+X Ctrl+K | Kill all background agents | | `chat:cycleMode` | Shift+Tab\* | Cycle permission modes | | `chat:modelPicker` | Cmd+P / Meta+P | Open model picker | diff --git a/content/en/docs/claude-code/model-config.md b/content/en/docs/claude-code/model-config.md index 3f188befb..c55d5de39 100644 --- a/content/en/docs/claude-code/model-config.md +++ b/content/en/docs/claude-code/model-config.md @@ -112,6 +112,10 @@ Without the `env` block, a user who selects Default in the picker would get the When `availableModels` is set at multiple levels, such as user settings and project settings, arrays are merged and deduplicated. To enforce a strict allowlist, set `availableModels` in managed or policy settings which take highest priority. +### Mantle model IDs + +When the [Bedrock Mantle endpoint](/en/amazon-bedrock#use-the-mantle-endpoint) is enabled, entries in `availableModels` that start with `anthropic.` are added to the `/model` picker as custom options and routed to the Mantle endpoint. This is an exception to the alias-only matching described in [Pin models for third-party deployments](#pin-models-for-third-party-deployments). The setting still restricts the picker to listed entries, so include the standard aliases alongside any Mantle IDs. + ## Special model behavior ### `default` model setting @@ -142,11 +146,11 @@ and Sonnet's efficiency for execution. Three levels persist across sessions: **low**, **medium**, and **high**. A fourth level, **max**, provides the deepest reasoning with no constraint on token spending, so responses are slower and cost more than at `high`. `max` is available on Opus 4.6 only and does not persist across sessions except through the `CLAUDE_CODE_EFFORT_LEVEL` environment variable. -Opus 4.6 and Sonnet 4.6 default to medium effort. This applies to all providers, including Bedrock, Vertex AI, and direct API access. +The default effort level depends on your plan. Pro and Max subscribers default to medium effort. All other users default to high effort: API key, Team, Enterprise, and third-party provider (Bedrock, Vertex AI, Foundry) users. -Medium is the recommended level for most coding tasks: it balances speed and reasoning depth, and higher levels can cause the model to overthink routine work. Reserve `high` or `max` for tasks that genuinely benefit from deeper reasoning, such as hard debugging problems or complex architectural decisions. +Your plan's default suits most coding tasks. Raise effort for work that benefits from deeper reasoning, such as hard debugging problems or complex architectural decisions. Higher levels can cause the model to overthink routine work. -For one-off deep reasoning without changing your session setting, include "ultrathink" in your prompt to trigger high effort for that turn. +For one-off deep reasoning without changing your session setting, include "ultrathink" in your prompt to trigger high effort for that turn. This has no effect if your session is already at high or max. **Setting effort:** diff --git a/content/en/docs/claude-code/output-styles.md b/content/en/docs/claude-code/output-styles.md index ce2d69cb4..d3c896bbb 100644 --- a/content/en/docs/claude-code/output-styles.md +++ b/content/en/docs/claude-code/output-styles.md @@ -88,7 +88,8 @@ tasks. [Your custom instructions here...] ``` You can save these files at the user level (`~/.claude/output-styles`) or -project level (`.claude/output-styles`). +project level (`.claude/output-styles`). [Plugins](/en/plugins-reference) can +also ship output styles in an `output-styles/` directory. ### Frontmatter diff --git a/content/en/docs/claude-code/plugins-reference.md b/content/en/docs/claude-code/plugins-reference.md index 6578f5c4b..5e4cd76ed 100644 --- a/content/en/docs/claude-code/plugins-reference.md +++ b/content/en/docs/claude-code/plugins-reference.md @@ -403,6 +403,7 @@ For `commands`, `agents`, `skills`, and `outputStyles`, custom paths replace the * Components from custom paths use the same naming and namespacing rules * Multiple paths can be specified as arrays * To keep the default directory and add more paths for commands, agents, skills, or output styles, include the default in your array: `"commands": ["./commands/", "./extras/deploy.md"]` +* When a skill path points to a directory that contains a `SKILL.md` directly, for example `"skills": ["./"]` pointing to the plugin root, the frontmatter `name` field in `SKILL.md` determines the skill's invocation name. This gives a stable name regardless of the install directory. If `name` is not set in the frontmatter, the directory basename is used as a fallback. **Path examples**: @@ -500,6 +501,8 @@ Plugins are specified in one of two ways: For security and verification purposes, Claude Code copies *marketplace* plugins to the user's local **plugin cache** (`~/.claude/plugins/cache`) rather than using them in-place. Understanding this behavior is important when developing plugins that reference external files. +Each installed version is a separate directory in the cache. When you update or uninstall a plugin, the previous version directory is marked as orphaned and removed automatically 7 days later. The grace period lets concurrent Claude Code sessions that already loaded the old version keep running without errors. + ### Path traversal limitations Installed plugins cannot reference files outside their directory. Paths that traverse outside the plugin root (such as `../shared-utils`) will not work after installation because those external files are not copied to the cache. diff --git a/content/en/docs/claude-code/plugins.md b/content/en/docs/claude-code/plugins.md index e3ad6e3b1..926dc31ab 100644 --- a/content/en/docs/claude-code/plugins.md +++ b/content/en/docs/claude-code/plugins.md @@ -74,12 +74,12 @@ This quickstart walks you through creating a plugin with a custom skill. You'll ```json my-first-plugin/.claude-plugin/plugin.json theme={null} { - "name": "my-first-plugin", - "description": "A greeting plugin to learn the basics", - "version": "1.0.0", - "author": { - "name": "Your Name" - } + "name": "my-first-plugin", + "description": "A greeting plugin to learn the basics", + "version": "1.0.0", + "author": { + "name": "Your Name" + } } ``` diff --git a/content/en/docs/claude-code/troubleshooting.md b/content/en/docs/claude-code/troubleshooting.md index 668e32b9e..fdc5975cd 100644 --- a/content/en/docs/claude-code/troubleshooting.md +++ b/content/en/docs/claude-code/troubleshooting.md @@ -642,6 +642,28 @@ If you see `API Error: 403 {"error":{"type":"forbidden","message":"Request not a * **Console users**: confirm your account has the "Claude Code" or "Developer" role assigned by your admin * **Behind a proxy**: corporate proxies can interfere with API requests. See [network configuration](/en/network-config) for proxy setup. +### Model not found or not accessible + +If you see `There's an issue with the selected model (...). It may not exist or you may not have access to it`, the API rejected the configured model name. + +Common causes: + +* A typo in the model name passed to `--model` +* A stale or deprecated model ID saved in your settings +* An API key without access to that model on your current usage tier + +Check where the model is set, in [priority order](/en/model-config#setting-your-model): + +* The `--model` flag +* The `ANTHROPIC_MODEL` environment variable +* The `model` field in `.claude/settings.local.json` +* The `model` field in your project's `.claude/settings.json` +* The `model` field in `~/.claude/settings.json` + +To clear a stale value, remove the `model` field from your settings or unset `ANTHROPIC_MODEL`, and Claude Code will fall back to the default model for your account. + +To browse models available to your account, start `claude` interactively and run `/model` to open the picker. For Vertex AI deployments, see [the Vertex AI troubleshooting section](/en/google-vertex-ai#troubleshooting). + ### "This organization has been disabled" with an active subscription If you see `API Error: 400 ... "This organization has been disabled"` despite having an active Claude subscription, an `ANTHROPIC_API_KEY` environment variable is overriding your subscription. This commonly happens when an old API key from a previous employer or project is still set in your shell profile. @@ -674,6 +696,8 @@ If Claude Code prompts you to log in again after a session, your OAuth token may Run `/login` to re-authenticate. If this happens frequently, check that your system clock is accurate, as token validation depends on correct timestamps. +On macOS, login can also fail when the Keychain is locked or its password is out of sync with your account password, which prevents Claude Code from saving credentials. Run `claude doctor` to check Keychain access. To unlock the Keychain manually, run `security unlock-keychain ~/Library/Keychains/login.keychain-db`. If unlocking doesn't help, open Keychain Access, select the `login` keychain, and choose Edit > Change Password for Keychain "login" to resync it with your account password. + ## Configuration file locations Claude Code stores configuration in several locations: diff --git a/content/en/docs/claude-code/ultraplan.md b/content/en/docs/claude-code/ultraplan.md index d6b4a03a5..fedc4bae3 100644 --- a/content/en/docs/claude-code/ultraplan.md +++ b/content/en/docs/claude-code/ultraplan.md @@ -7,7 +7,7 @@ > Start a plan from your CLI, draft it on Claude Code on the web, then execute it remotely or back in your terminal - Ultraplan is in research preview. Behavior and capabilities may change based on feedback. + Ultraplan is in research preview and requires Claude Code v2.1.91 or later. Behavior and capabilities may change based on feedback. Ultraplan hands a planning task from your local CLI to a [Claude Code on the web](/en/claude-code-on-the-web) session running in [plan mode](/en/permission-modes#analyze-before-you-edit-with-plan-mode). Claude drafts the plan in the cloud while you keep working in your terminal. When the plan is ready, you open it in your browser to comment on specific sections, ask for revisions, and choose where to execute it. @@ -18,7 +18,7 @@ This is useful when you want a richer review surface than the terminal offers: * **Hands-off drafting**: the plan is generated remotely, so your terminal stays free for other work * **Flexible execution**: approve the plan to run on the web and open a pull request, or send it back to your terminal -Ultraplan requires a [Claude Code on the web](/en/claude-code-on-the-web#who-can-use-claude-code-on-the-web) account and a GitHub repository. The cloud session runs in your account's default [cloud environment](/en/claude-code-on-the-web#cloud-environment). +Ultraplan requires a [Claude Code on the web](/en/claude-code-on-the-web#who-can-use-claude-code-on-the-web) account and a GitHub repository. Because it runs on Anthropic's cloud infrastructure, it is not available when using Amazon Bedrock, Google Cloud Vertex AI, or Microsoft Foundry. The cloud session runs in your account's default [cloud environment](/en/claude-code-on-the-web#cloud-environment). ## Launch ultraplan from the CLI diff --git a/content/en/docs/claude-code/vs-code.md b/content/en/docs/claude-code/vs-code.md index d513a4c8f..1ee3ae884 100644 --- a/content/en/docs/claude-code/vs-code.md +++ b/content/en/docs/claude-code/vs-code.md @@ -421,6 +421,8 @@ The server is named `ide` and is hidden from `/mcp` because there's nothing to c The Quick Pick confirmation is separate from `PreToolUse` hooks. An allowlist entry for `mcp__ide__executeCode` lets Claude *propose* running a cell; the Quick Pick inside VS Code is what lets it *actually* run. + + ## Fix common issues ### Extension won't install diff --git a/content/en/release-notes/overview.md b/content/en/release-notes/overview.md index c77d1744c..0864f0474 100644 --- a/content/en/release-notes/overview.md +++ b/content/en/release-notes/overview.md @@ -10,6 +10,10 @@ For release notes on Claude Apps, see the [Release notes for Claude Apps in the For updates to Claude Code, see the [complete CHANGELOG.md](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md) in the `claude-code` repository.
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  +### April 7, 2026 +- We announced [Claude Mythos Preview](https://anthropic.com/glasswing) is available as a gated research preview for defensive cybersecurity work as part of [Project Glasswing](https://anthropic.com/glasswing). Access is invitation-only. +- The [Messages API](/docs/en/api/messages) is now available on Amazon Bedrock as a research preview. The new Claude in Amazon Bedrock endpoint at `/anthropic/v1/messages` uses the same request shape as the first-party Claude API and runs on AWS-managed infrastructure with zero operator access. Available in `us-east-1`; contact your Anthropic account executive to request access. Learn more in [Claude in Amazon Bedrock](/docs/en/build-with-claude/claude-in-amazon-bedrock). + ### March 30, 2026 - We've raised the `max_tokens` cap to 300k on the [Message Batches API](/docs/en/build-with-claude/batch-processing#extended-output-beta) for Claude Opus 4.6 and Sonnet 4.6. Include the `output-300k-2026-03-24` beta header to generate longer single-turn outputs for long-form content, structured data, and large code generation tasks. - We're retiring the 1M token context window beta for Claude Sonnet 4.5 and Claude Sonnet 4 on **April 30, 2026**. After that date, the `context-1m-2025-08-07` beta header will have no effect on these models, and requests that exceed the standard 200k-token context window will return an error. To continue using 1M context windows, migrate to [Claude Sonnet 4.6](/docs/en/about-claude/models/overview#latest-models-comparison) or [Claude Opus 4.6](/docs/en/about-claude/models/overview#latest-models-comparison), which support the full 1M token context window at standard pricing with no beta header required. @@ -33,7 +37,7 @@ For updates to Claude Code, see the [complete CHANGELOG.md](https://github.com/a ### February 17, 2026 - We've launched [Claude Sonnet 4.6](https://www.anthropic.com/news/claude-sonnet-4-6), our latest balanced model combining speed and intelligence for everyday tasks. Sonnet 4.6 delivers improved agentic search performance while consuming fewer tokens. Sonnet 4.6 supports [extended thinking](/docs/en/build-with-claude/extended-thinking) and a [1M token context window](/docs/en/build-with-claude/context-windows) (beta). See [Models & Pricing](/docs/en/about-claude/models) for details. - API [code execution](/docs/en/agents-and-tools/tool-use/code-execution-tool) is now **free when used with web search or web fetch**. Sandboxed code execution improves model capability and token efficiency. See the [pricing details](/docs/en/agents-and-tools/tool-use/code-execution-tool#usage-and-pricing) for standalone usage. -- The [web search tool](/docs/en/agents-and-tools/tool-use/web-search-tool) and [programmatic tool calling](/docs/en/agents-and-tools/tool-use/programmatic-tool-calling) are now generally available (no beta header required). Web search and web fetch now support [dynamic filtering](/docs/en/agents-and-tools/tool-use/web-search-tool#dynamic-filtering-with-opus-46-and-sonnet-46), which uses code execution to filter results before they reach the context window for better performance and reduced token cost. +- The [web search tool](/docs/en/agents-and-tools/tool-use/web-search-tool) and [programmatic tool calling](/docs/en/agents-and-tools/tool-use/programmatic-tool-calling) are now generally available (no beta header required). Web search and web fetch now support [dynamic filtering](/docs/en/agents-and-tools/tool-use/web-search-tool#dynamic-filtering), which uses code execution to filter results before they reach the context window for better performance and reduced token cost. - The [code execution tool](/docs/en/agents-and-tools/tool-use/code-execution-tool), [web fetch tool](/docs/en/agents-and-tools/tool-use/web-fetch-tool), [tool search tool](/docs/en/agents-and-tools/tool-use/tool-search-tool), [tool use examples](/docs/en/agents-and-tools/tool-use/define-tools#providing-tool-use-examples), and [memory tool](/docs/en/agents-and-tools/tool-use/memory-tool) are now generally available (no beta header required). ### February 7, 2026 diff --git a/content/en/test-and-evaluate/strengthen-guardrails/increase-consistency.md b/content/en/test-and-evaluate/strengthen-guardrails/increase-consistency.md index 6722ac9ee..13a551b9c 100644 --- a/content/en/test-and-evaluate/strengthen-guardrails/increase-consistency.md +++ b/content/en/test-and-evaluate/strengthen-guardrails/increase-consistency.md @@ -26,7 +26,7 @@ Precisely define your desired output format using JSON, XML, or custom templates ## Prefill Claude's response -Prefilling is not supported on Claude Opus 4.6 and Claude Sonnet 4.6. Use [structured outputs](/docs/en/build-with-claude/structured-outputs) or system prompt instructions instead. +Prefilling is not supported on [Claude Mythos Preview](https://anthropic.com/glasswing), Claude Opus 4.6, and Claude Sonnet 4.6. Use [structured outputs](/docs/en/build-with-claude/structured-outputs) or system prompt instructions instead. Prefill the `Assistant` turn with your desired format. This trick bypasses Claude's friendly preamble and enforces your structure. diff --git a/content/en/test-and-evaluate/strengthen-guardrails/reduce-prompt-leak.md b/content/en/test-and-evaluate/strengthen-guardrails/reduce-prompt-leak.md index 13028228e..96f651cb2 100644 --- a/content/en/test-and-evaluate/strengthen-guardrails/reduce-prompt-leak.md +++ b/content/en/test-and-evaluate/strengthen-guardrails/reduce-prompt-leak.md @@ -16,7 +16,7 @@ If you decide to implement leak-resistant techniques, be sure to test your promp ## Strategies to reduce prompt leak - **Separate context from queries:** -You can try using system prompts to isolate key information and context from user queries. You can emphasize key instructions in the `User` turn, then reemphasize those instructions by prefilling the `Assistant` turn. (Note: prefilling is not supported on Claude Opus 4.6 and Sonnet 4.6.) +You can try using system prompts to isolate key information and context from user queries. You can emphasize key instructions in the `User` turn, then reemphasize those instructions by prefilling the `Assistant` turn. (Note: prefilling is not supported on [Claude Mythos Preview](https://anthropic.com/glasswing), Claude Opus 4.6, and Sonnet 4.6.)