API reference / Collectors

Scans

Scanning books in: captures (barcodes, cover and slab photos, search picks), matching, fixing the match, and adding the copy.

POST/api/v1/scans

Create a scan

Signed inIdempotent

From a barcode decode, a photo capture (upload it, then process the scan) or a pick from search. Idempotent on clientKey: a retried capture returns the scan it already made. Barcode and manual scans are matched right away when process is true. 240 a minute.

SDK: collector.createScan()
Key scopes: scans:write(API keys are coming soon)
Headers: Idempotency-KeyX-Request-Id

Request body (required, application/json)

object

clientKeystringrequired8–80 characters
batchIdstring (uuid) or nulloptional
modeenumrequired
One ofbarcodecoverslabmanual
intentenumoptional
One ofownedwishlist
barcodeobject or nulloptional
Fields of barcode
- textstringrequired6–40 characters
- addOnstring or nulloptional
- formatstring or nulloptionalat most 20 characters
addOnMissingbooleanoptional
slabQrstring or nulloptionalat most 600 characters
coverHashstring or nulloptional
devicestring or nulloptionalat most 40 characters
selectionobject or nulloptional
Fields of selection
- issueIdstring (uuid) or nullrequired
- editionIdstring (uuid) or nullrequired
- providerobject or nullrequired
  Fields of provider
  providerenumrequired
  One ofmetrongcdcataloggd
  issueIdstringrequired1–262 characters
  variantIdstring or nulloptionalat most 200 characters
- seriesIdstring (uuid) or nullrequired
- seriesTitlestringrequired1–300 characters
- seriesStartYearinteger or nullrequired1800–2200
- seriesVolumeinteger or nullrequired0–999
- publisherstring or nullrequiredat most 200 characters
- numberstringrequired1–40 characters
- issueTitlestring or nullrequiredat most 300 characters
- coverDatestring or nullrequiredat most 40 characters
- coverUrlstring (uri) or nullrequiredat most 2000 characters
- editionNamestring or nullrequiredat most 300 characters
- releaseLabelstring or nulloptionalat most 400 characters
- coverVariantstring or nullrequiredat most 120 characters
- printinginteger or nullrequired1–99
- upcstring or nullrequiredat most 20 characters
- upcAddonstring or nullrequiredat most 5 characters
- isKeybooleanrequired
- scorenumberrequired0–1
- reasonsarray of stringrequiredat most 12 items
- sourceenumrequired
  One ofbarcodecovermemorysearchmanualprovisional
- exactbooleanrequired
- ownedCopiesintegerrequiredat least 0
- selectedbooleanoptional
- editionUnknownbooleanoptional
- pendingVariantobject or nulloptional
  Fields of pendingVariant
  idstring (uuid)required
  labelstringrequiredat most 300 characters
processbooleanoptional

Responses

200The scan (new, or the one this clientKey already made).
object
- scanScanItemrequired

Errors (400, 401, 404, 409, 422, 429, 500)

400invalid_request invalid_json invalid_idempotency_key invalid_barcode invalid_candidate invalid_cert
invalid_request: The query or body doesn’t match the schema (see errors[]).
invalid_json: The body isn’t JSON.
invalid_idempotency_key: The Idempotency-Key isn’t 1–255 visible ASCII characters.
invalid_barcode: The barcode isn’t a UPC, EAN or ISBN.
invalid_candidate: The picked candidate doesn’t name a book.
invalid_cert: The slab QR code’s cert number isn’t one.
401unauthorized
unauthorized: Not signed in (no session or token, or an expired one).
404batch_not_found
batch_not_found: No open session of yours with that batchId.
409idempotency_in_progress
idempotency_in_progress: The first request with this key is still running.
422idempotency_key_reused
idempotency_key_reused: This key was used for a different request.
429rate_limited
rate_limited: Scanning faster than 240 a minute; wait the Retry-After seconds.
500internal
internal: Something went wrong on our side (quote the requestId).

curl

curl -X POST 'https://collection.id/api/v1/scans' \
  -H "Authorization: Bearer $COLLECTOR_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H 'Content-Type: application/json' \
  -d @body.json

TypeScript SDK

await collector.createScan({ body: { … } });

DELETE/api/v1/scans/{id}

Delete a scan

Signed in

