Change what a copy is

POST/collection/items/{id}/repoint

Signed inIdempotency-Key

Changes the copy’s issue, edition or variant. Only what the copy is changes: its purchase, grade, notes, your own value and its QR labels stay as they were. The change goes in the copy’s history, where it can be undone.

SDK method: collector.repointCopy()
Key scopes: collection:write
Headers: Idempotency-KeyX-Request-Id

Path parameters

idstring (uuid)required

Request body required · application/json

object

issueIdstring (uuid)required
editionIdstring (uuid) or null
pendingVariantIdstring (uuid) or null
codeobject or null
ShowHide the fields of code
- kindenumrequired
  One ofupcisbnissndistributor
- codestringrequired
  1–40 characters
- addonstring
  default ""

Responses

200OKWhether it changed, and the change.

object

changedbooleanrequired
False when the copy already was that.
changeCopyChange or nullrequired

10Errors400 · 401 · 403 · 404 · 409 · 413 · 422 · 429 · 500 · 503

400
invalid_request invalid_json invalid_idempotency_key invalid_code
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_code: The code that led here isn’t a valid code.
401
unauthorized
unauthorized: Not signed in (no session or token, or an expired one).
403
forbidden
forbidden: That isn’t yours to change.
404
not_found
not_found: Nothing at that address.
409
idempotency_in_progress invalid_target edition_mismatch invalid_pending_variant repoint_rate_limited
idempotency_in_progress: The first request with this key is still running.
invalid_target: The issue or edition can’t take a copy.
edition_mismatch: The edition isn’t one of that issue’s.
invalid_pending_variant: That pending variant isn’t yours, or isn’t of that issue.
repoint_rate_limited: Too many changes today; try again tomorrow.
413
payload_too_large
payload_too_large: The body is over 1,048,576 bytes, this operation’s limit.
422
idempotency_key_reused
idempotency_key_reused: This key was used for a different request.
429
rate_limited temporarily_blocked
rate_limited: Over the caller’s limit: the per-minute burst or the per-day quota (RateLimit headers; wait Retry-After seconds).
temporarily_blocked: Too many refused requests in a row: blocked for a while (Retry-After says how long).
500
internal
internal: Something went wrong on our side (quote the requestId).
503
not_migrated
not_migrated: The database update this needs isn’t applied yet.

curl -X POST 'https://api.collection.id/v1/collection/items/6f2c0a4e-3b1d-4c8e-9a7f-2d5e8b1c4a90/repoint' \
  -H "Authorization: Bearer $COLLECTOR_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H 'Content-Type: application/json' \
  -d '{
    "issueId": "0b4f3b1e-6c1a-4f5e-9f0e-1f2a3b4c5d6e",
    "editionId": null
  }'

{
  "changed": true,
  "change": {
    "id": "7e9a1c3e-5b7d-4f9a-8b1c-3d5f7a9c1e3b",
    "reason": "change",
    "createdAt": "2026-10-11T06:47:11.610Z",
    "undoneAt": null,
    "from": {
      "issueId": "3c7a9e1f-2b4d-4f6a-8e0c-5d7b9a1c3e5f",
      "issueLabel": "X-Men (1991) #1",
      "editionLabel": "Cover E Gatefold",
      "pendingVariant": false
    },
    "to": {
      "issueId": "0b4f3b1e-6c1a-4f5e-9f0e-1f2a3b4c5d6e",
      "issueLabel": "X-Men (1963) #1",
      "editionLabel": null,
      "pendingVariant": false
    },
    "code": null,
    "undoable": true
  }
}

Responses

200OKWhether it changed, and the change.

object

changedbooleanrequired
False when the copy already was that.
changeCopyChange or nullrequired

10Errors400 · 401 · 403 · 404 · 409 · 413 · 422 · 429 · 500 · 503

400
invalid_request invalid_json invalid_idempotency_key invalid_code
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_code: The code that led here isn’t a valid code.
401
unauthorized
unauthorized: Not signed in (no session or token, or an expired one).
403
forbidden
forbidden: That isn’t yours to change.
404
not_found
not_found: Nothing at that address.
409
idempotency_in_progress invalid_target edition_mismatch invalid_pending_variant repoint_rate_limited
idempotency_in_progress: The first request with this key is still running.
invalid_target: The issue or edition can’t take a copy.
edition_mismatch: The edition isn’t one of that issue’s.
invalid_pending_variant: That pending variant isn’t yours, or isn’t of that issue.
repoint_rate_limited: Too many changes today; try again tomorrow.
413
payload_too_large
payload_too_large: The body is over 1,048,576 bytes, this operation’s limit.
422
idempotency_key_reused
idempotency_key_reused: This key was used for a different request.
429
rate_limited temporarily_blocked
rate_limited: Over the caller’s limit: the per-minute burst or the per-day quota (RateLimit headers; wait Retry-After seconds).
temporarily_blocked: Too many refused requests in a row: blocked for a while (Retry-After says how long).
500
internal
internal: Something went wrong on our side (quote the requestId).
503
not_migrated
not_migrated: The database update this needs isn’t applied yet.

curl -X POST 'https://api.collection.id/v1/collection/items/6f2c0a4e-3b1d-4c8e-9a7f-2d5e8b1c4a90/repoint' \ -H "Authorization: Bearer $COLLECTOR_TOKEN" \ -H "Idempotency-Key: $(uuidgen)" \ -H 'Content-Type: application/json' \ -d '{ "issueId": "0b4f3b1e-6c1a-4f5e-9f0e-1f2a3b4c5d6e", "editionId": null }'

{ "changed": true, "change": { "id": "7e9a1c3e-5b7d-4f9a-8b1c-3d5f7a9c1e3b", "reason": "change", "createdAt": "2026-10-11T06:47:11.610Z", "undoneAt": null, "from": { "issueId": "3c7a9e1f-2b4d-4f6a-8e0c-5d7b9a1c3e5f", "issueLabel": "X-Men (1991) #1", "editionLabel": "Cover E Gatefold", "pendingVariant": false }, "to": { "issueId": "0b4f3b1e-6c1a-4f5e-9f0e-1f2a3b4c5d6e", "issueLabel": "X-Men (1963) #1", "editionLabel": null, "pendingVariant": false }, "code": null, "undoable": true } }