---
title: "Debug URL unfurl"
method: POST
path: "/unfurl"
tags: ["Debug"]
---

# Debug URL unfurl

`POST /unfurl`

Resolves a single URL through the unfurler without reading from the unfurl cache.

## Request body

- UnfurlRequest
  - `url` string, required — The URL to unfurl

## Response `200`

Success

- MessageEmbedResponse[] — The embeds resolved by the unfurler
  - `type` string, required — The type of embed (e.g., rich, image, video, gifv, article, link)
  - `url` string, uri, nullable — The URL of the embed
  - `title` string, nullable — The title of the embed
  - `color` integer
  - `timestamp` string, date-time, nullable — The ISO 8601 timestamp of the embed content
  - `description` string, nullable — The description of the embed
  - `author` EmbedAuthorResponse
    - `name` string, required — The name of the author
    - `url` string, uri, nullable — The URL of the author
    - `icon_url` string, uri, nullable — The URL of the author icon
    - `proxy_icon_url` string, uri, nullable — The proxied URL of the author icon
  - `image` EmbedMediaResponse
    - `url` string, required — The URL of the media
    - `proxy_url` string, uri, nullable — The proxied URL of the media
    - `content_type` string, nullable — The MIME type of the media
    - `content_hash` string, nullable — The hash of the media content
    - `width` integer
    - `height` integer
    - `description` string, nullable — The description of the media
    - `placeholder` string, nullable — The base64 encoded placeholder image for lazy loading
    - `duration` integer
    - `flags` integer, required — The bitwise flags for this media
  - `thumbnail` EmbedMediaResponse
    - `url` string, required — The URL of the media
    - `proxy_url` string, uri, nullable — The proxied URL of the media
    - `content_type` string, nullable — The MIME type of the media
    - `content_hash` string, nullable — The hash of the media content
    - `width` integer
    - `height` integer
    - `description` string, nullable — The description of the media
    - `placeholder` string, nullable — The base64 encoded placeholder image for lazy loading
    - `duration` integer
    - `flags` integer, required — The bitwise flags for this media
  - `footer` EmbedFooterResponse
    - `text` string, required — The footer text
    - `icon_url` string, uri, nullable — The URL of the footer icon
    - `proxy_icon_url` string, uri, nullable — The proxied URL of the footer icon
  - `fields` EmbedFieldResponse[], nullable — The fields of the embed
    - `name` string, required — The name of the field
    - `value` string, required — The value of the field
    - `inline` boolean, required — Whether the field should be displayed inline
  - `provider` EmbedAuthorResponse
    - `name` string, required — The name of the author
    - `url` string, uri, nullable — The URL of the author
    - `icon_url` string, uri, nullable — The URL of the author icon
    - `proxy_icon_url` string, uri, nullable — The proxied URL of the author icon
  - `video` EmbedMediaResponse
    - `url` string, required — The URL of the media
    - `proxy_url` string, uri, nullable — The proxied URL of the media
    - `content_type` string, nullable — The MIME type of the media
    - `content_hash` string, nullable — The hash of the media content
    - `width` integer
    - `height` integer
    - `description` string, nullable — The description of the media
    - `placeholder` string, nullable — The base64 encoded placeholder image for lazy loading
    - `duration` integer
    - `flags` integer, required — The bitwise flags for this media
  - `audio` EmbedMediaResponse
    - `url` string, required — The URL of the media
    - `proxy_url` string, uri, nullable — The proxied URL of the media
    - `content_type` string, nullable — The MIME type of the media
    - `content_hash` string, nullable — The hash of the media content
    - `width` integer
    - `height` integer
    - `description` string, nullable — The description of the media
    - `placeholder` string, nullable — The base64 encoded placeholder image for lazy loading
    - `duration` integer
    - `flags` integer, required — The bitwise flags for this media
  - `html` string, nullable — Sanitized oEmbed HTML for trusted specialized embed renderers
  - `html_width` integer
  - `html_height` integer
  - `nsfw` boolean, nullable — Whether the embed is flagged as NSFW
  - `children` MessageEmbedChildResponse[], nullable — Internal nested embeds generated by unfurlers
    - `type` string, required — The type of embed (e.g., rich, image, video, gifv, article, link)
    - `url` string, uri, nullable — The URL of the embed
    - `title` string, nullable — The title of the embed
    - `color` integer
    - `timestamp` string, date-time, nullable — The ISO 8601 timestamp of the embed content
    - `description` string, nullable — The description of the embed
    - `author` EmbedAuthorResponse
      - `name` string, required — The name of the author
      - `url` string, uri, nullable — The URL of the author
      - `icon_url` string, uri, nullable — The URL of the author icon
      - `proxy_icon_url` string, uri, nullable — The proxied URL of the author icon
    - `image` EmbedMediaResponse
      - `url` string, required — The URL of the media
      - `proxy_url` string, uri, nullable — The proxied URL of the media
      - `content_type` string, nullable — The MIME type of the media
      - `content_hash` string, nullable — The hash of the media content
      - `width` integer
      - `height` integer
      - `description` string, nullable — The description of the media
      - `placeholder` string, nullable — The base64 encoded placeholder image for lazy loading
      - `duration` integer
      - `flags` integer, required — The bitwise flags for this media
    - `thumbnail` EmbedMediaResponse
      - `url` string, required — The URL of the media
      - `proxy_url` string, uri, nullable — The proxied URL of the media
      - `content_type` string, nullable — The MIME type of the media
      - `content_hash` string, nullable — The hash of the media content
      - `width` integer
      - `height` integer
      - `description` string, nullable — The description of the media
      - `placeholder` string, nullable — The base64 encoded placeholder image for lazy loading
      - `duration` integer
      - `flags` integer, required — The bitwise flags for this media
    - `footer` EmbedFooterResponse
      - `text` string, required — The footer text
      - `icon_url` string, uri, nullable — The URL of the footer icon
      - `proxy_icon_url` string, uri, nullable — The proxied URL of the footer icon
    - `fields` EmbedFieldResponse[], nullable — The fields of the embed
      - `name` string, required — The name of the field
      - `value` string, required — The value of the field
      - `inline` boolean, required — Whether the field should be displayed inline
    - `provider` EmbedAuthorResponse
      - `name` string, required — The name of the author
      - `url` string, uri, nullable — The URL of the author
      - `icon_url` string, uri, nullable — The URL of the author icon
      - `proxy_icon_url` string, uri, nullable — The proxied URL of the author icon
    - `video` EmbedMediaResponse
      - `url` string, required — The URL of the media
      - `proxy_url` string, uri, nullable — The proxied URL of the media
      - `content_type` string, nullable — The MIME type of the media
      - `content_hash` string, nullable — The hash of the media content
      - `width` integer
      - `height` integer
      - `description` string, nullable — The description of the media
      - `placeholder` string, nullable — The base64 encoded placeholder image for lazy loading
      - `duration` integer
      - `flags` integer, required — The bitwise flags for this media
    - `audio` EmbedMediaResponse
      - `url` string, required — The URL of the media
      - `proxy_url` string, uri, nullable — The proxied URL of the media
      - `content_type` string, nullable — The MIME type of the media
      - `content_hash` string, nullable — The hash of the media content
      - `width` integer
      - `height` integer
      - `description` string, nullable — The description of the media
      - `placeholder` string, nullable — The base64 encoded placeholder image for lazy loading
      - `duration` integer
      - `flags` integer, required — The bitwise flags for this media
    - `html` string, nullable — Sanitized oEmbed HTML for trusted specialized embed renderers
    - `html_width` integer
    - `html_height` integer
    - `nsfw` boolean, nullable — Whether the embed is flagged as NSFW

## Other responses

- `400` — Bad Request - The request was malformed or contained invalid data
- `401` — Unauthorized - Authentication is required or the token is invalid
- `403` — Forbidden - You do not have permission to perform this action
- `429` — Too Many Requests - You are being rate limited
- `500` — Internal Server Error - An unexpected error occurred

---

[API](https://skmtc.dev/fluxer/apis/fluxer-api.md) · [All operations](https://skmtc.dev/fluxer/apis/fluxer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fluxer/fluxer-api/revisions/d9c706133cc5/schema)