Removes the scan and its photos. A copy it was added as stays in the collection.

SDK: collector.deleteScan()
Key scopes: scans:write(API keys are coming soon)
Headers: X-Request-Id

Parameters

Name	In	Type	About
`id`required	path	string (uuid)	The scan’s id.

Responses

200Deleted.
object
- ok"true"required

Errors (401, 404, 500)

401unauthorized
unauthorized: Not signed in (no session or token, or an expired one).
404not_found scan_not_found
not_found: Nothing at that address.
scan_not_found: No scan of yours with that id.
500internal
internal: Something went wrong on our side (quote the requestId).

curl

curl -X DELETE 'https://collection.id/api/v1/scans/<id>' \
  -H "Authorization: Bearer $COLLECTOR_TOKEN"

TypeScript SDK

await collector.deleteScan({ path: { id } });

PATCH/api/v1/scans/{id}

Update a scan

Signed in

Pick a candidate (select: { index }, or a search result as select: { candidate }; null clears the pick), choose the edition, edit the copy draft, change the intent, skip it, or restore a skipped scan.

SDK: collector.updateScan()
Key scopes: scans:write(API keys are coming soon)
Headers: X-Request-Id

Parameters

Name	In	Type	About
`id`required	path	string (uuid)	The scan’s id.

Request body (required, application/json)

object

selectobject or object or nulloptional
Fields of select
1. Option 1: object
  indexintegerrequired0–20
2. Option 2: object
  candidateobjectrequired
  Fields of candidate
  issueIdstring (uuid) or nullrequired
  editionIdstring (uuid) or nullrequired
  providerobject or nullrequired
  Fields of provider
  providerenumrequired
  One ofmetrongcdcataloggd
  issueIdstringrequired1–262 characters
  variantIdstring or nulloptionalat most 200 characters
  seriesIdstring (uuid) or nullrequired
  seriesTitlestringrequired1–300 characters
  seriesStartYearinteger or nullrequired1800–2200
  seriesVolumeinteger or nullrequired0–999
  publisherstring or nullrequiredat most 200 characters
  numberstringrequired1–40 characters
  issueTitlestring or nullrequiredat most 300 characters
  coverDatestring or nullrequiredat most 40 characters
  coverUrlstring (uri) or nullrequiredat most 2000 characters
  editionNamestring or nullrequiredat most 300 characters
  releaseLabelstring or nulloptionalat most 400 characters
  coverVariantstring or nullrequiredat most 120 characters
  printinginteger or nullrequired1–99
  upcstring or nullrequiredat most 20 characters
  upcAddonstring or nullrequiredat most 5 characters
  isKeybooleanrequired
  scorenumberrequired0–1
  reasonsarray of stringrequiredat most 12 items
  sourceenumrequired
  One ofbarcodecovermemorysearchmanualprovisional
  exactbooleanrequired
  ownedCopiesintegerrequiredat least 0
  selectedbooleanoptional
  editionUnknownbooleanoptional
  pendingVariantobject or nulloptional
  Fields of pendingVariant
  idstring (uuid)required
  labelstringrequiredat most 300 characters
draftobjectoptional
Fields of draft
- gradenumber or nulloptional0.5–10
- grading_companyenum or nulloptional
  One ofcgccbcspsapgxegshgaother
- cert_numberstring or nulloptionalat most 64 characters
- label_typestring or nulloptionalat most 40 characters
- page_qualityenum or nulloptional
  One ofwhiteoff_white_to_whiteoff_whitecream_to_off_whitecreamlight_tantanbrittle
- is_signedbooleanoptional
- signaturesarray of stringoptionalat most 12 items
- signature_authenticationenum or nulloptional
  One ofcgc_signature_seriescbcs_verifiedpsa_dnacoawitnessedunverified
- purchase_price_centsinteger or nulloptional0–1000000000
- acquired_onstring or nulloptional
- locationstring or nulloptionalat most 120 characters
- tagsarray of stringoptionalat most 30 items
- notesstring or nulloptionalat most 8000 characters
intentenumoptional
One ofownedwishlist
skipbooleanoptional
restorebooleanoptional
editionobject or object or "unknown"optional
Fields of edition
1. Option 1: object
  editionIdstring (uuid)required
2. Option 2: object
  pendingVariantIdstring (uuid)required
