dev.knotless.getRepoSettings
A repository's settings, read from its dev.knotless.repo record as its PDS has it now, for the pages' settings to show and change. All of it is public, as the record is.
Details · query
| Kind | query |
|---|---|
| Authority | knotless.dev |
| Indexed |
Checks
Validunlimited-stringdefs.main.output.schema.properties.defaultBranchNo maxLength, maxGraphemes or format limits this string.unlimited-stringdefs.main.output.schema.properties.descriptionNo maxLength, maxGraphemes or format limits this string.
{
"$type": "com.atproto.lexicon.schema",
"defs": {
"main": {
"description": "A repository's settings, read from its dev.knotless.repo record as its PDS has it now, for the pages' settings to show and change. All of it is public, as the record is.",
"errors": [
{
"description": "No such repository.",
"name": "NotFound"
}
],
"output": {
"encoding": "application/json",
"schema": {
"properties": {
"collaborators": {
"description": "The accounts that may push to it.",
"items": {
"ref": "dev.knotless.defs#actorView",
"type": "ref"
},
"type": "array"
},
"defaultBranch": {
"description": "The branch its record names for HEAD, without refs/heads/.",
"type": "string"
},
"delegated": {
"description": "The gateway its owner delegated writes to from this appview's pages (dev.knotless.delegateWrites), which sharing it for writing names as its gateway; absent until they have.",
"format": "did",
"type": "string"
},
"description": {
"description": "What the repository says it is.",
"type": "string"
},
"gates": {
"description": "The accounts its protected branches' rules name as gates (dev.knotless.repo#reviews), each once: for the pages to show by handle. Absent when there are none.",
"items": {
"ref": "dev.knotless.defs#actorView",
"type": "ref"
},
"type": "array"
},
"gateway": {
"description": "The gateway the owner delegated writes to, through which collaborators push: absent until the owner delegates.",
"format": "did",
"type": "string"
},
"indexed": {
"description": "Deprecated, and no longer set: knotless.dev indexes every private repository its members read there. Was, for a private repository, whether its owner let this appview keep an index of it.",
"type": "boolean"
},
"labels": {
"description": "The labels its pulls and issues may carry.",
"items": {
"ref": "dev.knotless.repo#label",
"type": "ref"
},
"type": "array"
},
"links": {
"description": "The links its pages show, in order, as its record names them.",
"items": {
"ref": "dev.knotless.defs#link",
"type": "ref"
},
"type": "array"
},
"readers": {
"description": "For a private repository, asked by its owner, the members who read it but do not push to it, its runners among them; absent for a public one, which anyone reads, and empty to anyone else.",
"items": {
"ref": "dev.knotless.defs#actorView",
"type": "ref"
},
"type": "array"
},
"rules": {
"description": "Its protected branches.",
"items": {
"ref": "dev.knotless.repo#rule",
"type": "ref"
},
"type": "array"
},
"runners": {
"description": "Whether it names a runner, which the merge queue needs to land it. Absent when it names none.",
"type": "boolean"
},
"storage": {
"description": "Deprecated, and no longer set: dev.knotless.getRepoStorage counts it, apart, as counting reads every pack record from the PDS. Was what it takes up on its owner's PDS.",
"ref": "#storageView",
"type": "ref"
},
"topics": {
"description": "What it is about, in order, as its record names them.",
"items": {
"ref": "dev.knotless.repo#topic",
"type": "ref"
},
"type": "array"
},
"transfer": {
"description": "Where the owner has offered to move it, if they have: the account, and the name it would have there.",
"ref": "dev.knotless.defs#repoViewBasic",
"type": "ref"
},
"triagers": {
"description": "The accounts whose labels of some scopes count.",
"items": {
"ref": "#triagerView",
"type": "ref"
},
"type": "array"
},
"uri": {
"description": "Its dev.knotless.repo record, under the name it has now.",
"format": "at-uri",
"type": "string"
}
},
"required": [
"uri",
"rules",
"labels",
"collaborators",
"triagers"
],
"type": "object"
}
},
"parameters": {
"properties": {
"repo": {
"description": "The repository's dev.knotless.repo record, as dev.knotless.getRepo takes it.",
"format": "at-uri",
"type": "string"
}
},
"required": [
"repo"
],
"type": "params"
},
"type": "query"
},
"storageView": {
"description": "A repository's packs, which hold all of its history, as `knotless repo storage` counts them.",
"properties": {
"blobBytes": {
"description": "Of those, the bytes in blobs rather than inline in records.",
"minimum": 0,
"type": "integer"
},
"bytes": {
"description": "Their bytes, as git packs them.",
"minimum": 0,
"type": "integer"
},
"objects": {
"description": "The objects in them, pack by pack: one in two packs counts twice, until compaction folds them.",
"minimum": 0,
"type": "integer"
},
"packs": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"packs",
"objects",
"bytes",
"blobBytes"
],
"type": "object"
},
"triagerView": {
"description": "An account whose labels of some scopes count on a repository.",
"properties": {
"actor": {
"ref": "dev.knotless.defs#actorView",
"type": "ref"
},
"scopes": {
"description": "The scopes of the labels it may put on.",
"items": {
"ref": "dev.knotless.repo#scope",
"type": "ref"
},
"type": "array"
}
},
"required": [
"actor",
"scopes"
],
"type": "object"
}
},
"description": "What a repository's owner sets: its description, links, topics and default branch, protected branches, labels, collaborators and triagers, and an offer to move it.",
"id": "dev.knotless.getRepoSettings",
"lexicon": 1
}