dev.knotless.addAgent

{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "Names the account among the agents of the repository's dev.knotless.repo record, as `knotless agent add` does: accounts, such as a coding agent, whose pulls its runners check as they move, as code no one vouches for. Its owner can, logged in to this appview's web pages: the appview writes with the session it keeps for that account, which the pages' session cookie names. For an organization's repository, so can an admin who joined it, logged in to the pages or with a service token from their own PDS for this method: the appview's gateway, which the organization delegated its writes to, writes as the organization. Answers with the agents it names after.",
      "errors": [
        {
          "description": "No such repository, or no such account.",
          "name": "NotFound"
        },
        {
          "description": "No account is logged in to the pages, or its session has ended.",
          "name": "AuthenticationRequired"
        },
        {
          "description": "The account asking is neither the owner nor an admin who joined the organization that owns it.",
          "name": "Forbidden"
        }
      ],
      "input": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "agent": {
              "description": "The account, by handle or DID.",
              "format": "at-identifier",
              "type": "string"
            },
            "repo": {
              "description": "The repository's dev.knotless.repo record, as dev.knotless.getRepo takes it.",
              "format": "at-uri",
              "type": "string"
            }
          },
          "required": [
            "repo",
            "agent"
          ],
          "type": "object"
        }
      },
      "output": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "agents": {
              "description": "The accounts the repository names as agents now.",
              "items": {
                "ref": "dev.knotless.defs#actorView",
                "type": "ref"
              },
              "type": "array"
            }
          },
          "required": [
            "agents"
          ],
          "type": "object"
        }
      },
      "type": "procedure"
    }
  },
  "description": "Names an account among a repository's agents.",
  "id": "dev.knotless.addAgent",
  "lexicon": 1
}