pub.openletter.petition

openletter.pub

Documentation

An open letter that others can endorse or object to.

main record

An open letter that others can endorse or object to.

Record Key tid Timestamp-based ID

Properties

banner blob Optional

A banner image for the letter.

maxSize: 1.0 MB
body string Required

The full text of the letter, as CommonMark markdown.

maxLength: 100000 bytesminLength: 1 bytesmaxGraphemes: 50000 graphemes
contributors array of string did Optional

DIDs the author claims as co-authors; each is confirmed by a matching pub.openletter.contribution.

maxLength: 100 items
createdAt string datetime Required

An RFC 3339 formatted timestamp.

langs array of string language Optional

The language(s) the letter is written in.

maxLength: 3 items
recipients array of ref #recipient Optional

The parties the letter is addressed to.

maxLength: 50 items
summary string Optional

A short tagline shown in previews and listings.

maxLength: 3000 bytesmaxGraphemes: 300 graphemes
tags array of string Optional

Free-form tags for browsing.

maxLength: 10 items
title string Required

The headline of the open letter.

maxLength: 3000 bytesminLength: 1 bytesmaxGraphemes: 300 graphemes
View raw schema
{
  "key": "tid",
  "type": "record",
  "record": {
    "type": "object",
    "required": [
      "title",
      "body",
      "createdAt"
    ],
    "properties": {
      "body": {
        "type": "string",
        "maxLength": 100000,
        "minLength": 1,
        "description": "The full text of the letter, as CommonMark markdown.",
        "maxGraphemes": 50000
      },
      "tags": {
        "type": "array",
        "items": {
          "type": "string",
          "maxLength": 640,
          "maxGraphemes": 64
        },
        "maxLength": 10,
        "description": "Free-form tags for browsing."
      },
      "langs": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "language"
        },
        "maxLength": 3,
        "description": "The language(s) the letter is written in."
      },
      "title": {
        "type": "string",
        "maxLength": 3000,
        "minLength": 1,
        "description": "The headline of the open letter.",
        "maxGraphemes": 300
      },
      "banner": {
        "type": "blob",
        "accept": [
          "image/png",
          "image/jpeg",
          "image/webp"
        ],
        "maxSize": 1000000,
        "description": "A banner image for the letter."
      },
      "summary": {
        "type": "string",
        "maxLength": 3000,
        "description": "A short tagline shown in previews and listings.",
        "maxGraphemes": 300
      },
      "createdAt": {
        "type": "string",
        "format": "datetime"
      },
      "recipients": {
        "type": "array",
        "items": {
          "ref": "#recipient",
          "type": "ref"
        },
        "maxLength": 50,
        "description": "The parties the letter is addressed to."
      },
      "contributors": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "did"
        },
        "maxLength": 100,
        "description": "DIDs the author claims as co-authors; each is confirmed by a matching pub.openletter.contribution."
      }
    }
  },
  "description": "An open letter that others can endorse or object to."
}
recipient object

A party an open letter is addressed to.

Properties

did string did Optional

The recipient's ATProto identity, if they have one.

name string Required

The recipient's name, e.g. "The City Council of Springfield".

maxLength: 2560 bytesminLength: 1 bytesmaxGraphemes: 256 graphemes
url string uri Optional

A web page for the recipient.

View raw schema
{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "did": {
      "type": "string",
      "format": "did",
      "description": "The recipient's ATProto identity, if they have one."
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "A web page for the recipient."
    },
    "name": {
      "type": "string",
      "maxLength": 2560,
      "minLength": 1,
      "description": "The recipient's name, e.g. \"The City Council of Springfield\".",
      "maxGraphemes": 256
    }
  },
  "description": "A party an open letter is addressed to."
}

Lexicon Garden

@