Orgs

The key's org, and org creation for platform keys.

Method	Path	Scope	Summary
POST	/orgs/	platform	Create Org
PATCH	/orgs/{slug}/plan	bearer	Set Plan
GET	/orgs/me	any key	My Org

Try it

curl -sf -H "Authorization: Bearer $VIGIL_KEY" "$VIGIL_URL/orgs/me"

Routes

POST /orgs/

Create Org. Scope: platform.

Request body:

{
  "slug": "string",
  "name": "string"
}

Field	Type	Required	Notes
slug	string	yes
name	string	yes

Response 200:

{
  "id": 0,
  "slug": "string",
  "name": "string",
  "created_at": "2026-09-08T00:00:00Z",
  "plan": "string",
  "limits_json": "string | null",
  "billing_email": "string | null"
}

PATCH /orgs/{slug}/plan

Set Plan. Scope: bearer.

Change an org's plan, override single limits, or set the billing email. Changing the plan clears overrides.

Parameter	In	Required	Type	Notes
slug	path	yes	string

Request body:

{
  "plan": "string | null",
  "limits": {},
  "billing_email": "string | null"
}

Field	Type	Required	Notes
plan	string | null	no
limits	object | null	no
billing_email	string | null	no

Response 200:

{
  "id": 0,
  "slug": "string",
  "name": "string",
  "created_at": "2026-09-08T00:00:00Z",
  "plan": "string",
  "limits_json": "string | null",
  "billing_email": "string | null"
}

GET /orgs/me

My Org. Scope: any key.

Response 200:

{
  "id": 0,
  "slug": "string",
  "name": "string",
  "created_at": "2026-09-08T00:00:00Z",
  "plan": "string",
  "limits_json": "string | null",
  "billing_email": "string | null"
}

Generated from openapi.json (VIGIL 0.2.0). Scopes follow the router dependencies in VIGIL_SPEC.md section 4.2.