Make an app password for the group: what an app that signs in with a handle and a password, such as the Bluesky app, signs in to the group with (com.atproto.server.createSession). It stays the caller's: it stops working once they could no longer make it, and its sessions are listed as theirs among the group's connected apps. Its sessions may use the group's public repo, its blobs and other services, never its spaces, nor get service tokens for the account's own methods or this host's. Requires a role that may write every collection as the group.
Input
application/jsongroup
stringdid
Required
The group DID. Every method is served by the group's host and authorized against that group's roles.
name
string
Required
What it's for, such as the device or app it signs in: unique in the group.
maxLength: 64 bytesprivileged
boolean
Optional
Whether its sessions may also use Bluesky's chat (DMs) as the group.
Output
application/jsoncreatedAt
stringdatetime
Required
An RFC 3339 formatted timestamp.
name
string
Required
No description available.
password
string
Required
The password, shown this once: the host keeps only its hash.
privileged
boolean
Required
No description available.
Errors
Forbidden
InvalidName
DuplicateName
TooManyAppPasswords
Try It
Requests are sent directly from your browser. Some servers may block requests due to CORS.
View raw schema
{
"description": "Make an app password for the group: what an app that signs in with a handle and a password, such as the Bluesky app, signs in to the group with (com.atproto.server.createSession). It stays the caller's: it stops working once they could no longer make it, and its sessions are listed as theirs among the group's connected apps. Its sessions may use the group's public repo, its blobs and other services, never its spaces, nor get service tokens for the account's own methods or this host's. Requires a role that may write every collection as the group.",
"errors": [
{
"name": "Forbidden"
},
{
"name": "InvalidName"
},
{
"name": "DuplicateName"
},
{
"name": "TooManyAppPasswords"
}
],
"input": {
"encoding": "application/json",
"schema": {
"properties": {
"group": {
"description": "The group DID. Every method is served by the group's host and authorized against that group's roles.",
"format": "did",
"type": "string"
},
"name": {
"description": "What it's for, such as the device or app it signs in: unique in the group.",
"maxLength": 64,
"type": "string"
},
"privileged": {
"description": "Whether its sessions may also use Bluesky's chat (DMs) as the group.",
"type": "boolean"
}
},
"required": [
"group",
"name"
],
"type": "object"
}
},
"output": {
"encoding": "application/json",
"schema": {
"properties": {
"createdAt": {
"format": "datetime",
"type": "string"
},
"name": {
"type": "string"
},
"password": {
"description": "The password, shown this once: the host keeps only its hash.",
"type": "string"
},
"privileged": {
"type": "boolean"
}
},
"required": [
"name",
"password",
"privileged",
"createdAt"
],
"type": "object"
}
},
"type": "procedure"
}