---
title: "Keyring"
method: POST
path: "/v1/devices/keyring"
---

# Keyring

`POST /v1/devices/keyring`

## Request

- Base URL: `https://api.flanner.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.flanner.io/v1/devices/keyring`
- Auth: none declared

Every enrolled device's public key, for this caller's organization.

What a device needs to verify a teammate's artifact without asking
anyone at the moment of verification (PRD §14.4). It matters that
this covers the whole organization and not just the peer in front
of you: a peer relays artifacts authored by devices you may never
connect to directly, and each is verified against its own author's
key.

Public keys only, so this discloses which machines exist and
nothing they could be impersonated with.

## Request body

- object

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/flanner/apis/flanner-control-plane.md) · [All operations](https://skmtc.dev/flanner/apis/flanner-control-plane/llms.txt) · [OpenAPI document](https://skmtc.dev/flanner/apis/flanner-control-plane/revisions/96c571cfab10?raw)
