Internal platform

APIs & Slack for Geneus operations

Geneus Tools exposes HTTP checks, Slack slash commands, and @Bot workflows for ancestry support and team automation — all in one service.

Reliability

HTTP

Use these routes for monitoring and service discovery. Protected routes expect a Bearer token when configured.

Liveness

GET /health

JSON response {"status":"ok"} for load balancers and uptime checks.

Landing

GET /

This documentation page — served as HTML for operators and integrators.

Integrations

Slack

Configure these URLs in your Slack app. Signing secret verification applies when SLACK_SIGNING_SECRET is set.

Events API

POST /slack/events

URL verification, app mentions, and retry handling for the Events API.

Slash command

POST /slack/command/mirror

Mirrors command text back to the channel or thread (configure command name in Slack).

Ancestry

POST /slack/command/ancadjust

Accepts kit code and message for ancestry adjustment requests.

Conversations

@Bot mention commands

Mention the app with a command token after @Bot. Unknown commands receive a help reply listing the options below.

Command

@Bot help

help — show this list of available commands

Command

@Bot mirror

mirror <text> — echoes your text back in this thread

Command

@Bot ancadjust

ancadjust <kit_code> <message> — sends an adjustment request