Skip to main content
PATCH
Update a custom-object record

Authorizations

Authorization
string
header
required

An organization API key, created in Settings → Integrations → API keys. Keys start with mk_live_. Marro stores only a hash of a key, so it is shown once, when it is created: copy it then. Revoking a key ends its access at once. To replace a key without downtime, create the new one, switch your server to it, then revoke the old one. Changes made with a key appear on the lead’s timeline as made by the person who created the key, via the API. Scopes: objects.records.read (Read custom objects), objects.records.write (Create and update custom-object records), objects.records.delete (Delete custom-object records), leads.read (Read leads), leads.write (Create and update leads), leads.capture (Capture leads), crm.records.read (Read customers and opportunities), crm.records.write (Create and update customers and opportunities), reports.read (Read reports), money.read (Read products, quotes, invoices and payments), money.write (Create quotes and invoices and record payments), agent.tools (AI agent tools (MCP)).

Scopes

objects.records.write

Path Parameters

slug
string
required

The object’s immutable address, from List custom objects.

Pattern: ^[a-z][a-z0-9-]{0,47}$
recordId
integer
required

Record ID.

Required range: x >= 1

Body

application/json
version
integer
required
Required range: x <= 2147483647
values
object

Public field keys. record_link values are numeric target ID arrays (one or up to 20 according to field configuration); names and read projections cannot be submitted.

ownerId
integer
Required range: x <= 2147483647
ownerTeamId
integer

Give the record to the member of this team whose turn it is (the one given a record of this object longest ago). Not with ownerId.

Required range: x <= 2147483647
archived
boolean

Response

Updated record with a new version.

record
object
required