Projects

Read a single project (authoritative)

Returns the authoritative server-side view of one project: identity, owning org, tier, lifecycle, public addressing (site_url + custom domains), last deploy, mailbox address(es), and usage versus tier limits. Authorized via the project.read action - a control-plane principal (SIWx wallet or session) with at least viewer access to the owning org, or platform admin. Authorize-before-reveal: a non-authorized caller (including a guessed id) gets the same 403, never a 404 that confirms existence. No secret or key value is ever returned.

get/projects/v1/{project_id}

Request

Base URL: https://api.run402.com
URL: https://api.run402.com/projects/v1/{project_id}
Auth: one of:
- HTTP bearer
- API key in header SIGN-IN-WITH-X

Path parameters

project_idstring required

Run402 project ID. Public IDs are not UUIDs.

Example:prj_1741340000_0042

Response

The authoritative project view.

project_idstring

Run402 project ID. Public IDs are not UUIDs.

public_idstring

namestring nullable

org_idstring

tierstring

effective_statusstring

organization_lifecycle_statestring

site_urlstring nullable

custom_domainsstring[]

mailboxstring[]

created_atstring date-time

created_bystring nullable

Legacy creating-principal field retained unchanged.

Example response

{
  "project_id": "prj_1741340000_0042",
  "public_id": "abc123",
  "tier": "team",
  "effective_status": "active",
  "organization_lifecycle_state": "active",
  "site_url": "https://my-app.run402.com",
  "usage": {
    "storage_limit": "250 MB"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.