List orgs

GET/v1/orgs

Lists the orgs the credential can act on. A key is bound to one org, so this returns it.

Requires an API key (bearer), scoped to the active org.

Returns

200The accessible org(s).

Failures use the standard error envelope with a closed set of codes.

Terminal

renza orgs list

GET /v1/orgs

curl https://api.renza.io/v1/orgs \
  -H "Authorization: Bearer $RENZA_API_KEY"

TypeScript

import { createRenzaClient } from "renza-sdk";

const renza = createRenzaClient({ apiKey: process.env.RENZA_API_KEY! });

const page = await renza.orgs.list();

Response 200

{
  "object": "list",
  "url": "/v1/decks",
  "data": [
    {
      "id": "org_3Fy…",
      "object": "org",
      "name": "Paul's workspace",
      "type": "personal",
      "metadata": {},
      "created_at": "2026-06-19T10:30:00.000Z",
      "updated_at": "2026-06-19T10:30:00.000Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}