3. Option 3: "unknown"

Responses

200The scan as it is now.
object
- scanScanItemrequired

Errors (400, 401, 404, 409, 500)

400invalid_request invalid_json invalid_candidate
invalid_request: The query or body doesn’t match the schema (see errors[]).
invalid_json: The body isn’t JSON.
invalid_candidate: The picked candidate doesn’t name a book.
401unauthorized
unauthorized: Not signed in (no session or token, or an expired one).
404not_found scan_not_found
not_found: Nothing at that address.
scan_not_found: No scan of yours with that id.
409already_added
already_added: The scan was already added as a copy.
500internal
internal: Something went wrong on our side (quote the requestId).

curl

curl -X PATCH 'https://collection.id/api/v1/scans/<id>' \
  -H "Authorization: Bearer $COLLECTOR_TOKEN" \
  -H 'Content-Type: application/json' \
  -d @body.json

TypeScript SDK

await collector.updateScan({ path: { id }, body: { … } });

POST/api/v1/scans/{id}/add

Add a scan to the collection

Signed inIdempotent

Adds the chosen (or top) candidate as a copy, with the session’s defaults and the scan’s draft. The body is optional: index adds another candidate, draft sets copy fields. Adding twice answers the same copy.

SDK: collector.addScan()
Key scopes: scans:writecollection:write(API keys are coming soon)
Headers: Idempotency-KeyX-Request-Id

Parameters

Name	In	Type	About
`id`required	path	string (uuid)	The scan’s id.

Request body (optional, application/json)

object

indexintegeroptional0–20
draftobjectoptional
Fields of draft
- gradenumber or nulloptional0.5–10
- grading_companyenum or nulloptional
  One ofcgccbcspsapgxegshgaother
- cert_numberstring or nulloptionalat most 64 characters
- label_typestring or nulloptionalat most 40 characters
- page_qualityenum or nulloptional
  One ofwhiteoff_white_to_whiteoff_whitecream_to_off_whitecreamlight_tantanbrittle
- is_signedbooleanoptional
- signaturesarray of stringoptionalat most 12 items
- signature_authenticationenum or nulloptional
  One ofcgc_signature_seriescbcs_verifiedpsa_dnacoawitnessedunverified
- purchase_price_centsinteger or nulloptional0–1000000000
- acquired_onstring or nulloptional
- locationstring or nulloptionalat most 120 characters
- tagsarray of stringoptionalat most 30 items
- notesstring or nulloptionalat most 8000 characters

Responses

200The scan, and the copy it was added as.
object
- scanScanItemrequired
- itemIdstring (uuid)required
  The copy in the collection.

Errors (400, 401, 404, 409, 422, 500)

400invalid_request invalid_json invalid_idempotency_key invalid_candidate invalid_copy
invalid_request: The query or body doesn’t match the schema (see errors[]).
invalid_json: The body isn’t JSON.
invalid_idempotency_key: The Idempotency-Key isn’t 1–255 visible ASCII characters.
invalid_candidate: The chosen candidate doesn’t name a book.
invalid_copy: The copy fields aren’t valid together.
401unauthorized
unauthorized: Not signed in (no session or token, or an expired one).
404not_found scan_not_found
not_found: Nothing at that address.
scan_not_found: No scan of yours with that id.
409idempotency_in_progress no_match still_matching
idempotency_in_progress: The first request with this key is still running.
no_match: Nothing to add: the scan matched no book.
still_matching: The scan is still being matched; try again shortly.
422idempotency_key_reused
idempotency_key_reused: This key was used for a different request.
500internal
internal: Something went wrong on our side (quote the requestId).

curl

curl -X POST 'https://collection.id/api/v1/scans/<id>/add' \
  -H "Authorization: Bearer $COLLECTOR_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H 'Content-Type: application/json' \
  -d @body.json

TypeScript SDK

await collector.addScan({ path: { id }, body: { … } });

POST/api/v1/scans/{id}/process

Match a scan

Signed in

Matches (or re-matches) a scan: a barcode lookup, then an AI read of the cover or slab photo when one was uploaded and the barcode didn’t settle it. The body is optional: the uploaded imagePath and thumbPath, a typed addOn, coverHash, mode, or rereadPhoto: true. 30 a minute.

