> ## 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. # Update the organization settings > Change one or more preferences; omitted ones keep their value. Ranges are the page's: storm threshold at least 3, storm window 60..3600 seconds, re-fire cooldown 0..1440 minutes (0 pages on every re-fire), approval TTL 5..1440 minutes, investigation cooldown 0..1440 (0 disables), severity floor critical or high, AI budget at least 1 or null for none, warn percent 1..100. alert_refire_cooldown_minutes is how long after a resolve a re-fire stays quiet: it updates the alert's existing Slack thread instead of paging again, starts no automatic investigation, and reaches no outbound alerting rule. social_joins_enabled and restrict_domain_signups need a user token. ## OpenAPI ````yaml /api-reference/openapi.json put /organization_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: /organization_settings: put: tags: - organization_settings summary: Update the organization settings description: >- Change one or more preferences; omitted ones keep their value. Ranges are the page's: storm threshold at least 3, storm window 60..3600 seconds, re-fire cooldown 0..1440 minutes (0 pages on every re-fire), approval TTL 5..1440 minutes, investigation cooldown 0..1440 (0 disables), severity floor critical or high, AI budget at least 1 or null for none, warn percent 1..100. alert_refire_cooldown_minutes is how long after a resolve a re-fire stays quiet: it updates the alert's existing Slack thread instead of paging again, starts no automatic investigation, and reaches no outbound alerting rule. social_joins_enabled and restrict_domain_signups need a user token. operationId: update_organization_settings parameters: [] requestBody: content: application/json: schema: properties: ai_budget_warn_percent: type: integer alert_grouping_ai_enabled: type: boolean alert_refire_cooldown_minutes: description: >- An alert that fires again within this many minutes of resolving reopens quietly: it updates its Slack thread instead of paging again, starts no automatic investigation, and sends nothing through an outbound alerting rule. It carries on the firing it interrupted, so a rule that has already paged for that firing does not page for it again either, and a timed escalation rule counts the time since the alert last fired loudly, the quiet gaps included. 0 pages on every re-fire. maximum: 1440 minimum: 0 type: integer alert_storm_threshold: type: integer alert_storm_window_seconds: type: integer auto_close_incidents: type: boolean auto_open_incidents: type: boolean automation_approval_ttl_minutes: type: integer incident_severity_floor: description: critical | high type: string investigation_cooldown_minutes: description: >- null hands this organization back to the platform default, which is not the same as 0: zero means no cooldown at all. type: - integer - 'null' investigation_paused: type: boolean monthly_ai_budget_usd: description: null removes the ceiling. type: - integer - 'null' restrict_domain_signups: type: boolean social_joins_enabled: type: boolean timezone: description: An IANA zone name. type: string required: [] type: object required: false responses: '200': description: Updated. '201': description: Created (an upsert resource's PUT on a missing row). '404': description: No such resource. '412': description: If-Match named a version of the row that is no longer current. '422': description: The tool refused the request's shape or content. default: description: The request failed. content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: 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.