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

# Delete a team

> Delete a team. What it owned keeps existing with no owner: workloads, findings and cards are not deleted with it, they stop being anybody's. The people on it keep their accounts and their other teams. There is no tool to bring it back, and a new team of the same name is a different id that owns nothing. Needs confirm: true.



## OpenAPI

````yaml /api-reference/openapi.json delete /teams/{id}
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:
  /teams/{id}:
    delete:
      tags:
        - teams
      summary: Delete a team
      description: >-
        Delete a team. What it owned keeps existing with no owner: workloads,
        findings and cards are not deleted with it, they stop being anybody's.
        The people on it keep their accounts and their other teams. There is no
        tool to bring it back, and a new team of the same name is a different id
        that owns nothing. Needs confirm: true.
      operationId: delete_team
      parameters:
        - description: The resource's id.
          in: path
          name: id
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Deleted.
        '404':
          description: No such resource.
        '412':
          description: If-Match named a version of the row that is no longer current.
        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.