SDK: collector.processScan()
Key scopes: scans:write(API keys are coming soon)
Headers: X-Request-Id

Parameters

Name	In	Type	About
`id`required	path	string (uuid)	The scan’s id.

Request body (optional, application/json)

object

imagePathstring or nulloptionalat most 400 characters
thumbPathstring or nulloptionalat most 400 characters
addOnstring or nulloptional
coverHashstring or nulloptional
modeenumoptional
One ofbarcodecoverslab
rereadPhotobooleanoptional

Responses

200The scan with its candidates.
object
- scanScanItemrequired

Errors (400, 401, 404, 409, 429, 500)

400invalid_request invalid_json invalid_addon no_barcode
invalid_request: The query or body doesn’t match the schema (see errors[]).
invalid_json: The body isn’t JSON.
invalid_addon: The add-on isn’t 2 or 5 digits.
no_barcode: An add-on was sent for a scan without a barcode.
401unauthorized
unauthorized: Not signed in (no session or token, or an expired one).
404not_found scan_not_found
not_found: Nothing at that address.
scan_not_found: No scan of yours with that id.
409already_added already_processing
already_added: The scan was already added as a copy.
already_processing: Another match of this scan is running.
429rate_limited
rate_limited: Matching faster than 30 a minute; wait the Retry-After seconds.
500internal
internal: Something went wrong on our side (quote the requestId).

curl

curl -X POST 'https://collection.id/api/v1/scans/<id>/process' \
  -H "Authorization: Bearer $COLLECTOR_TOKEN" \
  -H 'Content-Type: application/json' \
  -d @body.json

TypeScript SDK

await collector.processScan({ path: { id }, body: { … } });

POST/api/v1/scans/{id}/provisional

Add a missing book for a scan

Signed in

For a book no source knows yet: creates a provisional catalog issue and picks it for this scan. Catalog moderators review it before it’s everyone’s.

SDK: collector.createProvisionalForScan()
Key scopes: scans:write(API keys are coming soon)
Headers: X-Request-Id

Parameters

Name	In	Type	About
`id`required	path	string (uuid)	The scan’s id.

Request body (required, application/json)

object

seriesTitlestringrequired1–300 characters
numberstringrequired1–40 characters
publisherstring or nulloptionalat most 200 characters
startYearinteger or nulloptional1800–2200
coverDatestring or nulloptional

Responses

200The scan, now matched to the new issue.
object
- scanScanItemrequired

Errors (400, 401, 404, 409, 500)

400invalid_request invalid_json
invalid_request: The query or body doesn’t match the schema (see errors[]).
invalid_json: The body isn’t JSON.
401unauthorized
unauthorized: Not signed in (no session or token, or an expired one).
404not_found scan_not_found
not_found: Nothing at that address.
scan_not_found: No scan of yours with that id.
409already_added
already_added: The scan was already added.
500internal
internal: Something went wrong on our side (quote the requestId).

curl

curl -X POST 'https://collection.id/api/v1/scans/<id>/provisional' \
  -H "Authorization: Bearer $COLLECTOR_TOKEN" \
  -H 'Content-Type: application/json' \
  -d @body.json

TypeScript SDK

await collector.createProvisionalForScan({ path: { id }, body: { … } });

GET/api/v1/scans/{id}/search

Search for a scan

Signed in

Catalog candidates for fixing a scan’s match, ranked with this scan’s evidence (its barcode and photo reads). 120 searches a minute.

SDK: collector.searchForScan()
Key scopes: scans:write(API keys are coming soon)
Headers: If-None-MatchX-Request-Id

Parameters

Name	In	Type	About
`id`required	path	string (uuid)	The scan’s id.
`q`required	query	string	1–200 characters

Responses

200Candidates, best first.
object
- candidatesarray of ScanCandidaterequired
304Not modified: your copy (the ETag in If-None-Match) is current.

Errors (400, 401, 404, 429, 500)

400invalid_request
invalid_request: The query or body doesn’t match the schema (see errors[]).
401unauthorized
unauthorized: Not signed in (no session or token, or an expired one).
404not_found scan_not_found
not_found: Nothing at that address.
scan_not_found: No scan of yours with that id.
429rate_limited
rate_limited: Searching faster than 120 a minute; wait the Retry-After seconds.
500internal
internal: Something went wrong on our side (quote the requestId).

