v2
latestOpenAPI 3.1.02026-08-075421692.0 MBProfiles
Create profile
Creates a new profile with a name, optional description, and color. Names are unique per workspace: a duplicate returns a 409 whose details.existingProfileId carries the id of the existing profile. Send an Idempotency-Key header to make retries safe: a retried create with the same key and body replays the original 201 (same _id) instead of conflicting.
post/v1/profiles
Headers
Idempotency-Keystring
Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409.
Request body
Example request
{
"color": "#ffeda0"
}Response
Created