social.coves.community.post.defs

coves.social

Documentation

authorView object

No description available.

Properties

avatar string uri Optional

A valid URI.

did string did Required

A decentralized identifier (DID).

displayName string Optional

No description available.

maxLength: 1280 bytesmaxGraphemes: 128 graphemes

handle string handle Required

An AT Protocol handle (e.g., alice.bsky.social).

reputation integer Optional

Author's reputation in the community

View raw schema

{
  "type": "object",
  "required": [
    "did",
    "handle"
  ],
  "properties": {
    "did": {
      "type": "string",
      "format": "did"
    },
    "avatar": {
      "type": "string",
      "format": "uri"
    },
    "handle": {
      "type": "string",
      "format": "handle"
    },
    "reputation": {
      "type": "integer",
      "description": "Author's reputation in the community"
    },
    "displayName": {
      "type": "string",
      "maxLength": 1280,
      "maxGraphemes": 128
    }
  }
}

blockedAuthor object

Minimal author info for blocked posts

Properties

did string did Required

A decentralized identifier (DID).

View raw schema

{
  "type": "object",
  "required": [
    "did"
  ],
  "properties": {
    "did": {
      "type": "string",
      "format": "did"
    }
  },
  "description": "Minimal author info for blocked posts"
}

blockedCommunity object

Minimal community info for blocked posts

Properties

did string did Required

A decentralized identifier (DID).

name string Optional

No description available.

maxLength: 63 bytes

View raw schema

{
  "type": "object",
  "required": [
    "did"
  ],
  "properties": {
    "did": {
      "type": "string",
      "format": "did"
    },
    "name": {
      "type": "string",
      "maxLength": 63
    }
  },
  "description": "Minimal community info for blocked posts"
}

blockedPost object

Post is blocked due to viewer blocking author/community, or community moderation

Properties

author ref #blockedAuthor Optional

No description available.

blocked boolean Required

No description available.

blockedBy string Optional

What caused the block: viewer blocked author, viewer blocked community, or post was removed by moderators

maxLength: 64 bytes

Known values: author, community, moderator

community ref #blockedCommunity Optional

No description available.

uri string at-uri Required

An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).

View raw schema

{
  "type": "object",
  "required": [
    "uri",
    "blocked"
  ],
  "properties": {
    "uri": {
      "type": "string",
      "format": "at-uri"
    },
    "author": {
      "ref": "#blockedAuthor",
      "type": "ref"
    },
    "blocked": {
      "type": "boolean",
      "const": true
    },
    "blockedBy": {
      "type": "string",
      "maxLength": 64,
      "description": "What caused the block: viewer blocked author, viewer blocked community, or post was removed by moderators",
      "knownValues": [
        "author",
        "community",
        "moderator"
      ]
    },
    "community": {
      "ref": "#blockedCommunity",
      "type": "ref"
    }
  },
  "description": "Post is blocked due to viewer blocking author/community, or community moderation"
}

communityRef object

No description available.

Properties

avatar string uri Optional

A valid URI.

did string did Required

A decentralized identifier (DID).

handle string handle Optional

Current handle resolved from DID

name string Required

No description available.

maxLength: 63 bytes

View raw schema

{
  "type": "object",
  "required": [
    "did",
    "name"
  ],
  "properties": {
    "did": {
      "type": "string",
      "format": "did"
    },
    "name": {
      "type": "string",
      "maxLength": 63
    },
    "avatar": {
      "type": "string",
      "format": "uri"
    },
    "handle": {
      "type": "string",
      "format": "handle",
      "description": "Current handle resolved from DID"
    }
  }
}

notFoundPost object

Post was not found (deleted, never indexed, or invalid URI)

Properties

notFound boolean Required

No description available.

uri string at-uri Required

An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).

View raw schema

{
  "type": "object",
  "required": [
    "uri",
    "notFound"
  ],
  "properties": {
    "uri": {
      "type": "string",
      "format": "at-uri"
    },
    "notFound": {
      "type": "boolean",
      "const": true
    }
  },
  "description": "Post was not found (deleted, never indexed, or invalid URI)"
}

postStats object

No description available.

Properties

commentCount integer Required

No description available.

minimum: 0

downvotes integer Required

No description available.

minimum: 0

score integer Required

