io.kich.recipe.listRecipes
List a household's recipes. Ordered by how much of each the pantry already covers, descending, then by name — so the first page is the part of the cookbook that needs no shopping.
Details · query
| Kind | query |
|---|---|
| Authority | recipe.kich.io |
| Indexed |
Checks
Validunlimited-stringdefs.main.parameters.properties.collectionNo maxLength, maxGraphemes or format limits this string.unlimited-stringdefs.main.parameters.properties.cursorNo maxLength, maxGraphemes or format limits this string.unlimited-stringdefs.main.parameters.properties.householdNo maxLength, maxGraphemes or format limits this string.unlimited-stringdefs.main.parameters.properties.tagNo maxLength, maxGraphemes or format limits this string.unlimited-stringdefs.main.output.schema.properties.cursorNo maxLength, maxGraphemes or format limits this string.
{
"$type": "com.atproto.lexicon.schema",
"defs": {
"main": {
"description": "List a household's recipes. Ordered by how much of each the pantry already covers, descending, then by name — so the first page is the part of the cookbook that needs no shopping.",
"errors": [
{
"description": "No bearer token, or one this endpoint does not accept.",
"name": "AuthRequired"
},
{
"description": "No such household, or the credential is not scoped to it.",
"name": "HouseholdNotFound"
},
{
"description": "The cursor was not one this endpoint issued.",
"name": "InvalidCursor"
}
],
"output": {
"encoding": "application/json",
"schema": {
"properties": {
"cursor": {
"description": "Absent when there is no further page.",
"type": "string"
},
"recipes": {
"items": {
"ref": "io.kich.recipe.defs#recipeView",
"type": "ref"
},
"type": "array"
}
},
"required": [
"recipes"
],
"type": "object"
}
},
"parameters": {
"properties": {
"collection": {
"description": "Only recipes in this collection, by id",
"type": "string"
},
"cursor": {
"type": "string"
},
"household": {
"description": "The household whose recipes to read. Must be the household the credential is scoped to.",
"type": "string"
},
"limit": {
"default": 50,
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"tag": {
"description": "Only recipes carrying this tag, by id",
"type": "string"
}
},
"required": [
"household"
],
"type": "params"
},
"type": "query"
}
},
"description": "A household's cookbook, most cookable first. Read-only.",
"id": "io.kich.recipe.listRecipes",
"lexicon": 1
}