Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.leaf7.fun/llms.txt

Use this file to discover all available pages before exploring further.

​
Project Management

Projects are the core unit on Leaf7. Each project represents a single script or script hub with its own source code, keys, settings, and analytics.

​
Create a project

Every project gets a unique project_id (UUID) on creation. This ID is used across all endpoints.
POST /api/vendor/projects

​
Headers

NameTypeRequiredDescription
AuthorizationString✅Bearer YOUR_API_KEY

​
Request Body

NameTypeRequiredDescription
nameString✅Display name of your project (max 100 chars)
descriptionString❌Short description (max 255 chars)
ffa_activeBoolean❌Enable Free-For-All mode (no key required). Default: false
webhook_urlString❌Discord webhook URL for execution notifications
notify_enabledBoolean❌Toggle webhook notifications. Default: true
silent_modeBoolean❌Suppress debug output in the Roblox console. Default: false
curl -X POST https://auth.leaf7.fun/api/vendor/projects \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Premium Hub",
    "description": "My premium script hub",
    "ffa_active": false,
    "webhook_url": "https://discord.com/api/webhooks/...",
    "notify_enabled": true,
    "silent_mode": false
  }'

{
    "project_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Premium Hub",
    "description": "My premium script hub",
    "ffa_active": false,
    "is_active": true,
    "webhook_url": "https://discord.com/api/webhooks/...",
    "notify_enabled": true,
    "silent_mode": false,
    "encrypted_source": null,
    "version": "0.0.0"
}

​
Get all projects

GET /api/vendor/projects Returns all projects owned by the authenticated vendor.

​
Headers

NameTypeRequiredDescription
AuthorizationString✅Bearer YOUR_API_KEY
[
    {
        "project_id": "a1b2c3d4-...",
        "name": "Premium Hub",
        "description": "My premium script hub",
        "ffa_active": false,
        "is_active": true,
        "webhook_url": null,
        "notify_enabled": true,
        "silent_mode": false,
        "encrypted_source": "print('Hello World')",
        "version": "0.0.3"
    }
]
The encrypted_source field in the response contains the decrypted raw source code for display purposes. It is stored encrypted at rest on the server.

​
Get a single project

GET /api/vendor/projects/{project_id}

​
Path Parameters

NameTypeRequiredDescription
project_idString✅UUID of the project
{
    "project_id": "a1b2c3d4-...",
    "name": "Premium Hub",
    "ffa_active": false,
    "is_active": true,
    "encrypted_source": "print('Hello World')",
    "version": "0.0.3"
}

​
Update a project

PUT /api/vendor/projects/{project_id} Update any project property. Only include fields you want to change — unspecified fields remain unchanged.

​
Path Parameters

NameTypeRequiredDescription
project_idString✅UUID of the project

​
Request Body

NameTypeRequiredDescription
nameString❌New project name
descriptionString❌New description
ffa_activeBoolean❌Toggle FFA mode
encrypted_sourceString❌Raw Lua source code to upload
webhook_urlString❌Discord webhook URL
notify_enabledBoolean❌Toggle notifications
silent_modeBoolean❌Toggle silent mode
hwid_reset_cooldownInteger❌Hours between allowed HWID resets (via bot)
discord_role_idString❌Discord role ID to assign to buyers
versionString❌Manual version override (e.g. "1.2.0")
When you upload new source code via encrypted_source, the version auto-increments the patch number unless you explicitly set version in the same request.
L7_SEND_WEBHOOK macros in your source code are automatically preprocessed on upload. The webhook URLs and templates are extracted and stored securely — they never reach the client.
curl -X PUT https://auth.leaf7.fun/api/vendor/projects/PROJECT_ID \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "encrypted_source": "print(\"Hello from Leaf7!\")\nprint(L7_LinkedDiscordID)"
  }'

{
    "project_id": "a1b2c3d4-...",
    "name": "Premium Hub",
    "version": "0.0.4",
    "encrypted_source": "print(\"Hello from Leaf7!\")..."
}

​
Delete a project

DELETE /api/vendor/projects/{project_id}
This action is irreversible. All associated keys, buyer keys, and webhook templates will be permanently deleted.

​
Path Parameters

NameTypeRequiredDescription
project_idString✅UUID of the project to delete
(Empty response — project deleted successfully)