curl

curl 'https://collection.id/api/v1/scans/<id>/search' \
  -H "Authorization: Bearer $COLLECTOR_TOKEN"

TypeScript SDK

await collector.searchForScan({ path: { id }, query: { … } });

POST/api/v1/scans/batches

Start a scanning session

Signed inIdempotent

A session (batch) groups a sitting’s scans and applies copy defaults (status, location, price, tags) to every copy added from it. reuseOpen: true returns your open session instead, so a paired phone and the desktop share one tray.

SDK: collector.createScanBatch()
Key scopes: scans:write(API keys are coming soon)
Headers: Idempotency-KeyX-Request-Id

Request body (required, application/json)

object

namestring or nulloptionalat most 120 characters
defaultsobjectoptional
Fields of defaults
- statusenumoptional
  One ofownedwishlist
- locationstring or nulloptionalat most 120 characters
- acquired_onstring or nulloptional
- purchase_price_centsinteger or nulloptional0–1000000000
- purchase_currencystringoptional
- acquired_fromstring or nulloptionalat most 120 characters
- tagsarray of stringoptionalat most 30 items
reuseOpenbooleanoptional

Responses

200The session.
object
- batchScanBatchrequired

Errors (400, 401, 409, 422, 500)

400invalid_request invalid_json invalid_idempotency_key
invalid_request: The query or body doesn’t match the schema (see errors[]).
invalid_json: The body isn’t JSON.
invalid_idempotency_key: The Idempotency-Key isn’t 1–255 visible ASCII characters.
401unauthorized
unauthorized: Not signed in (no session or token, or an expired one).
409idempotency_in_progress
idempotency_in_progress: The first request with this key is still running.
422idempotency_key_reused
idempotency_key_reused: This key was used for a different request.
500internal
internal: Something went wrong on our side (quote the requestId).

curl

curl -X POST 'https://collection.id/api/v1/scans/batches' \
  -H "Authorization: Bearer $COLLECTOR_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H 'Content-Type: application/json' \
  -d @body.json

TypeScript SDK

await collector.createScanBatch({ body: { … } });

PATCH/api/v1/scans/batches/{id}

Update a scanning session

Signed in

Rename it, change its copy defaults, or close it.

SDK: collector.updateScanBatch()
Key scopes: scans:write(API keys are coming soon)
Headers: X-Request-Id

Parameters

Name	In	Type	About
`id`required	path	string (uuid)	The session’s id.

Request body (required, application/json)

object

namestring or nulloptionalat most 120 characters
defaultsobjectoptional
Fields of defaults
- statusenumoptional
  One ofownedwishlist
- locationstring or nulloptionalat most 120 characters
- acquired_onstring or nulloptional
- purchase_price_centsinteger or nulloptional0–1000000000
- purchase_currencystringoptional
- acquired_fromstring or nulloptionalat most 120 characters
- tagsarray of stringoptionalat most 30 items
closebooleanoptional

Responses

200The session as it is now.
object
- batchScanBatchrequired

Errors (400, 401, 404, 500)

400invalid_request invalid_json
invalid_request: The query or body doesn’t match the schema (see errors[]).
invalid_json: The body isn’t JSON.
401unauthorized
unauthorized: Not signed in (no session or token, or an expired one).
404not_found batch_not_found
not_found: Nothing at that address.
batch_not_found: No session of yours with that id.
500internal
internal: Something went wrong on our side (quote the requestId).

curl

curl -X PATCH 'https://collection.id/api/v1/scans/batches/<id>' \
  -H "Authorization: Bearer $COLLECTOR_TOKEN" \
  -H 'Content-Type: application/json' \
  -d @body.json

TypeScript SDK

await collector.updateScanBatch({ path: { id }, body: { … } });

POST/api/v1/scans/bulk

Act on many scans

Signed inIdempotent

Adds, skips or deletes up to 100 scans at once (“Add all matched”). Each scan answers on its own: one failing doesn’t stop the rest.

SDK: collector.bulkScans()
Key scopes: scans:writecollection:write(API keys are coming soon)
Headers: Idempotency-KeyX-Request-Id

Request body (required, application/json)

object

actionenumrequired
One ofaddskipdelete
idsarray of string (uuid)required1–100 items

Responses

