> ## Documentation Index > Fetch the complete documentation index at: https://docs.engini.ai/llms.txt > Use this file to discover all available pages before exploring further. # Who am I > Returns the identity of the principal the request is authenticated as: full name, email, current company, role, and caller type (userType). For an x-api-key request the identity returned is the key's owner (the key acts as the owner) and userType is reported as apiuser; a hard-deleted (anonymized) profile is reported as anonymous; every other caller is user. Fields resolved from the current company/role (currentCompany, role) are null when no company context could be resolved for the caller. ## OpenAPI ````yaml /developers/api-reference/openapi.json get /v1/auth/whoami openapi: 3.0.0 info: title: Engini API version: v1 description: The Engini public API. servers: - url: https://api.engini.io security: - Bearer: [] - ApiKey: [] tags: - name: Auth description: Identify the caller a Developer API request is authenticated as. - name: On-prem agents description: >- Provision and manage agents that run Engini tasks inside a customer's network. - name: Applications description: >- Discover the applications (toolkits) available in Engini and their connection requirements. - name: Tools description: Browse and execute the tools exposed by Engini applications. - name: Toolsets description: Manage toolsets - named groupings of connections and tools. - name: McpServers description: >- Inspect and maintain MCP servers - the account-wide endpoints that expose Engini tools and workflows over the Model Context Protocol. Distinct from the MCPClient connection kind, which is Engini consuming a third-party MCP server. - name: Connections description: >- Manage connections to applications, including OAuth sign-in and default-connection selection. - name: Triggers description: >- Create triggers that fire when something changes in a connected app, and manage the destinations their events are delivered to. paths: /v1/auth/whoami: get: tags: - Auth summary: Who am I description: >- Returns the identity of the principal the request is authenticated as: full name, email, current company, role, and caller type (userType). For an x-api-key request the identity returned is the key's owner (the key acts as the owner) and userType is reported as apiuser; a hard-deleted (anonymized) profile is reported as anonymous; every other caller is user. Fields resolved from the current company/role (currentCompany, role) are null when no company context could be resolved for the caller. operationId: Auth_WhoAmI parameters: [] responses: '200': description: The acting principal's identity. content: application/json: schema: $ref: '#/components/schemas/WhoAmIResponse' example: fullName: Jane Example email: jane@example.com currentCompany: Example Co. role: Admin userType: user '400': description: Bad request - malformed body or invalid parameters. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized - missing or invalid bearer token. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Forbidden - the caller lacks access to the resource. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Not found - the resource does not exist. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '429': description: Too many requests - rate limit exceeded. headers: Retry-After: description: Number of seconds to wait before retrying. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Internal server error - an unexpected error occurred. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - Bearer: [] - ApiKey: [] x-codeSamples: - lang: python label: Python source: |- from engini import Engini client = Engini() # reads ENGINI_API_KEY me = client.auth.whoami() print(me.email) - lang: typescript label: TypeScript source: |- import { Engini } from "@engini/sdk"; const client = new Engini(); // reads ENGINI_API_KEY const me = await client.auth.whoami(); console.log(me.email); - lang: bash label: CLI source: engini whoami --json components: schemas: WhoAmIResponse: type: object description: >- Identity of the principal a Developer API request is authenticated as, returned by GET /v1/auth/whoami. For x-api-key requests the identity is the token's owner (the key acts as the owner) and UserType is "apiuser". additionalProperties: false required: - userType properties: fullName: type: string description: The acting user's full name. nullable: true email: type: string description: The acting user's email address. nullable: true currentCompany: type: string description: Display name of the account/company the request is scoped to. nullable: true role: type: string description: Role within the current company (e.g. "Admin", "Member"). nullable: true userType: type: string description: >- Caller type: "apiuser" (x-api-key), "anonymous" (deleted profile), or "user". ErrorResponse: type: object description: >- Unified machine-readable error envelope returned by every non-200 Developer API response. additionalProperties: false required: - errorCode - message - requestId - timestamp properties: errorCode: type: string description: Machine-readable error code identifying the failure. message: type: string description: Human-readable error message. requestId: type: string description: Identifier of the request, for support/correlation. timestamp: type: string description: Timestamp when the error occurred (ISO 8601). details: type: array description: Per-field validation details, when applicable. nullable: true items: $ref: '#/components/schemas/ErrorDetail' ErrorDetail: type: object description: A single field-level error detail within an ErrorResponse. additionalProperties: false required: - field - issue properties: field: type: string description: Name of the field the issue relates to. issue: type: string description: Description of the issue with the field. securitySchemes: Bearer: type: http description: Enter your JWT token scheme: bearer bearerFormat: JWT ApiKey: type: apiKey description: >- Opaque Developer API key (prefix `eng_`). Authenticates as the key's owner and resolves the account automatically. name: x-api-key in: header ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.