# Signatures: agents ask, people sign

> Ask named people to sign one published version, follow the request, and get a sealed certificate. Your agent can send it; only a signer can sign.

Kind: concept · ~3 min · Verified v0.237.0 · Next: [MCP tools](https://pr-2197-stg.superartifacts.app/docs/reference/mcp.md)

```mermaid
%% hand-drawn: public/docs/diagrams/signing.svg is an animated SVG; this is its text twin.
flowchart LR
  A["Agent: super_publish, one file"] --> V["Version, pinned"]
  A -->|super_signatures request| R["Request open"]
  R -->|emailed link| S["Each signer"]
  S -->|six-digit code, typed name, Sign| R
  R -->|all signed| C["Sealed: certificate to every party"]
  A -.-x|cannot sign| S
```

A **signature request** asks named people to sign **one published version** of one artifact. Each signer opens their own link, proves they hold the inbox, types their name and signs. When everyone has signed, the platform seals the record and every party gets a certificate.

## What your agent can do

With `super_signatures` it can **request** signatures on a version, read a request's **status**, **withdraw** an open request, and **remind** a signer who has not signed. It cannot **sign**. No tool, key or workspace role reaches the step that signs: only the signer's own link, plus the code sent to their inbox, does.

## What can be signed

One version holding **one file of up to 2 MiB**, or the declared source of an official document-template fill. A template-filled document can have runtime files beside its source: the signature covers the source bytes. A declared source uploaded beside a custom page is refused with `source_not_filled`. Other multi-file versions are refused with `unsupported_multifile`. A request names at most 10 people, and each link lasts 14 days.

A version that is part of an open or completed request is **pinned**: nobody can delete it, from the dashboard or through the agent, while that request holds it. See [Versions](https://pr-2197-stg.superartifacts.app/docs/concepts/versions.md).

## What the signer sees

An email with a link. The link opens the document; no account is needed. To sign, they ask for a **six-digit code**, sent to the same address and good for ten minutes, then tick a consent box, type their name and press **Sign**. Five wrong codes lock that signer out. They can decline instead.

## The evidence kept

- the document's fingerprint (a SHA-256 hash), taken again at the moment of signing, so a changed document cannot be signed;
- the code check, the consent wording, the typed name and the time of every step;
- each signer's IP address and browser, encrypted, shown only in the certificate the parties download;
- a chain of every event, sealed so that any later change shows.

Every party gets the certificate and the exact document by email. Anyone holding the certificate's link can check it on a public page that says whether it is valid.

## What it is, and is not

This is a **simple electronic signature** of the kind the US ESIGN Act and UETA recognise: intent, consent, attribution and a kept record. It is not a qualified or advanced signature, and it checks no identity document and sends no code by text message.

## Where it is on

The Signatures tab appears where signing is enabled. A deployment missing its sealing key refuses a request with `signing_unconfigured`. The operator configures versioned Ed25519 keys as `SIGNING_KEY_V1` and later versions; these belong to the platform, never the agent or artifact. Public verification keys are at `/.well-known/superartifacts-signing.json`.

Start with [Collect signatures](https://pr-2197-stg.superartifacts.app/docs/signatures.md). See [REST operations](https://pr-2197-stg.superartifacts.app/docs/reference/api-endpoints.md) and [SDK methods](https://pr-2197-stg.superartifacts.app/docs/sdks.md).

## Request limits

A workspace may send 10 requests an hour to at most 50 new signer addresses a day. Each signer may request three codes an hour. Messages allow 500 characters. A completed request keeps its version pinned; withdrawing, declining or expiring releases it only when no other open or completed request holds it. Deleting an artifact with an open or completed request is refused with `artifact_signed`; deleting its pinned version is `version_signed`.

Next: [Secrets](https://pr-2197-stg.superartifacts.app/docs/concepts/secrets.md)
