v1

latestOpenAPI 3.0.32026-07-222111928.0 KB

Organizations

Clarity

Propose Clarity Landscape Process

Create a manual process in the organization's Process Landscape, either as an unassigned proposal or atomically assigned to an eligible team.

post/v2/organizations/{orgId}/clarity/hierarchy/proposed-processes

Path parameters

orgIdstring uuid required

Request body

namestring required

descriptionstring nullable

One short paragraph (1-3 sentences) saying why this process belongs in the landscape. Use only what you saw in the captures. Say what the process is (don't just repeat the name), show proof it really happens, and name where you heard it - be as specific as the captures allow, like "a warehouse lead said so in their interview" or "it came up in two returns recordings". Use only facts from the captures: never make up sources, people, dates, quotes, or numbers, and don't stretch what was said. If you have no real proof the process happens, don't propose it.

parentIdstring uuid nullable

teamIdstring uuid nullable

Response

Default Response

idstring uuid required

parentIdstring uuid nullable required

processIdstring uuid nullable required

namestring required

ownerLabelstring nullable required

sortOrdernumber required

existence'proposed' | 'active' required

contentConfirmedAtstring nullable required

existenceConfirmedAtstring nullable required

source'ai' | 'human' required

createdAtstring required

updatedAtstring required