FAQ

General

What is the LegionEdge Platform?

The LegionEdge Platform is a unified developer platform for building, deploying, and managing applications. It provides authentication, project management, resource allocation, and integrations with LegionEdge products like Nokuva (AI agents), Tovac (data context), and Foltrac (infrastructure).

What is the difference between v1 and v2?

Platform v2 is a complete rewrite with a redesigned API surface, improved RBAC, an event-driven architecture, a plugin system, and full TypeScript support. All new projects should use v2. See the platform overview for details on what changed.

Is there a free tier?

Yes. The free tier includes up to 3 projects, 5 team members, and 60 API requests per minute. See the pricing page on the LegionEdge website for full plan details.

Which runtime environments are supported?

The SDK supports Node.js 18+, Deno, Bun, and edge runtimes (Cloudflare Workers, Vercel Edge Functions). Browser support is available for the OAuth flow only.

Authentication

How do I choose between API keys and OAuth?

Use API keys for server-to-server communication, CI/CD pipelines, and backend services. Use OAuth for applications where end users authenticate with their own LegionEdge accounts.

My API key was compromised. What should I do?

Immediately revoke the key in the dashboard or via the API:

await client.apiKeys.revoke("key_compromised_id");

Then create a new key and update your environment variables. Review the audit log for any unauthorized actions taken with the compromised key.

How long do access tokens last?

Access tokens expire after 1 hour. Use the refresh token to obtain a new access token. The SDK handles this automatically when configured with a refresh token.

Projects and Resources

How many projects can I create?

Plan limits apply: Free (3 projects), Pro (50 projects), Enterprise (unlimited). Organization admins can view current usage in the dashboard.

Can I move a project between organizations?

Project transfers between organizations are not currently supported. You can export project configuration and recreate it in the target organization.

What happens when I delete a project?

Deleting a project deprovisions all associated resources, removes all team memberships, and deletes all deployment history. This action is irreversible.

API and SDK

What are the rate limits?

Rate limits depend on your plan: Free (60 req/min), Pro (600 req/min), Enterprise (6,000 req/min). Rate limit headers are included in every response. See the API overview for details.

Does the SDK support automatic retries?

Yes. Configure retries when creating the client:

const client = new LegionEdge({
  apiKey: process.env.LEGIONEDGE_API_KEY!,
  retries: {
    maxRetries: 3,
    retryableStatusCodes: [429, 502, 503, 504],
  },
});

How do I handle pagination?

All list endpoints return paginated responses. Use the page and perPage parameters, or iterate with the async iterator:

for await (const project of client.projects.listAll({ organizationId: orgId })) {
  console.log(project.name);
}

Billing

How does billing work?

Billing is at the organization level. You are charged based on your plan tier plus usage-based charges for resources (compute, storage, API calls) that exceed your plan's included limits.

Can I downgrade my plan?

Yes. Downgrading takes effect at the end of your current billing period. If your usage exceeds the new plan's limits, you will need to reduce usage before the downgrade is applied.

Next Steps

• Check the troubleshooting guide for common issues.
• Contact support if your question is not answered here.