> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sharesame.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Reference for ShareSame's website generation API.

<Note>
  This reference is generated from the OpenAPI file in `api-reference/openapi.json`.
</Note>

## Base URL

Your team gets a base URL directly from ShareSame when API access is enabled. The examples in this docs site use:

<Card title="OpenAPI file" icon="code" href="https://github.com/rayxc-org/docs/blob/main/api-reference/openapi.json">
  View the exact schema used for this API reference
</Card>

## Authentication

All endpoints use Bearer authentication.

```json theme={null}
"security": [
  {
    "bearerAuth": []
  }
]
```

## Endpoints

* `POST /generate` starts a job
* `GET /job/{job_id}` polls that job
* `POST /job/{job_id}/deployed` reports the final public URL after you ship