---
title: "Link a user to a shared persona"
method: POST
path: "/v1/personas/{persona_id}/link"
tags: ["v1 personas"]
---

# Link a user to a shared persona

`POST /v1/personas/{persona_id}/link`

Link a user to a persona by creating a personal clone of the template
    persona's knowledge graph.  The clone has its own persona_id and
    diverges independently as new data is ingested.

    When the user later calls any endpoint with the *template* persona_id,
    the system transparently routes to the clone.

## Path parameters

- `persona_id` string, required

## Request body

- LinkUserToPersonaRequest — Request model for linking a user to a persona
  - `user_id` string, required — The user ID to link

## Response `200`

Successful Response

- LinkUserToPersonaResponse — Response model for linking a user to a persona
  - `message` string, required
  - `persona_id` string, required
  - `user_id` string, required
  - `cloned_persona_id` string, nullable

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Persona not found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/elicitlabs/apis/elicit-labs-api.md) · [All operations](https://skmtc.net/elicitlabs/apis/elicit-labs-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elicitlabs/elicit-labs-api/revisions/27701839a070/schema)