⌘K
API Playground

API REFERENCE

Nova Custom Endpoints

Specialized endpoints for accessing conversation history and other Nova-specific data under the nova-api/v1 prefix.

Download README
Note
These endpoints are available under the /api/nova-api/v1 prefix. They provide alternative access patterns to standard resources.

List conversations

Returns a paginated list of conversations for the authenticated user.

GET https://api.lumyx-ai.site/nova-api/v1/conversations

Parameters

mode Optional string
The type of conversations to retrieve. Defaults to all.
Options:
  • all — Returns all conversation types
  • chat — Web UI chat conversations
  • agents — Web UI agent conversations
  • personal — Personal AI conversations
  • api — API-created chat conversations
  • api_agents — API-created agent conversations
page Optional integer
The page number to retrieve. Defaults to 1.

Response

JSON Response 
{
  "object": "list",
  "data": [
    {
      "id": "conv_123abc...",
      "title": "Conversation Title",
      "mode": "api",
      "created_at": "2023-01-01T12:00:00.000000Z",
      "updated_at": "2023-01-01T12:30:00.000000Z",
      "messages": [
        {
          "id": 101,
          "role": "user",
          "content": "Latest message content...",
          "created_at": "2023-01-01T12:30:00.000000Z"
        }
      ]
    }
  ],
  "has_more": true,
  "total": 45,
  "mode_filter": "all"
}

Get conversation

Retrieves a specific conversation object, including all its messages.

GET https://api.lumyx-ai.site/nova-api/v1/conversations/{conversation_id}

Parameters

conversation_id Required string
The ID of the conversation to retrieve.

Response

JSON Response 
{
  "id": "conv_123abc...",
  "mode": "chat",
  "title": "Conversation Title",
  "created_at": "2023-01-01T12:00:00.000000Z",
  "updated_at": "2023-01-01T12:30:00.000000Z",
  "messages": [
    {
      "id": 1,
      "role": "system",
      "content": "You are a helpful assistant.",
      "created_at": "2023-01-01T12:00:00.000000Z"
    },
    {
      "id": 2,
      "role": "user",
      "content": "Hello world",
      "created_at": "2023-01-01T12:00:05.000000Z"
    },
    {
      "id": 3,
      "role": "assistant",
      "content": "Hello! How can I help you today?",
      "model": "nova-1.0",
      "created_at": "2023-01-01T12:00:10.000000Z"
    }
  ]
}