full diff

social.colibri.beta.community.listMigratable

colibri.social +2 −11

← Back to Compare Lexicon page

From

bafyreidhmygsvpb5qnmzaj2tps6tf3ygbwnzjfu5aczxcjypbysf66knlq indexed 2026-08-23 17:25 UTC View this version

bafyreibix7mwetae5maxwlhqhjsgd4hl2tvid6vz3zxvdrpjdgvhwnohua indexed 2026-10-22 14:03 UTC View this version

Compatibility

breaking 4 breaking changes, 0 non-breaking changes.

Breaking changes (4)

RemovedVertex RemovedVertex { vertex_id: "social.colibri.beta.community.listMigratable:output.unreadable" }
RemovedVertex RemovedVertex { vertex_id: "social.colibri.beta.community.listMigratable:output.unreadable:items" }
RemovedEdge RemovedEdge { src: "social.colibri.beta.community.listMigratable:output", tgt: "social.colibri.beta.community.listMigratable:output.unreadable", kind: "prop", name: Some("unreadable") }
RemovedEdge RemovedEdge { src: "social.colibri.beta.community.listMigratable:output.unreadable", tgt: "social.colibri.beta.community.listMigratable:output.unreadable:items", kind: "items", name: None }

Migration guidance

Removed

RemovedVertex { vertex_id: "social.colibri.beta.community.listMigratable:output.unreadable" }
RemovedVertex { vertex_id: "social.colibri.beta.community.listMigratable:output.unreadable:items" }

Notes

Breaking: RemovedEdge { src: "social.colibri.beta.community.listMigratable:output", tgt: "social.colibri.beta.community.listMigratable:output.unreadable", kind: "prop", name: Some("unreadable") }
Breaking: RemovedEdge { src: "social.colibri.beta.community.listMigratable:output.unreadable", tgt: "social.colibri.beta.community.listMigratable:output.unreadable:items", kind: "items", name: None }

Changes

11{

22 "$type": "com.atproto.lexicon.schema",

33 "defs": {

44 "main": {

      "description": "Lists the repo-backed communities the requesting user belongs to that have not been migrated onto spaces yet, so a client can offer them as a choice rather than asking for a handle. The AppView reads this live from the user's own public repo and each candidate's public repo, because nothing about an unmigrated community is indexed. Only a community that holds its own DID is listed: an older community that lived in its owner's repo cannot be migrated.",

      "description": "Lists the repo-backed communities the requesting user belongs to that have not finished moving onto spaces. The AppView reads this live from the user's own public repo and each candidate's public repo. A community that cannot move, such as one inside its owner's repo or one whose repo did not respond, is listed in state blocked with a reason.",

66 "errors": [

77 {

88 "description": "The request is missing, malformed, or unverifiable service auth.",

99 "name": "AuthRequired"

1010 },

1111 {

1212 "description": "The requesting user's own PDS could not be read, so no candidate list could be built at all.",

1313 "name": "UpstreamFailure"

1414 }

1515 ],

1616 "output": {

1717 "encoding": "application/json",

1818 "schema": {

1919 "properties": {

2020 "communities": {

2121

              "description": "Unmigrated legacy communities, in the user's preferred sidebar order where the legacy repo recorded one. This is not paginated: a user's community list is small and every entry costs a live read.",

2222 "items": {

2323 "description": "An unmigrated legacy community.",

2424 "ref": "social.colibri.beta.community.defs#legacyCommunityView",

2525 "type": "ref"

2626 },

2727 "type": "array"

28 },

29 "unreadable": {

              "description": "Communities named by the user's repo whose own repo could not be read, so the client can say so instead of silently dropping them.",

31 "items": {

32 "description": "A community DID whose repo could not be read.",

33 "format": "did",

34 "type": "string"

35 },

36 "type": "array"

3728 }

3829 },

3930 "required": [

4031 "communities"

4132 ],

4233 "type": "object"

4334 }

4435 },

4536 "parameters": {

4637 "properties": {

4738 "includeUnadministered": {

4839 "default": false,

            "description": "Whether to include communities the user belongs to but cannot migrate. They come back with viewerIsAdmin false.",

            "description": "Whether to include communities the user belongs to but does not administer. They come back with viewerIsAdmin false.",

5041 "type": "boolean"

5142 }

5243 },

5344 "required": [],

5445 "type": "params"

5546 },

5647 "type": "query"

5748 }

5849 },

5950 "id": "social.colibri.beta.community.listMigratable",

6051 "lexicon": 1