Launcher API
The launcher (grroxy) manages projects and provides shared utilities. Default port: 8888.
CA Certificate
| Method | Path | Auth | Description |
|---|
| GET | /cacert.crt | No | Download the CA certificate for HTTPS interception |
Projects
| Method | Path | Auth | Description |
|---|
| GET | /api/project/list | No | List all projects |
| POST | /api/project/new | Yes | Create a new project and start its grroxy-app instance |
| POST | /api/project/open | Yes | Open an existing project by name or ID |
POST /api/project/new body:
{
"name": "my-project"
}
POST /api/project/open body:
{
"project": "my-project"
}
Commands
| Method | Path | Auth | Description |
|---|
| POST | /api/runcommand | Yes | Execute a shell command and save output |
{
"command": "echo hello",
"data": "",
"saveTo": "collection",
"collection": "cmd_output",
"filename": ""
}
Cook
| Method | Path | Auth | Description |
|---|
| POST | /api/cook/search | Yes | Search available Cook patterns and methods |
{
"search": "encode"
}
Files
| Method | Path | Auth | Description |
|---|
| POST | /api/readfile | Yes | Read file from cache, config, or cwd |
| POST | /api/savefile | Yes | Save data to a file |
POST /api/readfile body:
{
"fileName": "output.txt",
"folder": "cache"
}
POST /api/savefile body:
{
"fileName": "output.txt",
"fileData": "hello world",
"folder": "cache"
}
File Watcher
| Method | Path | Auth | Description |
|---|
| GET | /api/filewatcher | No | Watch GRROXY_TEMPLATE_DIR for changes via SSE |
Regex
| Method | Path | Auth | Description |
|---|
| POST | /api/regex | No | Test a regex pattern against a string |
{
"regex": "<title>(.*?)</title>",
"responseBody": "<html><title>Test</title></html>"
}
SQL
| Method | Path | Auth | Description |
|---|
| POST | /api/sqltest | Yes | Execute a raw SQL query |
{
"sql": "SELECT * FROM _projects LIMIT 10"
}
Templates
| Method | Path | Auth | Description |
|---|
| GET | /api/templates/list | No | List all YAML template files |
| POST | /api/templates/new | No | Create or overwrite a template file |
| DELETE | /api/templates/:template | No | Delete a template file by name |
POST /api/templates/new body:
{
"name": "my-template.yaml",
"content": "id: my-template
info:
name: My Template"
}
| Method | Path | Auth | Description |
|---|
| GET | /api/tool/server | No | Start or retrieve a grroxy-tool server instance by ID |
| GET | /api/tool | No | Start a new PocketBase tool instance at the given path |
Updates
| Method | Path | Auth | Description |
|---|
| GET | /api/update/check | No | Check if a newer version is available |
| POST | /api/update | No | Download and install the latest grroxy binaries |