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

# Features

> Every feature that can be turned on or off: the core's own (agents and API keys, share and upload links, portals and sites, BrandHub where the server runs it, usage insights) and the server's (FEATURES_FILE). At the organization, its `rule` (on or off in every project, or each project decides) and in how many projects it is on; in the project, whether it is on and what decides it. Admin there.

Any caller; the scope needed is checked on what it acts on.



## OpenAPI

````yaml /openapi.json get /api/v1/features
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 project 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 project, or single collections and assets. A scope shown
    as needed on the project 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/features:
    get:
      summary: Features
      description: >-
        Every feature that can be turned on or off: the core's own (agents and
        API keys, share and upload links, portals and sites, BrandHub where the
        server runs it, usage insights) and the server's (FEATURES_FILE). At the
        organization, its `rule` (on or off in every project, or each project
        decides) and in how many projects it is on; in the project, whether it
        is on and what decides it. Admin there.


        Any caller; the scope needed is checked on what it acts on.
      parameters:
        - name: context
          in: query
          schema:
            type: string
            enum:
              - organization
              - project
            default: organization
          description: Where
      responses:
        '200':
          description: Features
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: >-
                            agents, shares, portals, hub, insights, or one of
                            the server's own (FEATURES_FILE)
                        name:
                          type: string
                        description:
                          type: string
                        'off':
                          description: What turning it off does
                          type:
                            - string
                            - 'null'
                        icon:
                          type:
                            - string
                            - 'null'
                        builtin:
                          type: boolean
                          description: The core's own, rather than the server's
                        levels:
                          type: array
                          items:
                            type: string
                            enum:
                              - organization
                              - project
                          description: Where it is switched
                        default:
                          type: string
                          enum:
                            - 'on'
                            - 'off'
                          description: Where nothing switched it
                        available:
                          type: boolean
                          description: >-
                            The organization's plan has it: false shows the way
                            to one that does instead of a switch
                        manage:
                          description: Its own page, while it is on
                          type:
                            - string
                            - 'null'
                        rule:
                          type: string
                          enum:
                            - 'on'
                            - 'off'
                            - projects
                          description: >-
                            The organization's switch: on or off in every
                            project, or each project decides
                        projects:
                          anyOf:
                            - type: object
                              properties:
                                'on':
                                  type: integer
                                  minimum: -9007199254740991
                                  maximum: 9007199254740991
                                total:
                                  type: integer
                                  minimum: -9007199254740991
                                  maximum: 9007199254740991
                              required:
                                - 'on'
                                - total
                              additionalProperties: false
                            - type: 'null'
                          description: >-
                            At the organization: in how many of its projects it
                            is on
                        'on':
                          description: >-
                            In the project: whether it is on there; null at the
                            organization
                          type:
                            - boolean
                            - 'null'
                        from:
                          anyOf:
                            - type: string
                              enum:
                                - organization
                                - project
                                - default
                                - plan
                            - type: 'null'
                          description: >-
                            In the project: what decides it; `plan`: it takes a
                            plan the organization doesn't have
                        editable:
                          type: boolean
                          description: >-
                            It can be switched here: in a project, only while
                            the organization lets each decide
                        set:
                          anyOf:
                            - type: object
                              properties:
                                by:
                                  type: string
                                at:
                                  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:
                                - by
                                - at
                              additionalProperties: false
                            - type: 'null'
                          description: Who switched it, and when, where that decides it
                      required:
                        - id
                        - name
                        - description
                        - 'off'
                        - icon
                        - builtin
                        - levels
                        - default
                        - available
                        - manage
                        - rule
                        - projects
                        - 'on'
                        - from
                        - editable
                        - set
                      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

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.