---
title: "Get widgets from an image"
method: POST
path: "/api/v2/stegadography/get-widgets"
tags: ["Stegadography"]
---

# Get widgets from an image

`POST /api/v2/stegadography/get-widgets`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/stegadography/get-widgets`
- Auth: API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`

Extracts watermarks from a PNG image and returns the cached widget data
associated with each watermark found. The image must be uploaded as a
`multipart/form-data` request with the file in the `image` field.
Only widgets belonging to the authenticated organization are returned.

## Request body `multipart/form-data`

- StegadographyGetWidgetsRequest: Multipart form data containing the PNG image to scan for watermarks.
  - `image` string, binary, required: PNG image file to scan for embedded watermarks.

## Response `200`

OK

- StegadographyGetWidgetsResponse: Response containing watermarked widgets recovered from an image.
  - `data` StegadographyWidget[], required: List of watermarked widget resources recovered from an image.
    - `attributes` StegadographyWidgetAttributes, required: Attributes of a watermarked widget recovered from an image.
      - `locationx` integer, required: Horizontal pixel coordinate where the watermark was found in the image.
      - `locationy` integer, required: Vertical pixel coordinate where the watermark was found in the image.
      - `rawData` string, required: JSON-encoded string representing the widget state.
      - `watermark` string, required: Hex-encoded watermark string identifying the widget.
    - `id` string, required: Composite identifier formed from the organization ID and watermark, separated by a colon.
    - `type` 'widget', required: Stegadography widget resource type.

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `415`: Unsupported Media Type
- `429`: Too many requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)