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

# Detach Users from Team

> Removes one or more users from an existing team

Removes one or more users from an existing team. This operation validates that all provided users exist and are currently attached to the team before detaching them.

## Path Parameters

<ParamField path="id" type="string" required>
  External team ID
</ParamField>

## Request Body Requirements

<ParamField body="metadata" type="object" required>
  <Expandable title="properties">
    <ParamField body="source" type="string" required>
      Integration source identifier
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="users" type="array" required>
  Array of external user IDs to detach from the team
</ParamField>

## Known Errors

* `ZC001` — Entity is not associated (team with the specified external ID not found) or missing associations for users
* `ValidationError` — Missing required fields or empty users array

<RequestExample>
  ```bash cURL theme={null}
  curl --location 'https://integrations.projectcor.com/v2/integrations/teams/{{external_team_id}}/detach' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "users": ["{{external_user_id}}"],
    "metadata": {
      "source": "GLOBANT"
    }
  }'
  ```

  ```python Python theme={null}
  import requests

  url = "https://integrations.projectcor.com/v2/integrations/teams/{{external_team_id}}/detach"

  payload = {
      "users": ["{{external_user_id}}"],
      "metadata": {
          "source": "GLOBANT"
      }
  }

  headers = {
      "Authorization": "Bearer YOUR_ACCESS_TOKEN",
      "Content-Type": "application/json"
  }

  response = requests.put(url, json=payload, headers=headers)
  print(response.json())
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://integrations.projectcor.com/v2/integrations/teams/{{external_team_id}}/detach',
    {
      method: 'PUT',
      headers: {
        'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        users: ['{{external_user_id}}'],
        metadata: {
          source: 'GLOBANT'
        }
      })
    }
  );

  const data = await response.json();
  console.log(data);
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "team_id": 4241,
      "user_id": 48878,
      "created_at": "2026-01-08 19:20:47",
      "updated_at": "2026-01-08 19:20:47",
      "id": 178148,
      "__meta__": {
        "company_id": 2336,
        "user": {
          "id": 48878,
          "first_name": "JOTA",
          "last_name": "Olaechea",
          "email": "gracie.mccullough@yahoo.com",
          "company_id": 2336
        }
      }
    }
  ]
  ```

  ```json 404 theme={null}
  {
    "status": "ERROR",
    "code": "ZC001",
    "message": "Entity is not associated"
  }
  ```

  ```json 400 theme={null}
  {
    "status": "ERROR",
    "code": "ZC001",
    "message": "Missing associations for users: external_user_1123323245433adasd3353342334431"
  }
  ```
</ResponseExample>