social.passports.folio

passports.social

Documentation

A named grouping of entries within a single passport type, e.g. a trip in the travel passport or a set of train stops in an Amtrak passport.

main record

A named grouping of entries within a single passport type, e.g. a trip in the travel passport or a set of train stops in an Amtrak passport.

Record Key tid Timestamp-based ID

Properties

createdAt string datetime Required

An RFC 3339 formatted timestamp.

description string Optional

Free-text notes about the folio overall.

maxLength: 3000 bytes
entries array of ref com.atproto.repo.strongRef Required

Ordered list of strongrefs to the passport's entry records (e.g. social.passports.travel.leg, social.passports.fiftyStates.visit) belonging to this folio.

maxLength: 200 items
passportType string Required

The passport type this folio belongs to, e.g. 'travel', 'fiftyStates', 'amtrak'. Tells consumers what record type to expect in entries.

maxLength: 50 bytes
title string Required

Folio name, e.g. 'Japan Spring 2026'.

maxLength: 300 bytes
updatedAt string datetime Optional

An RFC 3339 formatted timestamp.

visibility string Required

Controls whether this folio is publicly visible. Acts as a display hint — individual entry visibility is the ground truth.

Known values: public, private
View raw schema 
{
  "key": "tid",
  "type": "record",
  "record": {
    "type": "object",
    "required": [
      "title",
      "passportType",
      "entries",
      "visibility",
      "createdAt"
    ],
    "properties": {
      "title": {
        "type": "string",
        "maxLength": 300,
        "description": "Folio name, e.g. 'Japan Spring 2026'."
      },
      "entries": {
        "type": "array",
        "items": {
          "ref": "com.atproto.repo.strongRef",
          "type": "ref"
        },
        "maxLength": 200,
        "description": "Ordered list of strongrefs to the passport's entry records (e.g. social.passports.travel.leg, social.passports.fiftyStates.visit) belonging to this folio."
      },
      "createdAt": {
        "type": "string",
        "format": "datetime"
      },
      "updatedAt": {
        "type": "string",
        "format": "datetime"
      },
      "albumLinks": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "uri"
        },
        "maxLength": 10,
        "description": "Links to external photo albums for the folio."
      },
      "visibility": {
        "type": "string",
        "description": "Controls whether this folio is publicly visible. Acts as a display hint — individual entry visibility is the ground truth.",
        "knownValues": [
          "public",
          "private"
        ]
      },
      "description": {
        "type": "string",
        "maxLength": 3000,
        "description": "Free-text notes about the folio overall."
      },
      "passportType": {
        "type": "string",
        "maxLength": 50,
        "description": "The passport type this folio belongs to, e.g. 'travel', 'fiftyStates', 'amtrak'. Tells consumers what record type to expect in entries."
      }
    }
  },
  "description": "A named grouping of entries within a single passport type, e.g. a trip in the travel passport or a set of train stops in an Amtrak passport."
}

Lexicon Garden

@