manage_record

Create, read, update, or delete individual records. Uses PUT for upsert. Supply external_id (and optional external_source) for idempotent writes from external systems — the internal UUID is auto-generated. Use record_id (internal UUID) for get/delete or to update a known record.

Parameters

NameTypeRequiredDescription
actionenum: upsert | get | deleteYes
workspace_idstringYesTarget workspace ID
collectionstringYesCollection name or ID
record_idstringNoInternal record ID (UUID). Required for get/delete. For upsert, use to update a known record by internal ID.
external_idstringNoExternal/agent-supplied ID for upsert. Enables idempotent upsert by external identity (e.g. stripe_inv_123).
external_sourcestringNoSource system for external_id (e.g. 'stripe', 'salesforce'). Scopes uniqueness of external_id.
dataobjectNoRecord data conforming to collection schema