Bases
Change Requests

Create bulk record Change Request in Base

post/api/v1/bases/{baseId}/records/bulk-change-request

Request

  • Base URL: https://api-docs.busabase.com
  • URL: https://api-docs.busabase.com/api/v1/bases/{baseId}/records/bulk-change-request
  • Auth: none declared

Path parameters

baseIdstring required

Request body

recordsobject[] required

Field-value maps, one per record to create, each keyed by field slug. All records are proposed as a SINGLE change request (one review, one merge) — use this to import/seed many rows at once instead of one change request per record. Capped at 1000; for very large loads prefer a dedicated import job. Always give each record's PRIMARY field a short human-readable value.

messagestring

Explanation shown to the human reviewer for the whole batch — e.g. "Import 240 June webinar leads".

submittedBystring
idempotencyKeystring

Optional client-supplied key that dedupes retries. Scoped per base + submitter: calling this endpoint again with the SAME idempotencyKey returns the bulk change request created by the first call instead of creating a duplicate. Omit for normal one-shot calls; only set it when you might retry.

autoMergeboolean

Response

Created one change request proposing many record creates.

idstring required
baseIdstring required
targetType'base' | 'node' required
nodeIdstring required
status'in_review' | 'changes_requested' | 'approved' | 'rejected' | 'merged' | 'abandoned' | 'conflict' required
submittedBystring required
sourceMetaobject required
reviewPolicySnapshotobject required
mergeSummaryobject required

Filled in when the change request merges. slugChanges (present only when non-empty) lists items a restore brought back under a new slug because another item took the old one while they were in the Trash: { nodeId, nodeType, name, fromSlug, toSlug }. Read the new slug from here instead of assuming the old one.

rejectedReasonstring required
reviewedAtstring required
mergedAtstring required
createdAtstring required
updatedAtstring required
operationCountnumber required

Changes

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