## Example Request

### JavaScript (Backend)

```bash
curl -X POST https://api.upliftai.org/v1/realtime-assistants/550e8400-e29b-41d4-a716-446655440000/createSession \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "participantName": "John Doe"
  }'
```

### React Frontend Usage

```javascript
const assistantId = '550e8400-e29b-41d4-a716-446655440000';

const response = await fetch(
  `https://api.upliftai.org/v1/realtime-assistants/${assistantId}/createSession`,
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      participantName: 'John Doe',
      // roomName: 'custom-room-123' // optional
    })
  }
);

const sessionData = await response.json();

// Send sessionData to your frontend application
```

```javascript
// After receiving session data from your backend
import { UpliftAIRoom } from '@upliftai/assistants-react';

function App({ sessionData }) {
  return (
    <UpliftAIRoom
      token={sessionData.token}
      serverUrl={sessionData.wsUrl}
      connect={true}
      audio={true}
      video={false}
    >
      <YourAssistantUI />
    </UpliftAIRoom>
  );
}
```

### Response

```json
{
  "token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3MDU0MTAwMDAsImlzcyI6IkFQSWFiY2RlZiIsImp0aSI6InBhcnRpY2lwYW50XzEyMyIsIm5hbWUiOiJKb2huIERvZSIsInJvb20iOiJzdXBwb3J0LWFiYzEyMyIsInN1YiI6InBhcnRpY2lwYW50XzEyMyIsInZpZGVvIjp7InJvb20iOiJqb2luIiwicm9vbUFkbWluIjpmYWxzZSwicm9vbUNyZWF0ZSI6ZmFsc2UsInJvb21Kb2luIjp0cnVlLCJyb29tTGlzdCI6ZmFsc2V9fQ.signature",
  "wsUrl": "wss://upliftai-livekit-url...",
  "roomName": "support-abc123-1705406400"
}
```

### POST

**Endpoint**: /v1/realtime-assistants/{realtimeAssistantId}/createSession

### Parameters

- **realtimeAssistantId** (string, required): The unique identifier of the assistant
- **participantName** (string, required): Display name for the user participant
- **roomName** (string, optional): Custom room name, if not provided a unique room name will be generated

## Session Token Details

The returned token is a JWT that contains:

- User identity and display name
- Room access permissions
- Expiration time (based on TTL configuration)
- Audio/video capabilities

## Connection Flow

1. **Backend**: Call this endpoint with your API key
2. **Backend**: Return session data to your frontend
3. **Frontend**: Use the token and wsUrl to connect via SDK
4. **WebRTC**: Establish peer connection for real-time audio

## Security Best Practices

- Never expose your API key in client-side code. Always create sessions from your backend server.
- Validate user authentication before creating sessions
- Implement rate limiting per user
- Monitor session creation for abuse
- Set appropriate TTL values for your use case

## Related Endpoints

- [Create Public Session](https://docs.upliftai.org/assistants/api-reference/create-public-session) - For public assistants
- [Create Adhoc Session](https://docs.upliftai.org/assistants/api-reference/create-adhoc-session) - For temporary custom configurations