Sites (beta)
Beta: multi-page websites on styrar.site, how they differ from bio, and how API permissions work.
Beta. Sites (including first-party theme packages) is in beta. Public URLs, package ids, and API shapes may change before general availability.
Sites is Styrar’s multi-page website builder. Published sites live on styrar.site (for example your-slug.styrar.site). That is separate from bio pages on styrar.page / styrar.bio, which stay single-page link-in-bio.
Use Sites when you need several pages, site navigation, heroes, footers, section layouts, and theme packages. Use bio when you want a classic link-in-bio page.
Plan requirement: Calling the Sites API with an API key requires a Team or Agency plan. See pricing.
What you can build
- Multi-page sites with a draft → publish workflow
- Structural starters (
blank,portfolio,booking,store) or a first-party theme package look - Theme tokens (colors, fonts, buttons) and optional sample layouts from theme packages
- Workspace theme presets (saved looks, not full packages)
Dashboard editors live under Sites. Integrators use the Sites API.
Permissions (API keys and OAuth)
To read or change Sites through the API, your key or token needs:
| Capability | What it allows on Sites |
|---|---|
links:read | List sites, templates, theme packages, drafts |
links:write | Create sites, edit drafts, install packages, publish |
analytics:read | Sites analytics |
Those capability names also cover short links and bio. That is a shared permission group for web presence in the workspace, not a claim that a Site is a short link. When you create an API key, enable the Links scopes (or grant them at OAuth consent) if your integration needs Sites.
Base URL for all REST calls: https://api.styrar.com/v1
Create a site
Pass companyId for a company workspace. Omit it for a personal site (your account username becomes the public Sites slug).
Choose a templateId:
- Starter:
blank,portfolio,booking,store - Theme package (beta):
styrar.studio,styrar.midnight,styrar.soft,styrar.contrast
Authorization: Bearer sty_live_your_api_key
Content-Type: application/json
{
"companyId": "clxyz_company",
"title": "Studio site",
"templateId": "styrar.studio"
}Full route table, install modes, and publish: Sites API. Theme package structure and CSS variables: Theme packages.
Related
- Theme packages - how packages are structured and styled
- Sites API - methods, paths, and scopes
- Authentication - API keys, OAuth, and capabilities
- Introduction - base URL, errors, and pagination