API Reference
Automate your vaults and query momentum vitals using our developer API. Standard REST architecture.
Authentication
Provide your API secret key as a Bearer token in the Authorization header of all outgoing requests.
Authorization: Bearer gf_live_...
Base URL
All requests must be made over HTTPS. HTTP requests will be redirected to secure connections automatically.
https://api.Ghostal.ai/v1
Endpoints
POST/v1/vault/upload
Upload reels, image assets, or captions to your vault programmatically.
Request Body
{
"media_url": "https://storage.yoursite.com/reels/vid_9281.mp4",
"media_type": "VIDEO",
"default_caption": "Life updates from the road 📸",
"tags": ["travel", "bts"]
}Response (JSON 200 OK)
{
"id": "vlt_87f191b9",
"status": "PROCESSED",
"media_url": "https://cdn.Ghostal.ai/vlt_87f191b9.mp4",
"created_at": "2026-05-25T10:00:00Z"
}GET/v1/momentum/health
Query consistency score, active alerts, queue risk thresholds, and days remaining.
Request Body
None (Requires Auth Header)
Response (JSON 200 OK)
{
"consistency_score": 96.4,
"queue_health": "OPTIMAL",
"days_remaining": 14.5,
"inactivity_detected": false,
"ghost_mode_active": false
}POST/v1/survival/trigger
Force trigger survival posting mode instantly (useful for unexpected emergencies).
Request Body
{
"reason": "FLIGHT_DELAYED",
"duration_hours": 24
}Response (JSON 200 OK)
{
"session_id": "srv_19b882da",
"ghost_mode_active": true,
"scheduled_posts": 2,
"triggered_at": "2026-05-25T10:05:00Z"
}