API reference

https://rebornpad.dev/api/v1

Authorization: Bearer rp_7hQ2xLm9vKdT4pRnW8sYbAc3

List collections

GET /api/v1/collections

Returns every collection reachable with the current token, newest first.

curl https://rebornpad.dev/api/v1/collections \
  -H "Authorization: Bearer $RP_TOKEN"

{
  "collections": [
    {
      "id": "col_9fK2mQ",
      "name": "monorepo/api",
      "chunks": 18422,
      "dims": 1024,
      "bytes": 412839104,
      "updated_at": "2026-07-16T20:41:07Z"
    }
  ],
  "next": null
}

Results are paginated at 50. When next is not null, pass it back as the cursor query parameter.

Create a collection

POST /api/v1/collections

Field	Type	Notes
name	string	Required. Free-form label, 1–128 characters.
dims	integer	Embedding width. 256–4096. Fixed after creation.
metric	string	cosine (default), dot, or l2.

curl -X POST https://rebornpad.dev/api/v1/collections \
  -H "Authorization: Bearer $RP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"monorepo/api","dims":1024,"metric":"cosine"}'

Responds 201 with the collection object. Creating a collection with a name that already exists returns the existing one rather than a duplicate, so the call is safe to repeat.

Delete a collection

DELETE /api/v1/collections/{id}

Removes the collection and everything in it. Responds 204. Deletion is immediate and cannot be undone.

Stream chunks into a collection

POST /api/v1/ingest

The write path. Send a chunked request body and keep it open for the whole sync — reopening a connection per batch is the most common cause of slow ingests.

Header	Value
Content-Type	application/x-ndjson
Transfer-Encoding	chunked
X-Collection	Target collection id.
X-Idempotency-Key	Optional. Repeats within 24 hours are ignored.

Each line is one record: the chunk text, its embedding, and whatever metadata you want back at query time.

{"path":"src/auth/session.ts","span":[1,64],"text":"export async function...","vector":[0.0131,-0.0447, ...],"meta":{"lang":"ts","rev":"a91f2c0"}}
{"path":"src/auth/session.ts","span":[64,128],"text":"const rotate = ...","vector":[0.0219,0.0082, ...],"meta":{"lang":"ts","rev":"a91f2c0"}}

The server acknowledges progress on the same connection while you are still writing, so you can apply backpressure instead of buffering:

{"ack":512,"accepted":512,"rejected":0}
{"ack":1024,"accepted":1023,"rejected":1,"errors":[{"line":997,"code":"dims_mismatch"}]}

A full index of a mid-sized repository is normally a few hundred megabytes and takes several minutes. Large monorepos run into the low gigabytes and can take an hour or more; this is the expected shape of the workload, not a fault.

Fetch a packed context bundle

GET /api/v1/query/{bundle}

The read path, and the one your agent will call most. Given a bundle handle, it returns everything the agent needs to resume work: the retrieved chunks, their metadata, and the conversation state saved alongside them.

The response is not JSON. It is a single base64 line: the bundle is serialised, deflated and encoded so that it can be dropped into an agent's context loader without a parser, piped through tools that expect text, or cached as-is.

curl https://rebornpad.dev/api/v1/query/b_4Kd82nQmZs \
  -H "Authorization: Bearer $RP_TOKEN"

HTTP/2 200
content-type: text/plain; charset=utf-8
x-request-id: 8f2a1c0b4e7d
x-bundle-chunks: 64
x-bundle-encoding: deflate+base64

eJyNVMtu2zAQ/BWCpxaQZTt2HNvIoUkPPRQtiiA9FEVB
S2ubDUUKJGVHKPrvXVKSLTtO0IsF7s7Ozs4u/YcKrjSN
6UZrY0ejrNlsBmnKM5nmTFdpxvNRxrJRlmXpZDIej8bp
...

Decode it with whatever your language gives you:

import base64, zlib, json

raw = resp.text.encode()
bundle = json.loads(zlib.decompress(base64.b64decode(raw)))

for chunk in bundle["chunks"]:
    print(chunk["path"], chunk["score"])

Bundle handles are created by a search call and stay valid for 24 hours. They are opaque — do not construct them by hand.

Typical bundles are 40–400 KB. A bundle assembled from a whole-repository sweep can exceed 10 MB, which is why the endpoint sends compressed bytes rather than JSON.

Search a collection

POST /api/v1/search

Runs nearest-neighbour search and returns a bundle handle for /query/ to fetch.

curl -X POST https://rebornpad.dev/api/v1/search \
  -H "Authorization: Bearer $RP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"collection":"col_9fK2mQ","vector":[0.021,-0.004, ...],"k":24,"include_state":true}'

{
  "bundle": "b_4Kd82nQmZs",
  "chunks": 24,
  "expires_at": "2026-07-19T09:12:44Z"
}

Open a session channel

GET /api/v1/stream

A persistent bidirectional channel for an agent session. Context updates flow down as the collection changes; state checkpoints flow up as the agent works. Most integrations open this once at session start and close it when the agent stops.

Parameter	Notes
collection	Required. Collection to follow.
since	Optional checkpoint id. Resumes without replaying the whole session.
keepalive	Seconds between heartbeats. 15–120, default 30.

HTTP/3 is used when the client supports it. Sessions surviving several hours are routine, and the channel is deliberately chatty — heartbeats keep intermediaries from dropping an idle connection.

event: context
data: {"chunks":3,"bundle":"b_7Rm10sQwXz"}

event: checkpoint
data: {"id":"ck_20260718T0912","bytes":48211}

event: ping
data: {}

On disconnect, reconnect with since set to the last checkpoint id. Clients should back off exponentially from 1s to a 30s ceiling.

Service status

GET /api/v1/status

Unauthenticated. Safe to poll from a monitor at up to once a minute.

{
  "status": "operational",
  "region": "eu-north",
  "version": "0.4.2",
  "http3": true
}

The human-readable version lives at /status.

{
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid API token",
    "docs": "https://rebornpad.dev/docs/api#auth"
  }
}