fatheron-dev Pgp API
The pgp API from fatheron-dev — 5 operation(s) for pgp.
The pgp API from fatheron-dev — 5 operation(s) for pgp.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/fatheron-dev:fatheron-dev-pgp-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Fat Heron Builders Pgp API
description: 'Fat Heron for Developers (fatheron.dev) — automation endpoints for builders and agents. Authenticate with a builders JWT or account API key (`X-API-Key: fh_live_…`). Versioned under `/v1`; see fatheron.dev/docs for the capability index and versioning policy.'
version: 0.3.0
security:
- bearerAuth: []
- apiKeyAuth: []
tags:
- name: pgp
paths:
/v1/pgp/keys/lookup:
get:
tags:
- pgp
summary: Lookup Pgp Key
operationId: lookup_pgp_key_v1_pgp_keys_lookup_get
parameters:
- name: email
in: query
required: true
schema:
type: string
minLength: 3
title: Email
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/mail/pgp/public-key:
get:
tags:
- pgp
summary: Get Mailbox Pgp Public Key
operationId: get_mailbox_pgp_public_key_v1_mail_pgp_public_key_get
parameters:
- name: mailbox_id
in: query
required: true
schema:
type: string
minLength: 1
title: Mailbox Id
- name: Authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: fh_access_token
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Fh Access Token
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
put:
tags:
- pgp
summary: Put Mailbox Pgp Public Key
operationId: put_mailbox_pgp_public_key_v1_mail_pgp_public_key_put
parameters:
- name: Authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: fh_access_token
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Fh Access Token
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PublishPgpPublicKeyRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
delete:
tags:
- pgp
summary: Delete Mailbox Pgp Public Key
operationId: delete_mailbox_pgp_public_key_v1_mail_pgp_public_key_delete
parameters:
- name: mailbox_id
in: query
required: true
schema:
type: string
minLength: 1
title: Mailbox Id
- name: Authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: fh_access_token
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Fh Access Token
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/mail/pgp/private-key-backup:
get:
tags:
- pgp
summary: Get Mailbox Pgp Private Key Backup
operationId: get_mailbox_pgp_private_key_backup_v1_mail_pgp_private_key_backup_get
parameters:
- name: mailbox_id
in: query
required: true
schema:
type: string
minLength: 1
title: Mailbox Id
- name: full
in: query
required: false
schema:
type: boolean
default: false
title: Full
- name: Authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: fh_access_token
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Fh Access Token
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
put:
tags:
- pgp
summary: Put Mailbox Pgp Private Key Backup
operationId: put_mailbox_pgp_private_key_backup_v1_mail_pgp_private_key_backup_put
parameters:
- name: Authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: fh_access_token
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Fh Access Token
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PutPgpPrivateKeyBackupRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
delete:
tags:
- pgp
summary: Delete Mailbox Pgp Private Key Backup
operationId: delete_mailbox_pgp_private_key_backup_v1_mail_pgp_private_key_backup_delete
parameters:
- name: mailbox_id
in: query
required: true
schema:
type: string
minLength: 1
title: Mailbox Id
- name: Authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: fh_access_token
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Fh Access Token
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/.well-known/openpgpkey/policy:
get:
tags:
- pgp
summary: Wkd Policy
operationId: wkd_policy__well_known_openpgpkey_policy_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
/.well-known/openpgpkey/{domain}/hu/{local_hash}:
get:
tags:
- pgp
summary: Wkd Hu Lookup
operationId: wkd_hu_lookup__well_known_openpgpkey__domain__hu__local_hash__get
parameters:
- name: domain
in: path
required: true
schema:
type: string
title: Domain
- name: local_hash
in: path
required: true
schema:
type: string
title: Local Hash
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
PutPgpPrivateKeyBackupRequest:
properties:
mailbox_id:
type: string
minLength: 1
title: Mailbox Id
email:
type: string
maxLength: 320
minLength: 3
title: Email
fingerprint:
type: string
maxLength: 64
minLength: 16
title: Fingerprint
public_key_armored:
type: string
minLength: 32
title: Public Key Armored
credential_id:
type: string
maxLength: 512
minLength: 8
title: Credential Id
salt:
type: string
maxLength: 512
minLength: 8
title: Salt
passphrase_iv:
type: string
maxLength: 128
minLength: 8
title: Passphrase Iv
wrapped_passphrase:
type: string
maxLength: 8192
minLength: 8
title: Wrapped Passphrase
private_key_iv:
type: string
maxLength: 128
minLength: 8
title: Private Key Iv
wrapped_private_key:
type: string
maxLength: 200000
minLength: 32
title: Wrapped Private Key
type: object
required:
- mailbox_id
- email
- fingerprint
- public_key_armored
- credential_id
- salt
- passphrase_iv
- wrapped_passphrase
- private_key_iv
- wrapped_private_key
title: PutPgpPrivateKeyBackupRequest
PublishPgpPublicKeyRequest:
properties:
mailbox_id:
type: string
minLength: 1
title: Mailbox Id
public_key_armored:
type: string
minLength: 32
title: Public Key Armored
fingerprint:
type: string
maxLength: 64
minLength: 16
title: Fingerprint
type: object
required:
- mailbox_id
- public_key_armored
- fingerprint
title: PublishPgpPublicKeyRequest
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: Keycloak access token.
apiKeyAuth:
type: apiKey
in: header
name: X-API-Key
description: Account API key (fh_live_…).