Conversations

Start an AI conversation with any server and issue instructions in plain English. RasnuCloud executes the work in real time and streams results back to you.

---

Start a Conversation

POST /api/v1/conversations
Content-Type: application/json

{
  "chatable_type": "server",
  "chatable_id": "01j9k1abc...",
  "message": "Check disk usage and clean up old logs safely"
}

Field	Type	Required	Description
chatable_type	string	Yes	server or migration_plan
chatable_id	string	Yes	ID of the server or migration plan
message	string	Yes	Your instruction in plain English

Response 201 Created:

{
  "data": {
    "id": "01j9conv...",
    "status": "running",
    "created_at": "2025-11-15T14:00:00Z"
  }
}

Execution is asynchronous. The conversation begins immediately — connect to real-time updates via the WebSocket event stream.

---

List Conversations

GET /api/v1/conversations

Returns all conversations in your organization, paginated, newest first.

Response 200 OK:

{
  "data": [
    {
      "id": "01j9conv...",
      "server_id": "01j9k1abc...",
      "status": "completed",
      "created_at": "2025-11-15T14:00:00Z"
    }
  ]
}

---

Get a Conversation

GET /api/v1/conversations/{id}

Returns a conversation with all its steps and their execution results.

{
  "data": {
    "id": "01j9conv...",
    "status": "completed",
    "steps": [
      {
        "id": "01j9step...",
        "status": "completed",
        "execution_success": true,
        "execution_log": "Disk usage: 89%\n...\nFreed 5.25 GB",
        "created_at": "2025-11-15T14:00:05Z"
      }
    ]
  }
}

Step status values:

Status	Meaning
pending	Queued, not yet started
running	Actively executing on the server
completed	Finished successfully
failed	Execution failed — see execution_log for details

---

Real-Time Updates

Subscribe to real-time step updates via WebSocket. Connect your client to the RasnuCloud event stream and listen to the ConversationStepUpdated event for the conversation's step IDs.

This is how the RasnuCloud dashboard streams live terminal output to your browser — and you can build the same experience into your own tools.

Contact support for WebSocket endpoint details and authentication flow.