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

# Get Realtime Assistant

> Retrieve a specific realtime assistant configuration

<Note>
  **Beta Feature**: This endpoint is currently in beta. Features and specifications may change.
</Note>

<ParamField path="realtimeAssistantId" type="string" required>
  The unique identifier of the assistant
</ParamField>

<RequestExample>
  ```bash Example Request theme={null}
  curl -X GET https://api.upliftai.org/v1/realtime-assistants/550e8400-e29b-41d4-a716-446655440000 \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={null}
  const assistantId = '550e8400-e29b-41d4-a716-446655440000';

  const response = await fetch(`https://api.upliftai.org/v1/realtime-assistants/${assistantId}`, {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
    }
  });

  const assistant = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "realtimeAssistantId": "550e8400-e29b-41d4-a716-446655440000",
    "organizationId": "org_123",
    "projectId": "proj_456",
    "name": "Customer Support Assistant",
    "description": "24/7 voice support for customers",
    "config": {
      "session": {
        "ttl": 3600,
        "roomPrefix": "support"
      },
      "agent": {
        "instructions": "You are a helpful customer support agent. Be friendly and professional.",
        "initialGreeting": true,
        "greetingInstructions": "Greet the customer and ask how you can help them today.",
        "tools": [
          {
            "name": "check_order_status",
            "description": "Check the status of a customer order",
            "parameters": {
              "type": "object",
              "properties": {
                "orderId": {
                  "type": "string",
                  "description": "The order ID to check"
                }
              },
              "required": ["orderId"]
            },
            "timeout": 10
          }
        ]
      },
      "stt": {
        "default": {
          "provider": "groq",
          "model": "whisper-large-v3",
          "language": "en"
        }
      },
      "tts": {
        "default": {
          "provider": "upliftai",
          "voiceId": "v_meklc281",
          "outputFormat": "MP3_22050_32"
        }
      },
      "llm": {
        "default": {
          "provider": "groq",
          "model": "openai/gpt-oss-120b"
        }
      }
    },
    "public": false,
    "createdAt": "2024-01-15T10:30:00Z",
    "updatedAt": "2024-01-15T14:20:00Z",
    "createdBy": "user_789",
    "updatedBy": "user_789"
  }
  ```
</ResponseExample>