Skip to main content
POST
UpsertOwner

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
id
string<uuid>

Opaque id of the owner (a UUID). The same id updates the same owner; a new id creates a new owner.

title
string | null

Owner name. Required when creating; omit to keep the existing name on update.

Required string length: 1 - 500
contacts
ContactList · object | null

Notification channels. Omit to leave the existing contacts unchanged; pass a present (possibly empty) list to replace them.

source
enum<string> | null

Source. Omit to keep the existing source (defaults to SOURCE_SYNQ on create).

Available options:
SOURCE_SYNQ,
SOURCE_ATLAN
etag
string | null

Optional optimistic-concurrency guard. When set, the update fails with a conflict if the owner was modified since this etag was read.

actor
Actor · object

Who is performing this write. Optional — identity is completed from the calling credentials; set it to attribute the change on behalf of a user.

Response

200 - application/json

Success

owner
Owner · object

The stored owner after the upsert.