Docs/Projects

Projects

A project represents one app or service. Each project gets its own client_id and client_secret, its own set of redirect URIs, end users, and analytics.

Create a project

You can create projects from the dashboard or via the API. The client_secret is only shown once at creation — store it securely.

create-project.tstypescript
const res = await fetch("https://astapa.com/api/platform/projects", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Cookie": "session=your_session_cookie",
  },
  body: JSON.stringify({
    name: "My SaaS App",
    redirect_uris: ["https://myapp.com/callback"],
  }),
});

const { project } = await res.json();
// project.client_id     → "proj_abc123..."
// project.client_secret → "sec_xyz789..." (shown once!)

Authentication

All project management endpoints require a valid session cookie (you must be logged in to astapa.com). The session identifies you as the builder who owns the project.

API reference

Redirect URIs

Redirect URIs are the allowed callback URLs for the OAuth flow. They must be HTTPS in production (localhost is allowed for development).

Analytics

Next steps

API Playground
Click "Try it" on any endpoint to get started.
Projects — Docs — astapa