v97

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-31135175384.2 KB
Profiles

Rename profile by ID or name

Update a profile's name. Names must be unique within the logical project; during the default-project migration, unscoped profiles and profiles in the org default project are treated as the same project. Duplicate-name conflicts are checked before update but are best-effort because there is no backing unique index. Renaming a profile while a browser session references it by name may prevent that session's changes from saving; prefer renaming when the profile is not in use.

patch/profiles/{id_or_name}

Path parameters

id_or_namestring required

Profile ID or profile name

Request body

namestring required

New profile name. Must be unique within the logical project; during the default-project migration, unscoped profiles and profiles in the org default project are treated as the same project.

Example request

{
  "name": "my-renamed-profile"
}

Response

Profile updated

idstring required

Unique identifier for the profile

namestring nullable

Optional, easier-to-reference name for the profile

created_atstring date-time required

Timestamp when the profile was created

updated_atstring date-time

Timestamp when the profile was last updated

last_used_atstring date-time

Timestamp when the profile was last used