Upload or reference artwork and validate it for a product placement

post/v1/artworks/validate

Request

  • Base URL: https://pod.agentmade.dev
  • URL: https://pod.agentmade.dev/v1/artworks/validate
  • Auth: none declared

Request body

artwork_idstring

Re-validate artwork uploaded earlier, or validate the file of an upload link.

upload_linktrue

Set true when you cannot send the file in this call. The answer gives an artwork_id and a one-time upload_url: upload with curl, or give the link to the person. Then call validate_artwork with the artwork_id.

product_idstring required

Product to print on.

colorstring

Product colour, for the contrast check.

sizestring

Garment size, e.g. "XL". Print areas can differ by size; without it the smallest size is checked.

placementstring

Print location on the product, e.g. "front" or "back". See get_product for the list.

presetstring

Named position inside the placement, e.g. "center_chest", "left_chest", "full_front". Defaults to the placement default.

width_mmnumber

Exact printed width of the visible artwork in millimetres. Height follows the aspect ratio.

height_mmnumber

Maximum printed height in millimetres.

top_mmnumber

Distance from the top of the print area to the top of the artwork.

left_mmnumber

Distance from the left edge of the print area. Default: horizontally centred.

Response

Validation result

artwork_idstring

Only in the upload_link answer: the reserved id for the file.

upload_urlstring

Only in the upload_link answer: the one-time upload link.

expires_atstring
next_stepstring required

What the agent should do next, in plain language.

Changes

No recorded changes to this operation across all 1 revision of this API.