Action URLs changedapi/user_profiles/action_urls

Nearest release: v2.1.306, published 2 hours 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 21 Oct 2026 00:07 UTC

Lines+130added

Lines−0removed

From line — no hunk to open at

First seen 21 Oct 2026 this site's first read of the page

Recorded edits2to this page, all time

# Action URLs ## Create Action URL ### Path parameters ### Headers ### Body parameters ### Returns ### Example #### Response (200) ## Domain types ### User Profile Action ### User Profile Action URL ### User Profile Enroll End User Action

The whole hunk

130 lines, new page

lines

A whole new page. There's nothing to diff it against, so here is what it says.

---
title: Action URLs
url: https://platform.claude.com/docs/en/api/user_profiles/action_urls
---

# Action URLs

## Create Action URL

**POST** `/v1/user_profiles/{user_profile_id}/action_urls`

Create Action URL

### Path parameters

- `user_profile_id: string`

  The ID of the user profile the action is for (`uprof_...`).

### Headers

- `"anthropic-version": optional string`

  The version of the Claude API you want to use.

  Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning?sdk_languages=http).

- `"anthropic-workspace-id": optional string`

  Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).

  Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.

### Body parameters

- `action: UserProfileAction`

  The action that the person who opens the URL takes.

  - `UserProfileEnrollEndUserAction object`

    The end-user that the profile represents enrolls in a program.

    - `type: "enroll_end_user"`

### Returns

- `UserProfileActionURL object`

  A URL to give to the person who takes the requested action.

  - `type: "user_profile_action_url"`

    Object type. Always `user_profile_action_url`.

  - `expires_at: string`

    When the URL stops working, in RFC 3339 format.

    format: date-time

  - `url: string`

    The URL to give to the person who takes the action. Anyone who holds it can open it until `expires_at`.

### Example

```bash
curl https://api.anthropic.com/v1/user_profiles/$USER_PROFILE_ID/action_urls \
    -H 'Content-Type: application/json' \
    -H 'anthropic-version: 2023-06-01' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY" \
    -d '{
          "action": {
            "type": "enroll_end_user"
          }
        }'
```

#### Response (200)

```json
{
  "expires_at": "2026-03-15T10:15:00Z",
  "type": "user_profile_action_url",
  "url": "https://platform.claude.com/user-profiles/enrollment/M3J0bGJxZ2ppMnptbnB1"
}
```

## Domain types

### User Profile Action

- `UserProfileAction = UserProfileEnrollEndUserAction`

  The action that the person who opens the URL takes, discriminated by `type`.

  - `UserProfileEnrollEndUserAction object`

    The end-user that the profile represents enrolls in a program.

    - `type: "enroll_end_user"`

### User Profile Action URL

- `UserProfileActionURL object`

  A URL to give to the person who takes the requested action.

  - `type: "user_profile_action_url"`

    Object type. Always `user_profile_action_url`.

  - `expires_at: string`

    When the URL stops working, in RFC 3339 format.

    format: date-time

  - `url: string`

    The URL to give to the person who takes the action. Anyone who holds it can open it until `expires_at`.

### User Profile Enroll End User Action

- `UserProfileEnrollEndUserAction object`

  The end-user that the profile represents enrolls in a program.

  - `type: "enroll_end_user"`