social.coves.embed.external

coves.social

Documentation

External link embed with optional aggregated sources for megathreads

main object

External link embed with optional aggregated sources for megathreads

Properties

external ref #external Required

No description available.

View raw schema
{
  "type": "object",
  "required": [
    "external"
  ],
  "properties": {
    "external": {
      "ref": "#external",
      "type": "ref"
    }
  },
  "description": "External link embed with optional aggregated sources for megathreads"
}
external object

Primary external link metadata

Properties

description string Optional

Description or excerpt of the linked content

maxLength: 10000 bytesmaxGraphemes: 1000 graphemes
domain string Optional

Domain of the linked content (e.g., nytimes.com)

maxLength: 253 bytes
embedType string Optional

Type hint for content rendering and filtering

maxLength: 64 bytes
Known values: article, image, video, website
provider string Optional

Service provider name (e.g., imgur, streamable)

maxLength: 100 bytes
sources array of ref#source Optional

Aggregated source links for megathreads. Each source references an original article and optionally the Coves post that shared it

maxLength: 50 items
thumb blob Optional

Thumbnail image for the post (applies to primary link)

maxSize: 6.0 MB
title string Optional

Title of the linked content

maxLength: 5000 bytesmaxGraphemes: 500 graphemes
totalCount integer Optional

Total number of items if more than displayed (for galleries)

minimum: 0
uri string uri Required

URI of the primary external content

View raw schema
{
  "type": "object",
  "required": [
    "uri"
  ],
  "properties": {
    "uri": {
      "type": "string",
      "format": "uri",
      "description": "URI of the primary external content"
    },
    "thumb": {
      "type": "blob",
      "accept": [
        "image/png",
        "image/jpeg",
        "image/webp"
      ],
      "maxSize": 6000000,
      "description": "Thumbnail image for the post (applies to primary link)"
    },
    "title": {
      "type": "string",
      "maxLength": 5000,
      "description": "Title of the linked content",
      "maxGraphemes": 500
    },
    "domain": {
      "type": "string",
      "maxLength": 253,
      "description": "Domain of the linked content (e.g., nytimes.com)"
    },
    "images": {
      "type": "array",
      "items": {
        "ref": "social.coves.embed.images#image",
        "type": "ref"
      },
      "maxLength": 8,
      "description": "Preview images for image gallery providers"
    },
    "sources": {
      "type": "array",
      "items": {
        "ref": "#source",
        "type": "ref"
      },
      "maxLength": 50,
      "description": "Aggregated source links for megathreads. Each source references an original article and optionally the Coves post that shared it"
    },
    "provider": {
      "type": "string",
      "maxLength": 100,
      "description": "Service provider name (e.g., imgur, streamable)"
    },
    "embedType": {
      "type": "string",
      "maxLength": 64,
      "description": "Type hint for content rendering and filtering",
      "knownValues": [
        "article",
        "image",
        "video",
        "website"
      ]
    },
    "totalCount": {
      "type": "integer",
      "minimum": 0,
      "description": "Total number of items if more than displayed (for galleries)"
    },
    "description": {
      "type": "string",
      "maxLength": 10000,
      "description": "Description or excerpt of the linked content",
      "maxGraphemes": 1000
    }
  },
  "description": "Primary external link metadata"
}
source object

A source link aggregated into a megathread

Properties

domain string Optional

Domain of the source (e.g., nytimes.com)

maxLength: 253 bytes
sourcePost ref com.atproto.repo.strongRef Optional

Reference to the Coves post that originally shared this link. Used for feed deprioritization of rolled-up posts

title string Optional

Title of the source article

maxLength: 5000 bytesmaxGraphemes: 500 graphemes
uri string uri Required

URI of the source article

View raw schema
{
  "type": "object",
  "required": [
    "uri"
  ],
  "properties": {
    "uri": {
      "type": "string",
      "format": "uri",
      "description": "URI of the source article"
    },
    "title": {
      "type": "string",
      "maxLength": 5000,
      "description": "Title of the source article",
      "maxGraphemes": 500
    },
    "domain": {
      "type": "string",
      "maxLength": 253,
      "description": "Domain of the source (e.g., nytimes.com)"
    },
    "sourcePost": {
      "ref": "com.atproto.repo.strongRef",
      "type": "ref",
      "description": "Reference to the Coves post that originally shared this link. Used for feed deprioritization of rolled-up posts"
    }
  },
  "description": "A source link aggregated into a megathread"
}
view object

View of an external link embed as served by the AppView

Properties

View raw schema
{
  "type": "object",
  "required": [
    "external"
  ],
  "properties": {
    "external": {
      "ref": "#viewExternal",
      "type": "ref"
    }
  },
  "description": "View of an external link embed as served by the AppView"
}
viewExternal object

External link metadata as served by the AppView; thumb is a fetchable URL instead of a blob reference

Properties

description string Optional

Description or excerpt of the linked content

maxLength: 10000 bytesmaxGraphemes: 1000 graphemes
domain string Optional

Domain of the linked content (e.g., nytimes.com)

maxLength: 253 bytes
embedType string Optional

Type hint for content rendering and filtering

maxLength: 64 bytes
Known values: article, image, video, website
provider string Optional

Service provider name (e.g., imgur, streamable)

maxLength: 100 bytes
sources array of ref#source Optional

Aggregated source links for megathreads. Each source references an original article and optionally the Coves post that shared it

maxLength: 50 items
thumb string uri Optional

URL of the thumbnail image, served via the hosting PDS blob endpoint

title string Optional

Title of the linked content

maxLength: 5000 bytesmaxGraphemes: 500 graphemes
totalCount integer Optional

Total number of items if more than displayed (for galleries)

minimum: 0
uri string uri Required

URI of the primary external content

View raw schema
{
  "type": "object",
  "required": [
    "uri"
  ],
  "properties": {
    "uri": {
      "type": "string",
      "format": "uri",
      "description": "URI of the primary external content"
    },
    "thumb": {
      "type": "string",
      "format": "uri",
      "description": "URL of the thumbnail image, served via the hosting PDS blob endpoint"
    },
    "title": {
      "type": "string",
      "maxLength": 5000,
      "description": "Title of the linked content",
      "maxGraphemes": 500
    },
    "domain": {
      "type": "string",
      "maxLength": 253,
      "description": "Domain of the linked content (e.g., nytimes.com)"
    },
    "images": {
      "type": "array",
      "items": {
        "ref": "social.coves.embed.images#image",
        "type": "ref"
      },
      "maxLength": 8,
      "description": "Preview images for image gallery providers"
    },
    "sources": {
      "type": "array",
      "items": {
        "ref": "#source",
        "type": "ref"
      },
      "maxLength": 50,
      "description": "Aggregated source links for megathreads. Each source references an original article and optionally the Coves post that shared it"
    },
    "provider": {
      "type": "string",
      "maxLength": 100,
      "description": "Service provider name (e.g., imgur, streamable)"
    },
    "embedType": {
      "type": "string",
      "maxLength": 64,
      "description": "Type hint for content rendering and filtering",
      "knownValues": [
        "article",
        "image",
        "video",
        "website"
      ]
    },
    "totalCount": {
      "type": "integer",
      "minimum": 0,
      "description": "Total number of items if more than displayed (for galleries)"
    },
    "description": {
      "type": "string",
      "maxLength": 10000,
      "description": "Description or excerpt of the linked content",
      "maxGraphemes": 1000
    }
  },
  "description": "External link metadata as served by the AppView; thumb is a fetchable URL instead of a blob reference"
}

Lexicon Garden

@