Developer FAQ
Quick answers to common developer questions about the API, AI, isolation, and configuration.
#Purpose
Answer the questions developers ask most, with Portal-accurate responses.
#Architecture
This page summarizes answers documented in detail across the Developer Documentation section.
#How it works
1
Find the question
Scan the list below.
2
Follow the link
Each answer links to the detailed page.
3
Verify against the Portal
The Portal remains the source of truth.
4
Ask support if needed
Contact support for anything unresolved.
#Reference
#Frequently asked
| Question | Answer |
|---|---|
| Is there a public API? | Yes — a read-only v1 for leads and invoices, secured by org API keys. |
| Can I write via the API? | Not yet — the surface is read-only today; a leads:write scope is defined for the future. |
| Which AI provider is used? | Anthropic's Claude; there is no multi-provider switching. |
| Can I add a custom role? | No — roles are a fixed set; assign the closest fit. |
| How is tenant data isolated? | PostgreSQL row-level security scopes every query to the organization. |
| Does email work out of the box? | No — configure a provider (Resend); the default is none and SMTP is a stub. |
| Are webhooks available? | Yes — HMAC-signed outbound events with retry/backoff, plus inbound Stripe/Twilio/WhatsApp. |
#Implementation notes
- Answers here mirror the detailed developer pages.
- The Portal is authoritative if anything differs.
#Limitations
Known limitations
- This FAQ is a summary, not a substitute for the detailed pages.
- Capabilities expand over time; re-check the relevant page.
#Security considerations
Security
- Follow the security guidance on each detailed page.
- Never expose secrets in code or logs.
#Best practices
- Use the linked detailed pages for implementation.
- Verify against the Portal.
- Handle API error codes explicitly.
#Related documentation
Still need help?
Can’t find what you’re looking for? The DevSphere OS team is happy to help.
Was this page helpful?