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

# Bind Actor to Workspace

> Bind an existing actor to a workspace

```
POST /openapi/memorylake/api/v3/workspaces/{workspaceId}/actors
```

Binds an existing actor to a workspace. Once bound, the actor can participate in conversations within the workspace's projects. An actor can be bound to multiple workspaces.

<Note>
  **Permission required:** `workspace:actor_bind`
</Note>

### Path Parameters

<ParamField path="workspaceId" type="string" required>
  Workspace ID
</ParamField>

### Request Body

<ParamField body="actor_id" type="string" required>
  ID of the actor to bind. The actor must already exist (see [Create Actor](/features/memorylake/api-reference/actors/create-actor)).
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST 'https://app.memorylake.ai/openapi/memorylake/api/v3/workspaces/ws-7k8m9n0p1q2r/actors' \
    -H 'Authorization: Bearer sk_xxxxxx' \
    -H 'Content-Type: application/json' \
    -d '{
      "actor_id": "act-a1b2c3d4e5f6"
    }'
  ```
</RequestExample>

### Response

<ResponseField name="data" type="object">
  <Expandable title="Actor binding">
    <ResponseField name="actor_id" type="string">Actor ID</ResponseField>
    <ResponseField name="custom_id" type="string">Caller-defined external identifier</ResponseField>
    <ResponseField name="actor_type" type="string">Actor type: `HUMAN` or `ASSISTANT`</ResponseField>
    <ResponseField name="display_name" type="string">Human-readable display name</ResponseField>
    <ResponseField name="bound_at" type="string">Timestamp when the actor was bound to this workspace</ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json Success (200) theme={null}
  {
    "success": true,
    "data": {
      "actor_id": "act-a1b2c3d4e5f6",
      "custom_id": "user-ext-001",
      "actor_type": "HUMAN",
      "display_name": "Alice Chen",
      "bound_at": "2025-03-15T09:00:00Z"
    }
  }
  ```
</ResponseExample>