---
title: "Identify this agent"
method: GET
path: "/v1/agent-members/current"
tags: ["Start", "Founder login"]
---

# Identify this agent

`GET /v1/agent-members/current`

## Request

- Base URL: `https://hyperscale0.ai`
- URL: `https://hyperscale0.ai/v1/agent-members/current`
- Auth: HTTP bearer

Shows the authenticated installation and its authority.

## Query parameters

- `tenantId` string, required: Organization tenant ID

## Headers

- `X-Hyperscale-Environment` 'sandbox' | 'live'

## Response `200`

Success

- AgentMemberCurrentOutput
  - `memberId` string, required
  - `agentName` string, required
  - `installationId` string, required
  - `companyId` string, required: Organization tenant ID
  - `delegatorUserId` string, required
  - `principalId` string, required
  - `ceiling` string[], required
  - `status` 'active' | 'revoked', required
  - `createdAt` string, date-time, required
  - `revokedAt` string, date-time, nullable, required
  - `grants` object[], required
    - `grantId` string, required
    - `clientId` string, required
    - `resource` string, required
    - `scopes` string[], required
    - `status` 'active' | 'revoked', required
    - `environment` 'sandbox', required
    - `productIds` string[], nullable, required
    - `buildDigests` string[], nullable, required
    - `connectedAt` string, date-time, nullable, required
    - `lastUsedAt` string, date-time, required
    - `expiresAt` string, date-time, required
  - `delegatorEmail` string, required
  - `delegatorName` string, nullable, required
  - `companyName` string, nullable, required
  - `delegatorRole` union, required: The delegator's role in the company; the agent acts within it
    - 'owner' | 'admin' | 'developer' | 'operations' | 'finance' | 'viewer'
    - string: Hyperscale custom team role ID
  - `teamId` string, required
  - `currentGrantId` string, required
  - `nextStep` string, nullable, required: How the founder gives this agent another Product: the `hyperscale agent setup --product` command to run in the agent's folder. Null when the grant reaches every Product.

## Other responses

- `default`: ErrorResponse. See x-error-codes and x-errors for codes, HTTP statuses and retry guidance.

---

[API](https://skmtc.dev/hyperscale0/apis/hyperscale-product-api.md) · [All operations](https://skmtc.dev/hyperscale0/apis/hyperscale-product-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hyperscale0/apis/hyperscale-product-api/revisions/e9e8faa044d5?raw)