Skip to main content
POST
Create Clarity Landscape Node

Authorizations

Authorization
string
header
required

API key authentication. Get your API key from the Duvo dashboard.

Path Parameters

orgId
string<uuid>
required

Body

application/json
name
string
required
Required string length: 1 - 200
parentId
string<uuid> | null
ownerLabel
string | null
Maximum string length: 200
description
string | null

One or two sentences saying what family of work this area groups. Persisted as the area's summary.

Maximum string length: 2000
creationMode
enum<string>
default:active

Use "proposal" to add an area for review instead of asserting it exists. A proposal is idempotent: an equivalent live area under the same parent is returned untouched rather than duplicated.

Available options:
active,
proposal

Response

Default Response

id
string<uuid>
required
parentId
string<uuid> | null
required
processId
string<uuid> | null
required
name
string
required
ownerLabel
string | null
required
sortOrder
number
required
existence
enum<string>
required
Available options:
proposed,
active
contentConfirmedAt
string | null
required
existenceConfirmedAt
string | null
required
source
enum<string>
required
Available options:
ai,
human
priority
enum<string> | null
required
Available options:
high,
medium,
low
priorityReasoning
string | null
required
priorityAssessedAt
string | null
required
createdAt
string
required
updatedAt
string
required
team
object | null
required
outcome
enum<string>
required

Whether this call inserted a new node or returned an equivalent one that already existed. Only "proposal" mode can report "reused".

Available options:
created,
reused