Calculated score (upvotes - downvotes)

shareCount integer Optional

No description available.

minimum: 0

tagCounts unknown Optional

Map of tag name to the number of community members who applied it (e.g., {"insightful": 12})

upvotes integer Required

No description available.

minimum: 0

View raw schema

{
  "type": "object",
  "required": [
    "upvotes",
    "downvotes",
    "score",
    "commentCount"
  ],
  "properties": {
    "score": {
      "type": "integer",
      "description": "Calculated score (upvotes - downvotes)"
    },
    "upvotes": {
      "type": "integer",
      "minimum": 0
    },
    "downvotes": {
      "type": "integer",
      "minimum": 0
    },
    "tagCounts": {
      "type": "unknown",
      "description": "Map of tag name to the number of community members who applied it (e.g., {\"insightful\": 12})"
    },
    "shareCount": {
      "type": "integer",
      "minimum": 0
    },
    "commentCount": {
      "type": "integer",
      "minimum": 0
    }
  }
}

postView object

No description available.

Properties

author ref #authorView Required

No description available.

cid string cid Required

A content identifier (CID) referencing immutable data.

community ref #communityRef Required

No description available.

createdAt string datetime Required

An RFC 3339 formatted timestamp.

editedAt string datetime Optional

An RFC 3339 formatted timestamp.

embed union Optional

Embedded content from the post record. Untransformed embeds keep their record types; when the AppView rewrites blob references to URLs or resolves quoted posts, it serves the corresponding #view type.

Known types:

indexedAt string datetime Required

When this post was indexed by the AppView

language string language Optional

A BCP-47 language tag (e.g., en, pt-BR).

record unknown Required

The actual post record (text, image, video, etc.)

stats ref #postStats Optional

No description available.

uri string at-uri Required

An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).

viewer ref #viewerState Optional

No description available.

View raw schema

{
  "type": "object",
  "required": [
    "uri",
    "cid",
    "author",
    "record",
    "community",
    "createdAt",
    "indexedAt"
  ],
  "properties": {
    "cid": {
      "type": "string",
      "format": "cid"
    },
    "uri": {
      "type": "string",
      "format": "at-uri"
    },
    "embed": {
      "refs": [
        "social.coves.embed.images",
        "social.coves.embed.video",
        "social.coves.embed.external",
        "social.coves.embed.external#view",
        "social.coves.embed.post",
        "social.coves.embed.post#view"
      ],
      "type": "union",
      "description": "Embedded content from the post record. Untransformed embeds keep their record types; when the AppView rewrites blob references to URLs or resolves quoted posts, it serves the corresponding #view type."
    },
    "stats": {
      "ref": "#postStats",
      "type": "ref"
    },
    "author": {
      "ref": "#authorView",
      "type": "ref"
    },
    "record": {
      "type": "unknown",
      "description": "The actual post record (text, image, video, etc.)"
    },
    "viewer": {
      "ref": "#viewerState",
      "type": "ref"
    },
    "editedAt": {
      "type": "string",
      "format": "datetime"
    },
    "language": {
      "type": "string",
      "format": "language"
    },
    "community": {
      "ref": "#communityRef",
      "type": "ref"
    },
    "createdAt": {
      "type": "string",
      "format": "datetime"
    },
    "indexedAt": {
      "type": "string",
      "format": "datetime",
      "description": "When this post was indexed by the AppView"
    }
  }
}

viewerState object

No description available.

Properties

saved boolean Optional

No description available.

savedUri string at-uri Optional

An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).

tags array of string Optional

Tags applied by the viewer to this post

vote string Optional

Viewer's vote on this post

maxLength: 64 bytes

Known values: up, down

voteUri string at-uri Optional

An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).

View raw schema

{
  "type": "object",
  "properties": {
    "tags": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 640,
        "maxGraphemes": 64
      },
      "description": "Tags applied by the viewer to this post"
    },
    "vote": {
      "type": "string",
      "maxLength": 64,
      "description": "Viewer's vote on this post",
      "knownValues": [
        "up",
        "down"
      ]
    },
    "saved": {
      "type": "boolean"
    },
    "voteUri": {
      "type": "string",
      "format": "at-uri"
    },
    "savedUri": {
      "type": "string",
      "format": "at-uri"
    }
  }
}