> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sreagent.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Read the overseer settings

> The Control Tower's configuration as its settings card shows it: whether the overseer is on, how often it runs, how assertive it may be, the token and tool-call ceilings one run may spend, whether the digest is sent, when the next run is due and why the last one was skipped. Reading this creates the organization's settings row when it has never had one, with the defaults the page would show, the same way the page's own first visit does. Needs the Control Tower.



## OpenAPI

````yaml /api-reference/openapi.json get /overseer_settings
openapi: 3.1.0
info:
  description: >-
    A resource-shaped endpoint onto the same tool surface the MCP server
    (/api/mcp) reaches. Every gate, refusal and audit row a caller sees here is
    the exact one the MCP endpoint answers for the same tool. Authenticated with
    an API key holding the api:admin scope, or the read-only api:config_read
    scope for GET alone.
  title: SRE Agent configuration API
  version: 1.0.0
servers:
  - url: https://sreagent.app/api/v1/config
security:
  - apiKey: []
tags:
  - name: ai_providers
  - name: ai_settings
  - name: alert_mutes
  - name: alert_routes
  - name: aws_external_id
  - name: certificate_monitors
  - name: change_notifications
  - name: compliance_periods
  - name: connectors
  - name: data_sources
  - name: deploy_policies
  - name: export
  - name: github_settings
  - name: image_targets
  - name: notification_settings
  - name: organization_settings
  - name: outbound_configs
  - name: outbound_rules
  - name: overseer_settings
  - name: prompt_templates
  - name: repo_settings
  - name: service_bindings
  - name: slack
  - name: slis
  - name: slos
  - name: status_page_components
  - name: status_page_incidents
  - name: status_page_settings
  - name: synthetic_checks
  - name: team_members
  - name: teams
  - name: ticket_import_rules
  - name: ticket_integrations
paths:
  /overseer_settings:
    get:
      tags:
        - overseer_settings
      summary: Read the overseer settings
      description: >-
        The Control Tower's configuration as its settings card shows it: whether
        the overseer is on, how often it runs, how assertive it may be, the
        token and tool-call ceilings one run may spend, whether the digest is
        sent, when the next run is due and why the last one was skipped. Reading
        this creates the organization's settings row when it has never had one,
        with the defaults the page would show, the same way the page's own first
        visit does. Needs the Control Tower.
      operationId: get_overseer_settings
      parameters: []
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  data:
                    $ref: '#/components/schemas/overseer_settings_row'
                  organization:
                    type: object
                type: object
          description: The row.
        '404':
          description: No such resource.
        default:
          description: The request failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    overseer_settings_row:
      properties:
        aggressivity:
          type:
            - string
            - 'null'
        auto_ticket_critical_findings:
          type:
            - boolean
            - 'null'
        cadence:
          type:
            - string
            - 'null'
        digest_enabled:
          type:
            - boolean
            - 'null'
        enabled:
          type:
            - boolean
            - 'null'
        last_skip_reason:
          type:
            - string
            - 'null'
        max_tokens_per_run:
          type:
            - integer
            - 'null'
        max_tool_calls:
          type:
            - integer
            - 'null'
        next_run_at:
          type:
            - string
            - 'null'
        updated_at:
          type: string
      required:
        - enabled
        - cadence
        - aggressivity
        - max_tokens_per_run
        - max_tool_calls
        - digest_enabled
        - auto_ticket_critical_findings
        - last_skip_reason
        - next_run_at
        - updated_at
      type: object
    Error:
      type: object
      description: The body of every failed request.
      properties:
        error:
          type: string
          description: >-
            A short machine-readable code such as forbidden, conflict or
            read_only_key.
        message:
          type: string
          description: A sentence that says what to change.
      required:
        - error
        - message
      additionalProperties: true
  securitySchemes:
    apiKey:
      description: >-
        An sre_ak_* API key holding the api:admin scope (or api:config_read,
        which every write refuses with read_only_key).
      scheme: bearer
      type: http

````

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