200One result per scan, in order.
object
- resultsarray of objectrequired
  Fields of results
  idstring (uuid)required
  okbooleanrequired
  itemIdstring (uuid)optional
  The copy, for an added scan.
  errorstringoptional
  Why this one failed (the error code).

Errors (400, 401, 409, 422, 500)

400invalid_request invalid_json invalid_idempotency_key
invalid_request: The query or body doesn’t match the schema (see errors[]).
invalid_json: The body isn’t JSON.
invalid_idempotency_key: The Idempotency-Key isn’t 1–255 visible ASCII characters.
401unauthorized
unauthorized: Not signed in (no session or token, or an expired one).
409idempotency_in_progress
idempotency_in_progress: The first request with this key is still running.
422idempotency_key_reused
idempotency_key_reused: This key was used for a different request.
500internal
internal: Something went wrong on our side (quote the requestId).

curl

curl -X POST 'https://collection.id/api/v1/scans/bulk' \
  -H "Authorization: Bearer $COLLECTOR_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H 'Content-Type: application/json' \
  -d @body.json

TypeScript SDK

await collector.bulkScans({ body: { … } });

GET/api/v1/scans/search

Search before scanning

Signed in

Catalog candidates for “Type it” (no scan yet), with the copies you own and your wishlist entries for each. Up to 16. Shares the 120-a-minute search allowance.

SDK: collector.searchToScan()
Key scopes: catalog:read(API keys are coming soon)
Headers: If-None-MatchX-Request-Id

Parameters

Name	In	Type	About
`q`required	query	string	1–200 characters

Responses

200Candidates, best first.
object
- candidatesarray of ScanCandidaterequired
304Not modified: your copy (the ETag in If-None-Match) is current.

Errors (400, 401, 429, 500)

400invalid_request
invalid_request: The query or body doesn’t match the schema (see errors[]).
401unauthorized
unauthorized: Not signed in (no session or token, or an expired one).
429rate_limited
rate_limited: Searching faster than 120 a minute; wait the Retry-After seconds.
500internal
internal: Something went wrong on our side (quote the requestId).

curl

curl 'https://collection.id/api/v1/scans/search' \
  -H "Authorization: Bearer $COLLECTOR_TOKEN"

TypeScript SDK

await collector.searchToScan({ query: { … } });

POST/api/v1/scans/upload-url

Get upload URLs for a scan’s photo

Signed in

Signed upload URLs (valid 2 hours) for the scan’s photo and its thumbnail. Upload each with Supabase Storage’s uploadToSignedUrl(path, token, blob) on the scans bucket, then process the scan with the paths.

SDK: collector.createScanUploadUrl()
Key scopes: scans:write(API keys are coming soon)
Headers: X-Request-Id

Request body (required, application/json)

object

scanIdstring (uuid)required

Responses

200Where to upload the photo and thumbnail.
object
- bucket"scans"required
- imageobjectrequired
  Fields of image
  pathstringrequired
  scans/{uid}/{scanId}/{uuid}.jpg in the scans bucket.
  tokenstringrequired
  The upload token (Supabase Storage uploadToSignedUrl).
  signedUrlstring (uri)required
  Valid 2 hours.
- thumbobjectrequired
  Fields of thumb
  pathstringrequired
  scans/{uid}/{scanId}/{uuid}.jpg in the scans bucket.
  tokenstringrequired
  The upload token (Supabase Storage uploadToSignedUrl).
  signedUrlstring (uri)required
  Valid 2 hours.

Errors (400, 401, 404, 409, 500, 502)

400invalid_request invalid_json
invalid_request: The query or body doesn’t match the schema (see errors[]).
invalid_json: The body isn’t JSON.
401unauthorized
unauthorized: Not signed in (no session or token, or an expired one).
404scan_not_found
scan_not_found: No scan of yours with that id.
409storage_quota
storage_quota: Your photo storage is full.
500internal
internal: Something went wrong on our side (quote the requestId).
502upload_url_failed
upload_url_failed: Storage couldn’t sign the upload; try again.

curl

curl -X POST 'https://collection.id/api/v1/scans/upload-url' \
  -H "Authorization: Bearer $COLLECTOR_TOKEN" \
  -H 'Content-Type: application/json' \
  -d @body.json

TypeScript SDK

await collector.createScanUploadUrl({ body: { … } });