> ## Documentation Index > Fetch the complete documentation index at: https://docs.contentcare.ai/llms.txt > Use this file to discover all available pages before exploring further. # Create watermark extract order > **Support ended.** This endpoint ended support at 09:00 KST on October 9, 2026 (00:00 UTC). Use `POST /api/v3/orders/wtr-extract` instead. Every response from this endpoint, including authentication errors and the `410` response, includes the `Deprecation: true`, `Sunset: Fri, 09 Oct 2026 00:00:00 GMT`, and `Link: ; rel="successor-version"` headers. From 09:00 KST on October 9, 2026 (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. Create a watermark extraction order. - Only 1 file per order - Supports image (jpg, jpeg, png, webp, bmp, tiff) or PDF files - For images, `includeOriginal: true` allows uploading the original file alongside - PDF does not support `includeOriginal` > [!WARNING] > > **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`](https://docs.contentcare.ai/api-reference/watermark-extract/create-order-v3) for new integrations, and see the [watermark extract quickstart](https://docs.contentcare.ai/quickstart/watermark-extract.md#migrating-from-v2-to-v3) 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. > [!WARNING] > > **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: ```http theme={null} HTTP/1.1 410 Gone Content-Type: application/json; charset=utf-8 Deprecation: true Sunset: Fri, 09 Oct 2026 00:00:00 GMT Link: ; rel="successor-version" { "code": "WATERMARK_V2_API_SUNSET" } ``` Send a new request to the v3 endpoint in the `Link` header. > [!NOTE] > > 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. ## OpenAPI ````yaml api-reference/openapi.yaml POST /api/v2/orders/wtr-extract openapi: 3.0.0 info: title: BIZ MORI API version: 2.0.0 description: > BIZ MORI API provides four core services for digital content protection: - **Anti-AI**: Protect images from AI training - **Watermark Embed**: Embed invisible digital watermarks into images - **Watermark Extract**: Extract and verify watermarks from images - **AI Detection**: Detect whether an image is AI-generated - **Test API keys**: Keys with the `sk_test_` prefix use the same Bearer authentication and support order-lifecycle testing with mock responses without running processing services or consuming credits; test uploads discard file contents and do not create result files contact: name: BIZ MORI Support email: support@contentcare.ai license: name: Proprietary url: https://docs.contentcare.ai/legal/terms servers: - url: https://api.bizmori.com description: Production security: [] tags: - name: Anti-AI description: Anti-AI image protection orders - name: Watermark Embed description: Watermark embedding orders - name: Watermark Extract description: Watermark extraction orders - name: AI Detection description: AI-generated image detection orders - name: Orders description: Order query and management - name: Webhooks description: Webhook configuration and events - name: Reports description: PDF analysis reports for watermark extract and AI Detection orders paths: /api/v2/orders/wtr-extract: post: tags: - Watermark Extract summary: Create watermark extract order description: > **Support ended.** This endpoint ended support at 09:00 KST on October 9, 2026 (00:00 UTC). Use `POST /api/v3/orders/wtr-extract` instead. Every response from this endpoint, including authentication errors and the `410` response, includes the `Deprecation: true`, `Sunset: Fri, 09 Oct 2026 00:00:00 GMT`, and `Link: ; rel="successor-version"` headers. From 09:00 KST on October 9, 2026 (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. Create a watermark extraction order. - Only 1 file per order - Supports image (jpg, jpeg, png, webp, bmp, tiff) or PDF files - For images, `includeOriginal: true` allows uploading the original file alongside - PDF does not support `includeOriginal` operationId: createWatermarkExtractOrder requestBody: required: true content: application/json: schema: type: object required: - idempotencyKey - file properties: idempotencyKey: type: string description: Idempotency key file: type: object required: - fileName properties: fileName: type: string description: Watermarked file name (with extension) example: watermarked.jpg includeOriginal: type: boolean default: false description: | Include original file (image only) - true: Upload URL for original file is also issued - Not available for PDF files originalFile: type: object description: >- Original file info (required when includeOriginal is true) required: - fileName properties: fileName: type: string description: Original file name example: original.jpg examples: imageOnly: summary: Single image (watermark only) value: idempotencyKey: 8b3f1d6e-e7a5-424b-b6c9-1e4d5a8c0f26 file: fileName: watermarked.jpg imageWithOriginal: summary: Image + original included value: idempotencyKey: 9c4a2e7f-f8b6-435c-87da-2f5e6b9d1a37 file: fileName: watermarked.jpg includeOriginal: true originalFile: fileName: original.jpg pdfOnly: summary: PDF file value: idempotencyKey: ad5b3f8a-a9c7-446d-98eb-3a6f7c0e2b48 file: fileName: document.pdf responses: '200': description: Order created successfully headers: Deprecation: description: Indicates that this API is deprecated schema: type: string example: 'true' Sunset: description: >- When support ends (RFC 8594 HTTP-date, 09:00 KST on October 9, 2026) schema: type: string example: Fri, 09 Oct 2026 00:00:00 GMT Link: description: Path of the successor v3 API schema: type: string example: ; rel="successor-version" content: application/json: schema: type: object properties: data: type: object properties: orderName: type: string description: Order name (auto-generated) orderId: type: string description: Order ID file: $ref: '#/components/schemas/WtrExtractOrderFile' examples: imageOnlyResponse: summary: Single image response value: data: orderName: wtr_extract_2026-02-13 orderId: '123456789' file: fileId: 1 fileName: watermarked.jpg uploadUrl: https://s3.amazonaws.com/... fileKey: 123/456/watermarked.jpg fileFormat: JPG fileType: IMG role: watermarked sequence: 1 imageWithOriginalResponse: summary: Image + original response value: data: orderName: wtr_extract_2026-02-13 orderId: '123456789' file: fileId: 1 fileName: watermarked.jpg uploadUrl: https://s3.amazonaws.com/... fileKey: 123/456/watermarked.jpg fileFormat: JPG fileType: IMG role: watermarked sequence: 1 originalFile: fileId: 2 fileName: original.jpg uploadUrl: https://s3.amazonaws.com/... fileKey: 123/456/original.jpg fileFormat: JPG fileType: IMG role: original sequence: 1 '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '410': description: >- v2 watermark support has ended (from 09:00 KST on October 9, 2026). Returned only after authentication and permission checks pass. Send a new request to the v3 path in the `Link` header. headers: Link: description: Path of the successor v3 API schema: type: string example: ; rel="successor-version" content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: WATERMARK_V2_API_SUNSET '429': $ref: '#/components/responses/UsageLimitExceeded' deprecated: true security: - BearerAuth: [] x-codeSamples: - lang: curl label: cURL source: |- curl -X POST https://api.bizmori.com/api/v2/orders/wtr-extract \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "idempotencyKey": "8b3f1d6e-e7a5-424b-b6c9-1e4d5a8c0f26", "file": { "fileName": "watermarked.jpg" } }' - lang: javascript label: JavaScript source: >- const response = await fetch('https://api.bizmori.com/api/v2/orders/wtr-extract', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_TOKEN', 'Content-Type': 'application/json' }, body: JSON.stringify({ idempotencyKey: '8b3f1d6e-e7a5-424b-b6c9-1e4d5a8c0f26', file: { fileName: 'watermarked.jpg' } }) }); const data = await response.json(); - lang: python label: Python source: |- import requests response = requests.post( 'https://api.bizmori.com/api/v2/orders/wtr-extract', headers={'Authorization': 'Bearer YOUR_API_TOKEN'}, json={ 'idempotencyKey': '8b3f1d6e-e7a5-424b-b6c9-1e4d5a8c0f26', 'file': { 'fileName': 'watermarked.jpg' } } ) data = response.json() components: schemas: WtrExtractOrderFile: type: object description: Watermark extract order file info properties: fileId: type: integer description: File ID fileName: type: string description: File name uploadUrl: type: string format: uri description: >- Upload URL. Live keys receive an S3 presigned URL; test keys receive an absolute `https://api.bizmori.com/api/v2/test-uploads/{signedToken}` URL. Both expire after one hour and can be renewed with `POST /api/v2/orders/{orderId}/refresh-urls`. PUT needs no Authorization header because the signed token authorizes the test upload. Test request bodies are streamed, not stored; test orders move to simulated results without usage consumption or actual external processing. fileKey: type: string description: > File identifier: an S3 object key for live keys or an isolated logical key for test keys. fileFormat: type: string description: File format example: JPG fileType: type: string enum: - IMG - DOCUMENT description: File type (image or PDF) role: type: string enum: - watermarked description: File role (always "watermarked" for the main file) sequence: type: integer description: File sequence number (always 1) example: 1 originalFile: type: object nullable: true description: Original file info (only when includeOriginal is true) properties: fileId: type: integer description: File ID fileName: type: string description: File name uploadUrl: type: string format: uri description: >- Upload URL. Live keys receive an S3 presigned URL; test keys receive an absolute `https://api.bizmori.com/api/v2/test-uploads/{signedToken}` URL. Both expire after one hour and can be renewed with `POST /api/v2/orders/{orderId}/refresh-urls`. PUT needs no Authorization header because the signed token authorizes the test upload. Test request bodies are streamed, not stored; test orders move to simulated results without usage consumption or actual external processing. fileKey: type: string description: > File identifier: an S3 object key for live keys or an isolated logical key for test keys. fileFormat: type: string description: File format fileType: type: string enum: - IMG description: File type (image only) role: type: string enum: - original description: File role (always "original") sequence: type: integer description: File sequence number (always 1) example: 1 ErrorResponse: type: object properties: code: type: string description: Error code responses: BadRequest: description: Bad request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: VALIDATION_FAILED Unauthorized: description: Authentication failed content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: AUTH_NOT_AUTHENTICATED Forbidden: description: The API key is not allowed to use the requested mode content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: AUTH_FORBIDDEN UsageLimitExceeded: description: Usage limit exceeded content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: USAGE_LIMIT_EXCEEDED securitySchemes: BearerAuth: type: http scheme: bearer description: >- 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. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.