> ## Documentation Index > Fetch the complete documentation index at: https://docs.artbucket.io/llms.txt > Use this file to discover all available pages before exploring further. # A brand page > The page, the rules its sections show resolved for `context`, the keys whose rule has gone (`missing`), what a reader would trip on (`warnings`), the page as Markdown, and `url`, where a member reads it in the app. A slug it had before a rename finds it too. Scope: `read`. ## OpenAPI ````yaml /openapi.json get /api/v1/brands/{slug}/pages/{page} openapi: 3.1.0 info: title: artbucket version: '1' description: >- Agent-first asset management. The web UI is built on this API and nothing else, beside signing in at /api/auth. Send `Authorization: Bearer `: a key works in one workspace with one scope, and scopes are a ladder: read < propose < write < admin. People signed in to the app carry a session cookie instead, and their scope is what their grants add up to: on the organization, the workspace, or single collections and assets. A scope shown as needed on the workspace is also enough on the one collection or asset a route acts on. Agents (MCP at POST /api/v1/mcp) usually get `propose`: what they add waits for a human. servers: - url: http://localhost:3000 security: - bearer: [] - session: [] - {} paths: /api/v1/brands/{slug}/pages/{page}: parameters: - name: slug in: path required: true description: Brand slug schema: type: string - name: page in: path required: true description: The page's slug, e.g. logo schema: type: string get: summary: A brand page description: >- The page, the rules its sections show resolved for `context`, the keys whose rule has gone (`missing`), what a reader would trip on (`warnings`), the page as Markdown, and `url`, where a member reads it in the app. A slug it had before a rename finds it too. Scope: `read`. parameters: - name: context in: query schema: type: string description: Resolve its rules for this context, e.g. dark-background responses: '200': description: The page content: application/json: schema: type: object properties: data: type: object properties: brand: type: string context: type: - string - 'null' page: type: object properties: slug: type: string title: type: string position: type: integer minimum: -9007199254740991 maximum: 9007199254740991 hidden: type: boolean parent: description: The page it sits under; null at the top type: - string - 'null' eyebrow: type: - string - 'null' lede: type: - string - 'null' cover: anyOf: - type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ - type: 'null' description: Its header and card image icon: type: - string - 'null' audience: type: string enum: - everyone - partners - members description: 'On portals: who may read it' tabs: type: boolean description: Its child pages show as tabs across its top aliases: type: array items: type: string description: 'Slugs it had before a rename: they still find it' layout: type: string enum: - book - landing description: >- landing: a front with no nav column, on-this-page or pager; book: a chapter updatedAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ description: The last change to what it says translations: description: Its title, eyebrow and lede by language tag anyOf: - type: object propertyNames: type: string additionalProperties: type: object properties: title: type: string eyebrow: type: string lede: type: string additionalProperties: false - type: 'null' sections: type: array items: type: object properties: id: type: string template: type: string description: GET /api/v1/brand/templates lists them title: type: string body: type: string description: Markdown width: type: string enum: - text - wide - full columns: type: integer minimum: -9007199254740991 maximum: 9007199254740991 tone: type: string description: >- Its ground: plain, tint, brand, panel, dark, color, image or pattern hidden: type: boolean keys: type: array items: type: string description: The rules it shows, by key, in order props: type: object propertyNames: type: string additionalProperties: {} description: Its template's own settings eyebrow: type: string lede: type: string aside: type: string description: Markdown tab: description: >- Sections sharing a tab name show under one tab type: string background: type: object properties: color: type: string image: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ scrim: type: number additionalProperties: false items: type: array items: type: object properties: key: type: string description: A rule it shows asset: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ title: type: string text: type: string description: Markdown verdict: type: string enum: - do - dont caption: type: string link: type: string label: type: string icon: type: string download: type: boolean description: >- false: for reference, never offered as a download additionalProperties: false description: >- A thing a template lists: a do or a don't with its picture, a picture in a gallery audience: type: string enum: - everyone - partners - members contexts: description: >- A tab per context, its rules resolved for each type: array items: type: string only: description: Shown only in this context type: string translations: description: >- Its words by language tag; readers get them already in their language type: object propertyNames: type: string additionalProperties: type: object properties: title: type: string maxLength: 300 eyebrow: type: string maxLength: 120 lede: type: string maxLength: 1000 body: type: string maxLength: 20000 aside: type: string maxLength: 4000 items: maxItems: 60 type: array items: anyOf: - type: object properties: title: type: string maxLength: 200 text: type: string maxLength: 4000 caption: type: string maxLength: 500 additionalProperties: false - type: 'null' additionalProperties: false required: - id - template - title - body - width - columns - tone - hidden - keys - props additionalProperties: false required: - slug - title - position - hidden - parent - eyebrow - lede - cover - icon - audience - tabs - aliases - layout - updatedAt - sections additionalProperties: false rules: type: array items: type: object properties: id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ brand: type: string description: The brand's slug key: type: string description: Dotted, e.g. color.primary label: description: 'The heading readers see; null: the key, in words' type: - string - 'null' context: description: 'null: the default' type: - string - 'null' type: type: string enum: - color - text - number - list - font value: anyOf: - type: string - type: number - type: array items: type: - string - number - type: object properties: family: type: string minLength: 1 maxLength: 120 size: description: Pixels type: number exclusiveMinimum: 0 maximum: 1000 weight: description: 400 regular, 700 bold type: integer minimum: 1 maximum: 1000 required: - family additionalProperties: false spec: anyOf: - type: object propertyNames: type: string additionalProperties: {} - type: 'null' description: >- Details beyond the value, by type: RuleInput's spec usage: type: - string - 'null' assets: type: array items: type: object properties: id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ rendition: type: - string - 'null' title: type: - string - 'null' filename: type: string mime: type: string width: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' height: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' required: - id - rendition - title - filename - mime - width - height additionalProperties: false description: >- Assets it points at, in order: /a/{id}, or /a/{id}/{rendition} when it names one updatedAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ required: - id - brand - key - label - context - type - value - spec - usage - assets - updatedAt additionalProperties: false description: The rules its sections show, resolved for the context missing: type: array items: type: string description: Keys a section shows whose rule has gone since warnings: type: array items: type: string description: >- What a reader would trip on, though it saves: links that go nowhere, keys with no rule markdown: type: string description: The page as Markdown, its rules' values filled in url: type: string format: uri description: Where a member reads it in the app required: - brand - context - page - rules - missing - warnings - markdown - url additionalProperties: false required: - data additionalProperties: false default: description: An error content: application/json: schema: type: object properties: error: type: object properties: code: type: string message: type: string detail: {} required: - code - message additionalProperties: false required: - error additionalProperties: false components: securitySchemes: bearer: type: http scheme: bearer description: 'An API key: ab_...' session: type: apiKey in: cookie name: better-auth.session_token description: Signed in, at /api/auth ````