Clay logo

LeadMagic has made more than one billion API calls with Clay and won The Unstoppable Wheel award.

Recap
LeadMagicDocs

Update Batch Metadata

Update the metadata or client association for a batch submission. Only available within 7 days of submission.

PATCHhttps://api.leadmagic.io/v1/{product}/batch/{batchId}
Try this endpointOpen the API playground

Endpoint Details

PATCH /v1/:product/batch/:batchId updates the metadata and/or client association for a batch. Only batches created within the last 7 days can be updated.

MetricValue
CostFREE: updating metadata does not consume credits

Quick Example


Request Parameters

batchId
string
path
required
UUID of the batch (path param).
product
string
path
required
Product name (path param).
metadata
object
Arbitrary metadata to attach. Replaces existing metadata.
client_id
string
Client ID to associate or reassign.

Batches older than 7 days cannot be updated. Returns 400 with a message indicating the batch is locked.

batch_id
string
UUID.
metadata
object
Updated metadata.
client_id
string
Updated client ID.

200

OK

400

Bad Request: batch older than 7 days

401

Unauthorized

404

Not Found

429

Rate Limit