fyi.opensocial.createAppPassword

lexicons.opensocial.fyi

Documentation

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.

main procedure

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

Encodingapplication/json
group 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 bytes
privileged boolean Optional

Whether its sessions may also use Bluesky's chat (DMs) as the group.

Output

Encodingapplication/json
createdAt 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.

Base URL for XRPC calls (e.g., https://bsky.social)
Enter valid JSON for the request body
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"
}

Lexicon Garden

@