Finalize attachment

curl --request PATCH \
  --url https://api.managem.co.uk/seller/listings/{id}/attachments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "<string>"
}
'

{
  "id": "<string>",
  "url": "<string>"
}

Image attachments

Finalize attachment

Finalize a previously uploaded listing attachment and persist it on the listing.

This is step 2 of the listing attachment workflow and must be called after a successful direct upload.

Validation and integrity checks:

Listing must belong to the authenticated seller and remain active.
id must match the expected listing-scoped attachment URN format.
Uploaded image must no longer be in draft state.

Moderation:

The uploaded image is downloaded and passed through moderation checks.
Rejected images are deleted and the API returns 451 with rejection reasons.

Side effects:

Persists a listing attachment record when validation succeeds.
Re-evaluates listing validity:
- If the listing requires a photo (price >= 2000 or grading metadata present), finalizing an attachment marks the listing as valid: true.

Response:

Returns the persisted attachment identifier and public URL.

PATCH

seller

listings

{id}

attachments

Finalize attachment

curl --request PATCH \
  --url https://api.managem.co.uk/seller/listings/{id}/attachments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "<string>"
}
'

{
  "id": "<string>",
  "url": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

string

required

Listing ID

Body

application/json

Image identifier to finalize upload

string

required

Image identifier

Response

Attachment saved

Image attachment linked to a listing

string

required

Image identifier

url

string<uri>

required

Public URL for the attachment

Create attachment Delete attachment