full diff

social.colibri.beta.role.create

colibri.social +5 −0

← Back to Compare Lexicon page

From

bafyreia62at463nwm2to45fsfaxz2wv7fk3syy3ukv2zrnhanzppcg42he indexed 2026-10-15 15:34 UTC View this version

bafyreifjeyzamd3tgnlxfwn2q4smyz5blyeclhfw725q36u4hip4efkbxu indexed 2026-10-24 10:36 UTC View this version

Compatibility

backward compatible Backward compatible. 4 non-breaking changes.

Non-breaking changes (4)

AddedVertex AddedVertex { vertex_id: "social.colibri.beta.community.defs#roleEmojiBadge" }
AddedVertex AddedVertex { vertex_id: "social.colibri.beta.role.create:input.emojiBadge" }
AddedEdge AddedEdge { src: "social.colibri.beta.role.create:input", tgt: "social.colibri.beta.role.create:input.emojiBadge", kind: "prop", name: Some("emojiBadge") }
AddedEdge AddedEdge { src: "social.colibri.beta.role.create:input.emojiBadge", tgt: "social.colibri.beta.community.defs#roleEmojiBadge", kind: "ref", name: None }

Migration guidance

Added

AddedVertex { vertex_id: "social.colibri.beta.community.defs#roleEmojiBadge" }
AddedVertex { vertex_id: "social.colibri.beta.role.create:input.emojiBadge" }

Notes

Non-breaking: AddedEdge { src: "social.colibri.beta.role.create:input", tgt: "social.colibri.beta.role.create:input.emojiBadge", kind: "prop", name: Some("emojiBadge") }
Non-breaking: AddedEdge { src: "social.colibri.beta.role.create:input.emojiBadge", tgt: "social.colibri.beta.community.defs#roleEmojiBadge", kind: "ref", name: None }

Changes

11{

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

33 "defs": {

44 "main": {

55 "description": "Creates a role in a community.",

66 "errors": [

77 {

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

99 "name": "AuthRequired"

1010 },

1111 {

1212 "description": "The caller lacks the role.manage permission.",

1313 "name": "Forbidden"

1414 },

1515 {

1616 "description": "No community exists at the given DID.",

1717 "name": "CommunityNotFound"

1818 },

1919 {

2020 "description": "The arguments are inconsistent or malformed beyond schema validation.",

2121 "name": "InvalidRequest"

2222 },

2323 {

2424

          "description": "The requested position is at or above the caller's highest role position, or the permissions include one the caller does not hold.",

2525 "name": "RoleHierarchy"

2626 },

2727 {

2828

          "description": "The AppView cannot act as the community because its stored credentials are missing or unusable.",

2929 "name": "CredentialsUnavailable"

3030 }

3131 ],

3232 "input": {

3333 "encoding": "application/json",

3434 "schema": {

3535 "properties": {

3636 "badge": {

3737 "description": "An icon badge. Image badges are set with social.colibri.beta.role.putBadgeImage.",

3838 "ref": "social.colibri.beta.community.defs#roleIconBadge",

3939 "type": "ref"

4040 },

4141 "color": {

4242 "description": "Hex colour as #rrggbb.",

4343 "maxLength": 7,

4444 "type": "string"

4545 },

4646 "community": {

4747 "description": "The community to create the role in.",

4848 "format": "did",

4949 "type": "string"

5050 },

51 "emojiBadge": {

52 "description": "An emoji badge. Cannot be combined with badge.",

53 "ref": "social.colibri.beta.community.defs#roleEmojiBadge",

54 "type": "ref"

55 },

5156 "hoisted": {

5257 "description": "Whether holders are listed separately in the member list.",

5358 "type": "boolean"

5459 },

5560 "mentionable": {

5661 "description": "Whether @role mentions resolve to this role.",

5762 "type": "boolean"

5863 },

5964 "name": {

6065 "description": "Display name.",

6166 "maxLength": 32,

6267 "minLength": 1,

6368 "type": "string"

6469 },

6570 "permissions": {

6671 "description": "Permissions granted by this role.",

6772 "items": {

6873 "description": "A namespaced permission identifier.",

6974 "type": "string"

7075 },

7176 "type": "array"

7277 },

7378 "position": {

7479 "description": "Hierarchy position. Higher outranks lower.",

7580 "type": "integer"

7681 }

7782 },

7883 "required": [

7984 "community",

8085 "name",

8186 "permissions"

8287 ],

8388 "type": "object"

8489 }

8590 },

8691 "output": {

8792 "encoding": "application/json",

8893 "schema": {

8994 "properties": {

9095 "role": {

9196 "description": "The newly created role.",

9297 "ref": "social.colibri.beta.community.defs#roleView",

9398 "type": "ref"

9499 }

95100 },

96101 "required": [

97102 "role"

98103 ],

99104 "type": "object"

100105 }

101106 },

102107 "type": "procedure"

103108 }

104109 },

105110 "id": "social.colibri.beta.role.create",

106111 "lexicon": 1