---
title: "POST /blueprintactions/users/join/{guid} - Blueprint Actions · RUAL Documentation"
description: "Join realtime collaboration session for a specific blueprint. Creates or updates user activity tracking and broadcasts join event to other collaborators."
canonical: https://docs.rual.nl/cluster/api/blueprint-actions/blueprintactions-users-join--guid-post
language: en
---

# POST /blueprintactions/users/join/{guid}

Join realtime collaboration session for a specific blueprint. Creates or updates user activity tracking and broadcasts join event to other collaborators.

| Key | Type | Example | Description |
| --- | --- | --- | --- |
| **guid** required | `string` | `"example"` | Blueprint GUID to join collaboration for |

| Key | Type | Example | Description |
| --- | --- | --- | --- |
| **[authorization](https://docs.rual.nl/cluster/api#token-providing)** required | `string` | `"Bearer access_token"` | Access token |

```
{
  "joined": true
}
```

```
{
  "code": 401,
  "error": "INVALID_ACCESS_TOKEN"
}
```

| Status | Error Code | Description |
| --- | --- | --- |
| `401` | `INVALID_ACCESS_TOKEN` | Authentication required or invalid token |

| Permission | Description |
| --- | --- |
| `Bearer token` | Access token required via Authorization header, x-authtoken, x-token, query param, or cookie |
| `blueprintactions_view` | Required scope: blueprintactions_view |