> ## 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.

# Where it is used

> The brand rules that point at it, the brand pages that show it, the open public portals it is on, and its fetches over the last 30 days by surface and by referrer host.

Scope: `write`.



## OpenAPI

````yaml /openapi.json get /api/v1/assets/{id}/insights
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 <key>`: 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/assets/{id}/insights:
    parameters:
      - name: id
        in: path
        required: true
        description: Asset id
        schema:
          type: string
    get:
      summary: Where it is used
      description: >-
        The brand rules that point at it, the brand pages that show it, the open
        public portals it is on, and its fetches over the last 30 days by
        surface and by referrer host.


        Scope: `write`.
      responses:
        '200':
          description: Where it is used
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      days:
                        type: integer
                        minimum: -9007199254740991
                        maximum: 9007199254740991
                        description: How far back fetches go
                      rules:
                        type: array
                        items:
                          type: object
                          properties:
                            brand:
                              type: string
                            key:
                              type: string
                            label:
                              type:
                                - string
                                - 'null'
                            context:
                              type:
                                - string
                                - 'null'
                          required:
                            - brand
                            - key
                            - label
                            - context
                          additionalProperties: false
                        description: Brand rules that point at it
                      pages:
                        type: array
                        items:
                          type: object
                          properties:
                            brand:
                              type: object
                              properties:
                                slug:
                                  type: string
                                name:
                                  type: string
                                default:
                                  type: boolean
                              required:
                                - slug
                                - name
                                - default
                              additionalProperties: false
                            slug:
                              type: string
                            title:
                              type: string
                          required:
                            - brand
                            - slug
                            - title
                          additionalProperties: false
                        description: Brand pages that show it, as they stand now
                      portals:
                        type: array
                        items:
                          type: object
                          properties:
                            name:
                              type: string
                            url:
                              type: string
                          required:
                            - name
                            - url
                          additionalProperties: false
                        description: Open public portals that show it
                      fetches:
                        type: object
                        properties:
                          total:
                            type: integer
                            minimum: -9007199254740991
                            maximum: 9007199254740991
                          surfaces:
                            type: object
                            propertyNames:
                              type: string
                              enum:
                                - app
                                - api
                                - mcp
                                - portal
                                - share
                                - hub
                                - link
                                - public
                            additionalProperties:
                              type: integer
                              minimum: -9007199254740991
                              maximum: 9007199254740991
                        required:
                          - total
                          - surfaces
                        additionalProperties: false
                      referrers:
                        type: array
                        items:
                          type: object
                          properties:
                            host:
                              type: string
                            fetches:
                              type: integer
                              minimum: -9007199254740991
                              maximum: 9007199254740991
                            last:
                              type: string
                          required:
                            - host
                            - fetches
                            - last
                          additionalProperties: false
                        description: The hosts that loaded it, most first
                    required:
                      - days
                      - rules
                      - pages
                      - portals
                      - fetches
                      - referrers
                    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

````