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

{
  "id": 8545,
  "name": "John Doe",
  "email": "john.doe@example.com",
  "workspaces": [
    {
      "id": 1,
      "name": "Workspaces test 5",
      "active": true,
      "metadata": {},
      "json_integrations": {
        "integration_id": 16,
        "is_active": true,
        "source": "MICROSOFT_DYNAMICS",
        "destination": null,
        "status": "NOT_SEND",
        "origin_external_id": "Workspaces-example-5",
        "destination_external_id": null
      },
      "created_at": "2026-01-15 22:42:15",
      "updated_at": "2026-01-15 22:42:15",
      "pivot": {
        "workspace_id": 1,
        "user_id": 8545,
        "percentage": 10
      }
    },
    {
      "id": 2,
      "name": "Workspaces test 6",
      "active": true,
      "metadata": {},
      "json_integrations": {
        "integration_id": 16,
        "is_active": true,
        "source": "MICROSOFT_DYNAMICS",
        "destination": null,
        "status": "NOT_SEND",
        "origin_external_id": "Workspaces-example-6",
        "destination_external_id": null
      },
      "created_at": "2026-01-15 22:42:15",
      "updated_at": "2026-01-15 22:42:15",
      "pivot": {
        "workspace_id": 2,
        "user_id": 8545,
        "percentage": 20
      }
    }
  ]
}
Attaches multiple workspaces to a specific user in your COR instance. This endpoint allows batch assignment of workspace access to a user.
Prerequisites: Workspaces must be created first using the Create Workspace endpoint before they can be attached to users.

​
Response

The endpoint returns the complete user object including all attached workspaces. 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 assignments with percentage allocation

​
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/attach' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
  "workspaces": [
    {
      "workspaceId": "Workspaces-example-5",
      "percentage": 10
    },
    {
      "workspaceId": "Workspaces-example-6",
      "percentage": 20
    }
  ],
  "metadata": {
    "source": "MICROSOFT_DYNAMICS"
  }
}'

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