social.colibri.beta.blob.get

{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "Serves a blob from a permissioned space through the AppView, which holds the space credential the client does not. Every byte is verified against the CID before it is served, and the content type is sniffed rather than trusted. Supports HTTP range requests.",
      "errors": [
        {
          "description": "The request has no valid service auth.",
          "name": "AuthRequired"
        },
        {
          "description": "The requesting user may not read the space holding the blob.",
          "name": "Forbidden"
        },
        {
          "description": "No blob matches the given DID and CID.",
          "name": "BlobNotFound"
        },
        {
          "description": "The arguments are inconsistent or malformed beyond schema validation.",
          "name": "InvalidRequest"
        },
        {
          "description": "The repo's PDS failed while the AppView fetched the blob.",
          "name": "UpstreamFailure"
        }
      ],
      "output": {
        "encoding": "*/*"
      },
      "parameters": {
        "properties": {
          "cid": {
            "description": "The blob's CID.",
            "format": "cid",
            "type": "string"
          },
          "did": {
            "description": "DID of the repo holding the blob.",
            "format": "did",
            "type": "string"
          },
          "exp": {
            "description": "Unix time in seconds after which the media link stops working.",
            "type": "integer"
          },
          "filename": {
            "description": "Sets the download filename.",
            "type": "string"
          },
          "sig": {
            "description": "Signature over did, cid, space, viewer and exp, which lets an img or video element load the blob without a bearer header.",
            "type": "string"
          },
          "space": {
            "description": "The space holding the blob. Required for a blob in a permissioned space, and omitted for one on a public repo.",
            "format": "space-ref",
            "type": "string"
          },
          "variant": {
            "description": "A rendition of a resizable image.",
            "knownValues": [
              "thumbnail",
              "avatar",
              "banner",
              "spaceBanner",
              "full"
            ],
            "type": "string"
          },
          "viewer": {
            "description": "Who the media link was signed for. Set by the AppView on a signed link, alongside exp and sig.",
            "format": "did",
            "type": "string"
          }
        },
        "required": [
          "did",
          "cid"
        ],
        "type": "params"
      },
      "type": "query"
    }
  },
  "id": "social.colibri.beta.blob.get",
  "lexicon": 1
}