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

# /v1/teams/{teamId}

> This endpoint deletes a team by its ID.

> [!WARNING]
>
> This action cannot be undone. The applications of the team are not deleted; they are detached from the team.


## OpenAPI

````yaml DELETE /v1/teams/{teamId}
openapi: 3.1.0
info:
  title: CamposCloud API Documentation
  description: >-
    This documentation provides an overview of the CamposCloud API, including
    authentication, endpoints, and data structures. It is designed to help
    developers integrate with the CamposCloud platform effectively.
  version: 1.0.0
servers:
  - url: https://api.camposcloud.com
security:
  - bearerAuth: []
paths:
  /v1/teams/{teamId}:
    delete:
      tags:
        - Teams
      description: >-
        Deletes a team. Only the owner of the team can do this. The applications
        of the team are **not** deleted: they are detached from the team and
        stay in the account of the owner.
      parameters:
        - name: teamId
          in: path
          required: true
          description: ID of the team to delete
          schema:
            type: string
      responses:
        '200':
          description: Team deleted successfully.
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                properties:
                  message:
                    type: string
                    description: Human readable confirmation message.
                    example: Team deleted successfully.
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          description: Team not found, or you are not the owner of the team.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: Team not found or you are not the owner of this team.
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  responses:
    Unauthorized:
      description: >-
        The `Authorization` header is missing or malformed, or the API token is
        invalid.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: Invalid developer token
    TooManyRequests:
      description: >-
        A rate limit was exceeded. See the `RateLimit-*` and `Retry-After`
        response headers.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: Too many requests, please try again later
    InternalError:
      description: >-
        Unexpected error. On endpoints that do not document a `400` for it, this
        is also returned when an ID in the URL is not a valid identifier.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: Internal server error. Please try again later.
  schemas:
    Error:
      type: object
      description: >-
        Every error returned by the API has this shape. The message can be in
        English or in Portuguese depending on the endpoint.
      required:
        - error
      properties:
        error:
          type: string
          description: Human readable description of the error.
          example: Application not found.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Your CamposCloud API token, sent as `Authorization: Bearer <token>`.'

````

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