Skip to main content
PUT
/
v2
/
integrations
/
users
/
{userId}
/
detach
curl --location --request PUT 'https://integrations.projectcor.com/v2/integrations/users/OKTA-USER-12345/detach' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
  "workspaces": ["Workspaces-example-5"],
  "metadata": {
    "source": "MICROSOFT_DYNAMICS"
  }
}'

{
  "id": 8545,
  "name": "John Doe",
  "email": "john.doe@example.com",
  "workspaces": [
    {
      "id": 3,
      "name": "Other Workspace",
      "active": true,
      "metadata": {},
      "json_integrations": {
        "integration_id": 16,
        "is_active": true,
        "source": "MICROSOFT_DYNAMICS",
        "destination": null,
        "status": "NOT_SEND",
        "origin_external_id": "Workspaces-example-7",
        "destination_external_id": null
      },
      "created_at": "2026-01-15 22:42:15",
      "updated_at": "2026-01-15 22:42:15",
      "pivot": {
        "workspace_id": 3,
        "user_id": 8545,
        "percentage": 50
      }
    }
  ]
}
Detaches multiple workspaces from a specific user in your COR instance. This endpoint allows batch removal of workspace access from a user.
Prerequisites: Workspaces must be created first using the Create Workspace endpoint, and then attached to users using the Attach Workspace endpoint before they can be detached.

​
Response

The endpoint returns the complete user object with the remaining attached workspaces (after detachment). Each workspace includes a pivot table with the relationship details (workspace_id, user_id, percentage).

​
Request Body Requirements

​
metadata
object
required
​
workspaces
array
required
Array of workspace external IDs (strings) to detach from the user

​
Path Parameters

​
userId
string
required
External user ID from your source system
curl --location --request PUT 'https://integrations.projectcor.com/v2/integrations/users/OKTA-USER-12345/detach' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
  "workspaces": ["Workspaces-example-5"],
  "metadata": {
    "source": "MICROSOFT_DYNAMICS"
  }
}'

{
  "id": 8545,
  "name": "John Doe",
  "email": "john.doe@example.com",
  "workspaces": [
    {
      "id": 3,
      "name": "Other Workspace",
      "active": true,
      "metadata": {},
      "json_integrations": {
        "integration_id": 16,
        "is_active": true,
        "source": "MICROSOFT_DYNAMICS",
        "destination": null,
        "status": "NOT_SEND",
        "origin_external_id": "Workspaces-example-7",
        "destination_external_id": null
      },
      "created_at": "2026-01-15 22:42:15",
      "updated_at": "2026-01-15 22:42:15",
      "pivot": {
        "workspace_id": 3,
        "user_id": 8545,
        "percentage": 50
      }
    }
  ]
}