Console

Organizations & projects

Organizations hold your people and policies; projects isolate your resources.

Organizations

An organization represents your company on UPGREAT. It owns members, roles, IAM policies, billing and the audit log. The person who creates an organization becomes its owner.

You can belong to several organizations and switch between them with the organization switcher in the Console. Programmatically, list them with GET /v1/orgs.

List your organizations

curl https://api.upgreat.ai/v1/orgs \
  -H "Authorization: Bearer <access-token>"

Projects

A project is a workspace inside an organization. It is the boundary for resources: inference keys, usage and cost, and soon compute and storage. Use separate projects to keep environments apart — for example production and staging — so keys, limits and spend never mix.

Create a project

curl -X POST https://api.upgreat.ai/v1/orgs/{orgId}/projects \
  -H "Authorization: Bearer <access-token>" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Production", "slug": "production" }'

A project per environment

Keys are scoped to a project, and usage is reported per project. Splitting environments into their own projects gives you clean cost attribution and lets you revoke a whole environment's access at once.

Where resources live

Inference keys — per project. See Inference keys.
Usage & cost — rolled up per project and per organization. See Usage & billing.
Members, roles & policies — per organization. See Members & roles.