Me

Who am I? Resolves the authenticated actor, the active org, and the credential mode — the first call to make when wiring up a client.

Attributes

objectstringrequired
actorobjectrequired
orgobjectrequired
modestringrequired
Possible values: live, test
scopesarray of stringrequired

Endpoints

GET/v1/me

The Me object

{
  "object": "context",
  "actor": {
    "type": "api_key",
    "id": "key_8KxQ…"
  },
  "org": {
    "id": "org_3Fy…",
    "name": "Paul's workspace",
    "type": "personal"
  },
  "mode": "live",
  "scopes": []
}

Get the current context

GET/v1/me

Returns the actor, organization, and mode resolved from the credential. Use it to confirm a key is valid and see which org it acts on.

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

Returns

200The resolved request context.

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

Terminal

renza me

GET /v1/me

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

TypeScript

import { createRenzaClient } from "renza-sdk";

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

const me = await renza.me();

Response 200

{
  "object": "context",
  "actor": {
    "type": "api_key",
    "id": "key_8KxQ…"
  },
  "org": {
    "id": "org_3Fy…",
    "name": "Paul's workspace",
    "type": "personal"
  },
  "mode": "live",
  "scopes": []
}