social.colibri.embed.getImage Documentation (EN)

main query

Proxies and returns an external image, guarding against SSRF.

Parameters

url string uri Required

A valid URI.

Output

Encoding*/*

Errors

NotAnImage The linked resource is not an image type the AppView serves.

RateLimited The caller exceeded its rate budget.

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Service Endpoint Base URL for XRPC calls (e.g., https://api.bsky.social)

Parameters

url * A valid URI.

View raw schema

{
  "type": "query",
  "errors": [
    {
      "name": "NotAnImage",
      "description": "The linked resource is not an image type the AppView serves."
    },
    {
      "name": "RateLimited",
      "description": "The caller exceeded its rate budget."
    }
  ],
  "output": {
    "encoding": "*/*",
    "description": "The proxied image bytes (Content-Type is image/*)."
  },
  "parameters": {
    "type": "params",
    "required": [
      "url"
    ],
    "properties": {
      "url": {
        "type": "string",
        "format": "uri"
      }
    }
  },
  "description": "Proxies and returns an external image, guarding against SSRF."
}