Backfill in-progress. Some lexicons and records may be missing or incomplete.

app.bsky.feed.post

bsky-lexicons.bsky.social

Documentation

main record

Record containing a Bluesky post.

Record Key tid Timestamp-based ID

Properties

createdAt string datetime Required

Client-declared timestamp when this post was originally created.

entities array of ref #entity Optional

DEPRECATED: replaced by app.bsky.richtext.facet.

langs array of string language Optional

Indicates human language of post primary text content.

maxLength: 3 bytes
reply ref #replyRef Optional

No description provided.

tags array of string Optional

Additional hashtags, in addition to any included in post text and facets.

maxLength: 8 bytes
text string Required

The primary post content. May be an empty string, if there are embeds.

maxLength: 3000 bytesmaxGraphemes: 300 graphemes
View raw schema
{
  "key": "tid",
  "type": "record",
  "record": {
    "type": "object",
    "required": [
      "text",
      "createdAt"
    ],
    "properties": {
      "tags": {
        "type": "array",
        "items": {
          "type": "string",
          "maxLength": 640,
          "maxGraphemes": 64
        },
        "maxLength": 8,
        "description": "Additional hashtags, in addition to any included in post text and facets."
      },
      "text": {
        "type": "string",
        "maxLength": 3000,
        "description": "The primary post content. May be an empty string, if there are embeds.",
        "maxGraphemes": 300
      },
      "embed": {
        "refs": [
          "app.bsky.embed.images",
          "app.bsky.embed.video",
          "app.bsky.embed.external",
          "app.bsky.embed.record",
          "app.bsky.embed.recordWithMedia"
        ],
        "type": "union"
      },
      "langs": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "language"
        },
        "maxLength": 3,
        "description": "Indicates human language of post primary text content."
      },
      "reply": {
        "ref": "#replyRef",
        "type": "ref"
      },
      "facets": {
        "type": "array",
        "items": {
          "ref": "app.bsky.richtext.facet",
          "type": "ref"
        },
        "description": "Annotations of text (mentions, URLs, hashtags, etc)"
      },
      "labels": {
        "refs": [
          "com.atproto.label.defs#selfLabels"
        ],
        "type": "union",
        "description": "Self-label values for this post. Effectively content warnings."
      },
      "entities": {
        "type": "array",
        "items": {
          "ref": "#entity",
          "type": "ref"
        },
        "description": "DEPRECATED: replaced by app.bsky.richtext.facet."
      },
      "createdAt": {
        "type": "string",
        "format": "datetime",
        "description": "Client-declared timestamp when this post was originally created."
      }
    }
  },
  "description": "Record containing a Bluesky post."
}
entity object

Deprecated: use facets instead.

Properties

index ref #textSlice Required

No description provided.

type string Required

Expected values are 'mention' and 'link'.

value string Required

No description provided.

View raw schema
{
  "type": "object",
  "required": [
    "index",
    "type",
    "value"
  ],
  "properties": {
    "type": {
      "type": "string",
      "description": "Expected values are 'mention' and 'link'."
    },
    "index": {
      "ref": "#textSlice",
      "type": "ref"
    },
    "value": {
      "type": "string"
    }
  },
  "description": "Deprecated: use facets instead."
}
replyRef object

Properties

View raw schema
{
  "type": "object",
  "required": [
    "root",
    "parent"
  ],
  "properties": {
    "root": {
      "ref": "com.atproto.repo.strongRef",
      "type": "ref"
    },
    "parent": {
      "ref": "com.atproto.repo.strongRef",
      "type": "ref"
    }
  }
}
textSlice object

Deprecated. Use app.bsky.richtext instead -- A text segment. Start is inclusive, end is exclusive. Indices are for utf16-encoded strings.

Properties

end integer Required

No description provided.

minimum: 0
start integer Required

No description provided.

minimum: 0
View raw schema
{
  "type": "object",
  "required": [
    "start",
    "end"
  ],
  "properties": {
    "end": {
      "type": "integer",
      "minimum": 0
    },
    "start": {
      "type": "integer",
      "minimum": 0
    }
  },
  "description": "Deprecated. Use app.bsky.richtext instead -- A text segment. Start is inclusive, end is exclusive. Indices are for utf16-encoded strings."
}

Lexicon Garden

@