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

# parmana.api.caller_api

Parmana Caller and Key API.

## CallerApi Objects

```python theme={null}
class CallerApi()
```

Caller and Key API.

## Responsibilities

* Report who the API key belongs to and what it may do
* Fetch a signing public key, for offline verification

#### me

```python theme={null}
def me() -> CallerIdentity
```

Who this API key belongs to and what it may do.

Maps to GET /callers/me. Useful to check a key before sending
requests: which principal IDs it may act for and which capabilities
it may request.

#### public\_key

```python theme={null}
def public_key(key_id: str = "default") -> PublicKeyInfo
```

A signing public key of the deployment.

Maps to GET /keys/\{keyId}. Records are signed with the key
"default". Fetch it once, keep the PEM, and pass it to
`parmana.crypto.verify_execution_trust_record_offline()` or
`verify_execution_intent_offline()`. Needs no API key.