Concepts
Terms you'll see often in DETPUL, in short.
- Project
- The DETPUL equivalent of an application. It has a name and an auto-generated slug (
name-xxxxxx). A project can have multiple deployments (its deploy history). - Deployment
- A single deploy attempt. It's in one of these states: Queued, Building, Deploying, Live, Failed, or Canceled (see Deploy — lifecycle).
- Subdomain
- Every live deployment automatically gets a
<deployment-id>.detpul.appaddress. You don't need to configure any extra DNS. - API key
- The authentication key for the CLI (prefixed with
detpul_sk_...). Created from the Dashboard → API Keys page. The token is shown only once, at creation time — afterward you can only revoke it, never see it again. - Session vs. API key
- When you log in to the dashboard with email + password, a session cookie is created. The CLI, on the other hand, uses an API key (
Authorization: Bearer detpul_sk_...). Both reach the same endpoints, and both can only see your own account's projects. - Free tier
- The free plan is limited to 1 active project. Once the limit is reached, new project creation requests are rejected; delete your existing project to continue.