API reference
The REM Vibe Coder API endpoints for people - chats, messages, runs, plans, questions, projects, code, uploads, memory and billing - with request and response examples.
All paths are under https://remvibecoder.com/api/v1. Authenticate as described in Authentication; in the examples $VC is the base URL and $AUTH stands for the cookie and CSRF headers.
Account
Method and path | What |
|---|---|
| Who you are: |
| (no sign-in) How sign-in works here: |
| End the session here and at REM Auth; answers |
| The models you may pick: |
| The stacks the engine can pick from (read-only; you never choose one) |
Chats and messages
Start a chat with a first message
curl -s -X POST "$VC/chats" $AUTH -H "Content-Type: application/json" -d '{
"prompt": "Build a habit tracker: add habits with a name and a colour, tick each habit off for today, and see each habit'\''s current streak and the last 7 days.",
"mode": "auto"
}'{"chat": {"id": "1b6365e5-afc9-4e3f-9038-5b7e5b2bb8f2", "project_id": null, "title": "Build a habit tracker: add habits with a name and a colou...", "mode": "auto", "archived": false, "last_run_status": "queued"}, "run_id": "bda0f6fc-cb14-4e11-b2f2-d0ed13f805dd"}Fields of POST /chats: prompt (the first message; empty creates an empty chat), mode (auto or plan), model (an id from GET /models, empty = Auto), project_id (continue an existing project), title.
Send a message
curl -s -X POST "$VC/chats/$CHAT/messages" $AUTH -H "Content-Type: application/json" \
-d '{"text": "Add a weekly summary screen", "mode": "plan"}'{"message": {"id": "…", "chat_id": "…", "role": "user", "text": "Add a weekly summary screen", "run_id": "…", "queued": false, "mode": "plan"}, "run_id": "…", "run_status": "queued", "queued": false}text is at most 20,000 characters. mode: auto (default) or plan. attachments: ids of files uploaded to this chat. When a run is already active the message is queued ("queued": true) and read by that run before its next step. With no credits left the answer is 402 out_of_credits.
Method and path | What |
|---|---|
| Your chats, newest first, with |
| One chat |
| Its messages (your messages and the assistant's answers) |
| Every plan card of the chat: |
| How each run was answered: |
Runs
A run's status is one of queued, running, waiting_approval, done, failed, stopped.
Method and path | Body | What |
|---|---|---|
|
| |
| Stored events after sequence N (see Run events) | |
|
| |
| Server-Sent Events: replay, then live until the run ends | |
| A queued run's | |
|
| Approve a Plan-mode plan, optionally as edited |
|
| A new plan from your instruction |
|
| Answer the open question card: |
| Stop after the current step | |
| Model calls of the run: tokens and cost per model |
Example: approve a plan with one line changed.
curl -s -X POST "$VC/runs/$RUN/approve" $AUTH -H "Content-Type: application/json" -d '{
"approve": true,
"plan": ["Add a new habit with a name and colour", "Tick off habits completed today", "Weekly summary per habit"]
}'Projects
Method and path | What |
|---|---|
| Your projects: |
| One project |
|
|
| Delete the project |
| The app's file list (exactly what is exported) |
| One file's text |
| The code as a zip (see Export formats) |
| Preview state and address ( |
| The checks of the latest runs with results and screenshots |
| Redeploy the latest delivered version |
| Projects and chats as the sidebar shows them |
{"id": "048c3eb3-dfd8-40aa-bdb5-07b1bcce02b0", "owner_id": 3, "name": "Habit tracker with streaks and history", "archived": false, "preview_status": "starting", "live_url": "", "stack": "fastapi-react", "stack_chosen_by": "engine", "integrations": {}, "created_at": "2026-11-18T10:05:32.219Z"}Uploads
Method and path | What |
|---|---|
|
|
| Upload (multipart |
| Files of the chat |
| Download one |
Memory
Method and path | What |
|---|---|
| Your memory entries |
| Add one |
| Remove one |
Billing
Method and path | What |
|---|---|
| (no sign-in) Plans and prices from REM Payments; |
| Your plan, |
|
|
| Cancel at the end of the period |
| Your invoices |
| Credit movements |
{"enabled": true, "payer": "user:3", "can_buy": true, "plan": {"slug": "free", "code": "free", "name": "Free", "credits_per_cycle": 100}, "status": "free", "balance": {"free": 100, "plan": 0, "rollover": 0, "topup": 0, "total": 100, "available": 100, "held": 0}, "low": true, "credits_name": "Vibe Coder credits"}Other public endpoints
Method and path | What |
|---|---|
| Service health |
| The templates: |
| Send feedback (what the account menu's Send feedback uses) |