> ## Documentation Index
> Fetch the complete documentation index at: https://docs.niadra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Who am I

> The space, the source and the scopes of the calling key, to check a key before wiring an agent to it.



## OpenAPI

````yaml openapi/en/cell.json GET /v1/sources/me
openapi: 3.1.0
info:
  title: Niadra data API
  version: '1'
  description: >-
    Writing, context, history, objects, identity, privacy and governance of one
    space. Every space has a stable address, with the space and the region in
    its name.
servers:
  - url: https://{space}.{region}.api.niadra.com
    variables:
      space:
        default: acme-prod
        description: The space, which comes in the source key.
      region:
        default: us-east-2
        description: The region of the space, which also comes in the key.
security: []
paths:
  /v1/sources/me:
    get:
      tags:
        - sources
      summary: Who am I
      description: >-
        Any key, whatever its scopes: the space, the source and what the key may
        do. No customer data.


        **Authentication.** Any source key, whatever its scopes: `Authorization:
        Bearer nia_sk_...`.
      operationId: whoami_v1_sources_me_get
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KeyIdentity'
          description: Successful Response
      security: []
components:
  schemas:
    KeyIdentity:
      additionalProperties: false
      description: >-
        `GET /v1/sources/me`: what a key authenticates as, to check a key before
        wiring an agent to it.
      properties:
        agent_memory:
          description: Whether the space has the agents' own notes turned on.
          title: Agent Memory
          type: boolean
        audience:
          $ref: '#/components/schemas/Audience'
        environment:
          $ref: '#/components/schemas/Environment'
        key_id:
          title: Key Id
          type: string
        purposes:
          description: Sorted.
          items:
            type: string
          title: Purposes
          type: array
        region:
          title: Region
          type: string
        scopes:
          description: Sorted.
          items:
            type: string
          title: Scopes
          type: array
        source_id:
          format: uuid
          title: Source Id
          type: string
        source_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Source Name
        space_id:
          format: uuid
          title: Space Id
          type: string
        tenant_id:
          format: uuid
          title: Tenant Id
          type: string
        vendor:
          anyOf:
            - type: string
            - type: 'null'
          title: Vendor
        verification_ceiling:
          $ref: '#/components/schemas/Verification'
      required:
        - space_id
        - tenant_id
        - region
        - environment
        - source_id
        - key_id
        - scopes
        - audience
        - verification_ceiling
        - purposes
        - agent_memory
      title: KeyIdentity
      type: object
    Audience:
      enum:
        - customer_agent
        - internal_agent
        - human
        - reviewer
        - analyst
        - trigger_target
        - export
      title: Audience
      type: string
    Environment:
      enum:
        - sandbox
        - production
      title: Environment
      type: string
    Verification:
      description: Session verification levels. `no_customer` sits outside the V0-V4 scale.
      enum:
        - V0
        - V1
        - V2
        - V3
        - V4
        - no_customer
      title: Verification
      type: string

````