social.colibri.beta.server.describeServer

colibri.social

Schema Diff

+10 -0

From

CID
bafyreidasfg2awr...
Indexed At
2026-08-23 12:32 UTC
View this version

To

CID
bafyreig6t4vutl2...
Indexed At
2026-08-23 14:59 UTC
View this version

Compatibility Analysis

Breaking Changes Detected

2 breaking changes, 2 non-breaking changes.

Breaking Changes (2)
  • RequiredEdgeAdded RequiredEdgeAdded { vertex_id: "social.colibri.beta.server.describeServer:output", src: "social.colibri.beta.server.describeServer:output", tgt: "social.colibri.beta.server.describeServer:output.software", kind: "prop", name: Some("software") }
  • RequiredEdgeAdded RequiredEdgeAdded { vertex_id: "social.colibri.beta.server.describeServer:output", src: "social.colibri.beta.server.describeServer:output", tgt: "social.colibri.beta.server.describeServer:output.flavor", kind: "prop", name: Some("flavor") }
Non-Breaking Changes (2)
  • AddedVertex AddedVertex { vertex_id: "social.colibri.beta.server.describeServer:output.flavor" }
  • AddedVertex AddedVertex { vertex_id: "social.colibri.beta.server.describeServer:output.software" }

Migration Guidance

Added Elements

  • AddedVertex { vertex_id: "social.colibri.beta.server.describeServer:output.flavor" }
  • AddedVertex { vertex_id: "social.colibri.beta.server.describeServer:output.software" }

Additional Notes

  • Breaking: RequiredEdgeAdded { vertex_id: "social.colibri.beta.server.describeServer:output", src: "social.colibri.beta.server.describeServer:output", tgt: "social.colibri.beta.server.describeServer:output.software", kind: "prop", name: Some("software") }
  • Breaking: RequiredEdgeAdded { vertex_id: "social.colibri.beta.server.describeServer:output", src: "social.colibri.beta.server.describeServer:output", tgt: "social.colibri.beta.server.describeServer:output.flavor", kind: "prop", name: Some("flavor") }
1 1
{
2 2
  "id": "social.colibri.beta.server.describeServer",
3 3
  "defs": {
4 4
    "main": {
5 5
      "type": "query",
6 6
      "output": {
7 7
        "schema": {
8 8
          "type": "object",
9 9
          "required": [
10 10
            "did",
11 +
            "software",
12 +
            "flavor",
11 13
            "version",
12 14
            "handleDomain",
13 15
            "pds"
14 16
          ],
15 17
          "properties": {
16 18
            "did": {
17 19
              "type": "string",
18 20
              "format": "did",
19 21
              "description": "The AppView's own identity."
20 22
            },
21 23
            "pds": {
22 24
              "type": "string",
23 25
              "format": "uri",
24 26
              "description": "The PDS communities are created on."
25 27
            },
28 +
            "flavor": {
29 +
              "type": "string",
30 +
              "description": "Which build of the software this is. 'vanilla' for the stock AppView, and any string a fork or a customised deployment chooses for itself."
31 +
            },
26 32
            "contact": {
27 33
              "type": "string",
28 34
              "description": "How to reach the operator."
29 35
            },
30 36
            "version": {
31 37
              "type": "string",
32 38
              "description": "The running software version."
33 39
            },
34 40
            "features": {
35 41
              "type": "array",
36 42
              "items": {
37 43
                "type": "string",
38 44
                "description": "A feature identifier.",
39 45
                "knownValues": [
40 46
                  "voice",
41 47
                  "push",
42 48
                  "gifs",
43 49
                  "embeds"
44 50
                ]
45 51
              },
46 52
              "description": "Optional features this AppView supports."
47 53
            },
54 +
            "software": {
55 +
              "type": "string",
56 +
              "description": "Stable software identifier, always 'colibri-appview'. Clients key on this to confirm a host is a Colibri AppView before pointing themselves at it."
57 +
            },
48 58
            "spaceTypes": {
49 59
              "type": "array",
50 60
              "items": {
51 61
                "type": "string",
52 62
                "format": "nsid",
53 63
                "description": "A space type."
54 64
              },
55 65
              "description": "The space types this AppView understands."
56 66
            },
57 67
            "handleDomain": {
58 68
              "type": "string",
59 69
              "description": "The domain community handles are minted under."
60 70
            }
61 71
          }
62 72
        },
63 73
        "encoding": "application/json"
64 74
      },
65 75
      "description": "Gets information about this AppView."
66 76
    }
67 77
  },
68 78
  "$type": "com.atproto.lexicon.schema",
69 79
  "lexicon": 1
70 80
}

Compare Other Versions

Lexicon Garden

@