List projects
List the caller's owned projects from the server inventory — each with name, site_url, custom domains, the owning org (org_id), and status. A non-admin caller sees every project owned by an org on which their principal holds an active membership; admin credentials see all. Soft-deleted (tombstone) projects are NEVER listed; archived projects are hidden by default and opt back in with include=archived. Supports cursor-based pagination. Filter to one org with org_id (authorize-before-reveal: a non-member or guessed id gets the same 403 as a real-but-unauthorized org). Auth: SIWX wallet (SIGN-IN-WITH-X header), a control-plane session bearer (the console's signed-in human — membership-scoped exactly like a SIWX-resolved principal), or admin credentials. Unauthenticated calls return 402 with auth: "SIWX". For tier pricing, use GET /tiers/v1.
Request
- Base URL: https://api.run402.com
- URL: https://api.run402.com/projects/v1
- Auth: one of:
- API key in header SIGN-IN-WITH-X
- HTTP bearer
- API key in header x-admin-key
Query parameters
Maximum number of projects to return (default 50, max 200)
Cursor for pagination (from previous response's next_cursor)
Filter to projects owned by this org (organization). Authorize-before-reveal: a non-member or guessed id returns the same 403 as a real-but-unauthorized org.
Opt archived projects back into the listing (include=archived). Soft-deleted (tombstone) projects are never returned regardless. Any other value is a 400.
Headers
SIWX auth header — base64-encoded JSON payload containing a signed CAIP-122 (EIP-4361) message. See https://docs.x402.org/extensions/sign-in-with-x.
Response
Project list
Example response
{
"projects": [
{
"project_id": "prj_1741340000_0042"
}
]
}Changes
No recorded changes to this operation across all 1 revision of this API.