Catalog Activities

Create Custom Transform Activity

Create a custom transform activity with full audit metadata.

This is the primary endpoint for MCP tool servers to create reviewable activities with script provenance, diff summaries, and validation reports.

post/public/catalogs/{catalog_id}/activities/custom-transform

Request

catalog_idstring required

X-Organization-Idstring nullable

activity_messagestring required

Human-readable description (e.g., 'Q2 price update')

scriptobject nullable

Transform script metadata: {filename, content, sha256}

diff_summaryobject nullable

Diff summary: {rows_before, rows_after, rows_added, rows_removed, rows_modified, ...}

validation_reportobject nullable

Bundle validation report

schema_changesobject nullable

Schema changes to apply alongside row changes

taxonomy_changesobject nullable

Taxonomy changes to apply alongside row changes

attachmentsobject[] nullable

Optional attachment metadata used in this session (files, urls, sheet names)

activity_contextobject nullable

Optional activity context for auditability (tool params, notes, attachment refs, etc.)

session_contextobject nullable

Deprecated alias for activity_context.session_context

base_snapshot_idstring nullable

Optional snapshot ID for audit trail

Successful Response

activity_idstring required

statusstring required

staged_countinteger required

review_urlstring required

No recorded changes to this operation across all 1 revision of this API.