Account

Get the account

GET https://api.scenema.ai/v1/me returns who the request acts as: the user, the workspace it works in, that workspace’s plan and its credits.

{
  "user": { "id": "user_7c2e91a04b6d3f8", "email": "ada@example.com", "name": "Ada Lovelace", "image": null },
  "workspace": { "id": "wks_4559d9dd5dc8d53", "name": "Ada's workspace" },
  "plan": {
    "id": "creator",
    "name": "Creator",
    "status": "active",
    "billingCycle": "monthly",
    "renewsAt": "2026-12-06T00:00:00.000Z",
    "cancelsAtPeriodEnd": false
  },
  "credits": { "available": 9380, "monthly": 6200, "granted": 100, "purchased": 3080 }
}

Field	Meaning
`workspace`	An API key works in the workspace it was made in. An app signed in as the user works in the workspace the user has open.
`plan.id`, `plan.name`	The plan in effect, an admin override included.
`plan.billingCycle`, `plan.renewsAt`	`monthly` or `annual`, and when the current period ends. Both are null on the Free plan.
`plan.cancelsAtPeriodEnd`	True when the plan ends at `renewsAt` instead of renewing.
`credits.available`	Credits that can be spent now.
`credits.monthly`	What is left of this period’s plan allowance. It resets at renewal.
`credits.granted`, `credits.purchased`	Granted credits (such as the signup grant) and bought top ups. Both stay until spent.

Delete the account

DELETE https://api.scenema.ai/v1/me deletes the signed in user’s account at once:

A paid plan on any workspace the user owns ends now. There is no refund for the rest of the period.
Every session, API key and app connection stops working, and the user is signed out everywhere.
The user’s workspaces and projects are removed.
The user leaves every team they belong to.

It answers 200 with { "deleted": true }.

A user who owns a team that others still work in gets 409 with code: ACCOUNT_OWNS_TEAMS. The message names the teams. They transfer each team to another member, or remove its members, and try again.

The same Google, Discord or Apple account can sign up again later. It starts as a new account with nothing from the deleted one.