Follow Discord
Sweep 22 Oct 2026 · 21:04Z Build v2.1.309 528 read Stable v2.1.308 Latest v2.1.308 Next v2.1.309 Feeds RSS JSON llms.txt llms-full.txt Unofficial
HomeDocsClaude Developer Platform 25 Aug 2026
One change · api

Create User Profile changedapi/beta/user_profiles/create

Nearest release: v2.1.245, published an hour after this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.

Recorded here
Lines+20added
Lines−19removed
From line 1 where the diff opens
First seen 14 Aug 2026 this site's first read of the page
Recorded edits20to this page, all time

# Create User Profile ## Headers ## Body parameters ## Returns ## Example ### Response (200) ## Create User Profile ### Header Parameters ### Body Parameters ### Returns ### Example #### Response

The whole hunk

from line 1, old and new numbered
/
lines
from line 1
1---
2title: Create User Profile
3url: https://platform.claude.com/docs/en/api/beta/user_profiles/create
4---
1# Create User Profile
52 
6## Create User Profile
3**POST** `/v1/user_profiles`
74 
8**post** `/v1/user_profiles`
9 
105Create User Profile
116 
12### Header Parameters
7## Headers
138 
149- `"anthropic-beta": optional array of AnthropicBeta`
1510 
from line 82
8782 
8883 - `"mid-conversation-tool-changes-2026-07-01"`
8984 
90### Body Parameters
85## Body parameters
9186 
9287- `access_type: optional "application" or "passthrough"`
9388 
from line 96
10196 
10297 Platform's own identifier for this user. Not enforced unique. Maximum 255 characters.
10398 
99 minLength: 1, maxLength: 255
100 
104101- `metadata: optional map[string]`
105102 
106103 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.
from line 106
109106 
110107 Optional for all profiles. Real-world name of the entity this profile represents (company or individual); for a resold-to company (`relationship` `resold` / `access_type` `passthrough`), that company's name where known. Maximum 255 characters.
111108 
109 minLength: 1, maxLength: 255
110 
112111- `relationship: optional "external" or "resold" or "internal"`
113112 
114113 How the entity behind a user profile relates to the platform that owns the API key. `external`: an individual end-user of the platform. `resold`: a company the platform resells Claude access to. `internal`: the platform's own usage.
from line 118
119118 
120119 - `"internal"`
121120 
122### Returns
121## Returns
123122 
124- `BetaUserProfile object { id, created_at, metadata, 7 more }`
123- `BetaUserProfile object`
125124 
126125 - `id: string`
127126 
from line 130
131130 
132131 A timestamp in RFC 3339 format
133132 
133 format: date-time
134 
134135 - `metadata: map[string]`
135136 
136137 Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.
from line 154
153154 
154155 Object type. Always `user_profile`.
155156 
156 - `"user_profile"`
157 
158157 - `updated_at: string`
159158 
160159 A timestamp in RFC 3339 format
161160 
161 format: date-time
162 
162163 - `access_type: optional "application" or "passthrough"`
163164 
164165 How the platform uses the API on behalf of the entity this profile represents. `application`: the platform sells a product that uses the API behind the scenes, and the profile represents an individual end-user of that product. `passthrough`: the platform resells raw inference, and the profile identifies the resold-to company.
from line 186
185186 
186187 - `"internal"`
187188 
188### Example
189## Example
189190 
190```http
191```bash
191192curl https://api.anthropic.com/v1/user_profiles \
192193 -H 'Content-Type: application/json' \
193194 -H 'anthropic-version: 2023-06-01' \
from line 200
199200 }'
200201```
201202 
202#### Response
203### Response (200)
203204 
204205```json
205206{
Feedback