Agent-readable docs index: /llms.txt. Full docs in one file: /llms-full.txt. Download /docs.zip to grep all markdown files locally.

Get the public key

/api/v1/owner/public-keyGET
Returns the installation public verification key. This endpoint never returns the private signing key.
Examples are synthetic and illustrate response shape; IDs, signatures, and credentials are not usable authority.
Authorization
ownerSession *cookie halfspan_session
Authenticated HttpOnly owner session. Not an executor credential.
Response
200 · Successful response. A paused run is an application outcome, not an HTTP error.
algorithm *"Ed25519"
publicKey *string
400 · Request validation failed.
error *string
reasonCode?string
401 · Sign in to the Halfspan workspace.
error *string
reasonCode?string
403 · Console requests must come from the local owner workspace.
error *string
reasonCode?string
500 · The local service could not complete this request.
error *string
reasonCode?string
Request example
curl -X GET "https://service.example.com/api/v1/owner/public-key" \
  -b "halfspan_session=<token>"
Response example
{
  "algorithm": "Ed25519",
  "publicKey": "<installation Ed25519 public key PEM>"
}