Upsert
Create or update a data product. The id is supplied by the caller (a UUID);
repeating the same request converges to the same product. Mutable fields are
optional: a set field is written, an omitted field is left unchanged. Pass
etag to guard against overwriting a concurrent edit.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Opaque id of the product. Accepts either the bare UUID or the entity_id
form this API returns (dataproduct-<uuid>) — the prefix is stripped
server-side, so the value you read back from any API can be passed straight
in. The same id updates the same product; a new id creates a new product.
^(dataproduct-)?[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$Title. Required when creating; omit to keep the existing title on update.
1 - 500Description. Omit to keep the existing description.
10000Folder. Omit to keep the existing folder; pass an empty string to clear it.
500Priority. Omit to keep the existing priority.
PRIORITY_UNSPECIFIED, PRIORITY_P3, PRIORITY_P2, PRIORITY_P1 Source. Omit to keep the existing source (defaults to SOURCE_SYNQ on create).
SOURCE_SYNQ, SOURCE_ATLAN Membership definition. Omit to keep the existing definition; pass a present (possibly empty) definition to replace it.
Optional optimistic-concurrency guard. When set, the update fails with a conflict if the product was modified since this etag was read.
Who is performing this write. Optional — identity is completed from the calling credentials; set it to attribute the change on behalf of a user.
- Actor
- Actor
- Actor
Response
Success
The stored product after the upsert.