Skip to main content
POST
cURL
Support ended. This v2 endpoint ended support at 09:00 KST on October 9, 2026 (00:00 UTC). Use POST /api/v3/orders/wtr-extract for new integrations, and see the watermark extract quickstart to migrate.After v2 support ends (from 09:00 KST on October 9, 2026, which is 00:00 UTC):
  • Authentication and permission checks still run first, so 401 and 403 errors are returned as before.
  • Authenticated requests to the v2 watermark embed and extract endpoints return 410 Gone with { "code": "WATERMARK_V2_API_SUNSET" }, for both live and sk_test_ keys. The Link header points to the v3 endpoint. Create new orders with v3.
  • v2 orders that have not started processing by then fail without being processed. The order details (errors.errorCode) and the failed webhook carry WATERMARK_V2_API_SUNSET with a message pointing to v3. The order is not charged, and its credits are restored.
  • Orders already processing at that time finish and record their result. No new run starts for them afterwards.
  • You can still get existing v2 orders and download results and reports that were already created, within the existing retention period. New v2 reports cannot be created or regenerated.
Until then, the request and response behavior is unchanged, except that every response from these endpoints includes the Deprecation: true, Sunset: Fri, 09 Oct 2026 00:00:00 GMT, and Link headers.
v3 watermark extract cannot detect watermarks embedded with v2. Switching to the v3 endpoint does not make existing v2-watermarked images detectable, and there will be no exception for v2 detection after v2 support ends.

Response after support ends

From 09:00 KST on October 9, 2026 (00:00 UTC), an authenticated request to this endpoint returns:
Send a new request to the v3 endpoint in the Link header.
With an sk_test_ key, upload to the returned BIZ MORI test upload URL. Watermark Extract starts after the upload finishes and uses _detected or _undetected in the file name to select the simulated result.

Authorizations

Authorization
string
header
required

Bearer API key for external client access. Live keys use the sk_ prefix; test keys use the sk_test_ prefix and support order-lifecycle testing with mock responses without processing or credit usage.

Body

application/json
idempotencyKey
string
required

Idempotency key

file
object
required

Response

Order created successfully

data
object