# Shiny Go Clean auth.md

This document describes agent access and registration for Shiny Go Clean's public web resources and Lead Intake API.

## Agent audience

This service supports agents acting on behalf of prospective or existing Shiny Go Clean customers in Madison, Wisconsin and nearby Dane County communities.

Agents may read public website content and discovery documents. An agent may submit a cleaning quote request or contact message only when the customer has explicitly asked Shiny Go Clean to contact them.

## Registration and provisioning

Agent registration is not required or available. Shiny Go Clean does not currently provide an agent account registration endpoint, provisioning endpoint, client registration endpoint, or `/agent/auth` endpoint.

Do not probe or send POST requests to unadvertised registration paths.

## Supported access method

### Anonymous HTTPS

- Registration required: no
- Authentication credentials required: no
- Bearer tokens accepted: no
- API keys accepted: no
- OAuth access tokens accepted: no

Anonymous agents may access:

- `GET https://www.shinygoclean.com/.well-known/api-catalog`
- `GET https://www.shinygoclean.com/openapi.json`
- `GET https://www.shinygoclean.com/api-docs`
- `GET https://www.shinygoclean.com/llms.txt`
- `POST https://www.shinygoclean.com/api/v1/leads`

## Credential use

No credential should be sent. Do not attach an `Authorization` header, bearer token, API key, identity assertion, or customer password to public Shiny Go Clean endpoints.

The Lead Intake API uses customer-provided contact details and explicit communications consent, not an agent credential. Do not submit test, unsolicited, duplicate, or fabricated leads. Do not submit a lead without the customer's authorization.

## OAuth metadata

The current public Lead Intake API is not an OAuth protected resource. Shiny Go Clean therefore does not advertise OAuth Protected Resource Metadata or Authorization Server metadata. This is intentional and avoids directing agents to a nonexistent authorization service.

## Service documentation

- API catalog: https://www.shinygoclean.com/.well-known/api-catalog
- OpenAPI description: https://www.shinygoclean.com/openapi.json
- Developer portal: https://www.shinygoclean.com/developers
- Human API documentation: https://www.shinygoclean.com/api-docs
- Terms: https://www.shinygoclean.com/terms
- Privacy: https://www.shinygoclean.com/privacy