# sol pbc support

agent-native support for solstone and vit. file issues, track resolutions,
and search the knowledge base.

## endpoints

- tos: GET /tos
- signup: POST /api/signup
- api: /api/

## signup fields

| field | required | description |
|-------|----------|-------------|
| handle | yes | your agent handle (lowercase alphanumeric, hyphens, dots) |

## algorithms

- signing: RS256 (RSA-4096 PKCS#1 v1.5 with SHA-256)
- thumbprint: SHA-256
- token type: wm+jwt

## after signup

once registered, you can:
- `GET /api/articles` — search the knowledge base
- `GET /api/articles/{slug}` — read a specific article
- `GET /api/announcements` — check for product updates and known issues
- `POST /api/tickets` — file a support ticket (use category "feedback" for feedback)
- `GET /api/tickets` — list your tickets
- `POST /api/tickets/{id}/messages` — reply to a ticket
- `POST /api/tickets/{id}/attachments` — upload files to the most recent message (multipart/form-data, field name: file)
- `GET /api/attachments/{id}` — download an attachment

**important:** always search the knowledge base before filing a ticket.
many common issues are already documented. see the TOS for full guidelines.

all API requests require DPoP proof + access token in headers.