# Hexel Studio Docs

> Guides, concepts and API reference for building with Hexel Studio.

## Get started

- [Introduction](https://hexelstudio.com/docs/get-started/introduction.md): What this site is, how a page is built, and where each piece lives.
- [Quickstart](https://hexelstudio.com/docs/get-started/quickstart.md): Run the site locally, add a page, and find it in navigation and search.

## Authoring

- [Pages](https://hexelstudio.com/docs/authoring/pages.md): Files and URLs, frontmatter, links, images and headings.
- [Navigation](https://hexelstudio.com/docs/authoring/navigation.md): Tabs, groups and page order, all set in docs.config.ts.
- [Components](https://hexelstudio.com/docs/authoring/components.md): Callouts, cards, steps, tabs, accordions and more, with the source for each.
- [Code blocks](https://hexelstudio.com/docs/authoring/code-blocks.md): Highlighting, titles, highlighted lines, language tabs and diagrams.
- [API fields](https://hexelstudio.com/docs/authoring/api-fields.md): Document parameters, responses and nested objects.

## Reference

- [Theming](https://hexelstudio.com/docs/reference/theming.md): Where the Hexel Studio look comes from, and how to change it.
- [Search and AI](https://hexelstudio.com/docs/reference/search-and-ai.md): The search dialog, Markdown copies of every page, and llms.txt.
- [API reference](https://hexelstudio.com/docs/reference/api-reference.md): Generate endpoint pages straight from OpenAPI specs, from a URL, this repo or another checkout.
- [Deployment](https://hexelstudio.com/docs/reference/deployment.md): Build the site, run it in a container, and serve it at hexelstudio.com/docs.

## API reference

- [Overview](https://hexelstudio.com/docs/api/introduction.md): Base URL, authentication and the APIs in this reference.
- [Errors](https://hexelstudio.com/docs/api/errors.md): Status codes and the error body each API returns.
- [Overview](https://hexelstudio.com/docs/api/compute/access.md): Compute API endpoints for Access.
- [List access clients](https://hexelstudio.com/docs/api/compute/access/list-access-clients.md): GET /compute/v1/access/clients
- [Create access client](https://hexelstudio.com/docs/api/compute/access/create-access-client.md): POST /compute/v1/access/clients
- [Revoke access client](https://hexelstudio.com/docs/api/compute/access/revoke-access-client.md): DELETE /compute/v1/access/clients/{client_id}
- [Overview](https://hexelstudio.com/docs/api/compute/agents.md): Compute API endpoints for Agents.
- [Deploy an agent from the registry](https://hexelstudio.com/docs/api/compute/agents/deploy.md): POST /compute/v1/agents/{agent_id}/deploy — Creates a new deployment from a registered agent. Returns a deployment_id to use for all subsequent operations.
- [Overview](https://hexelstudio.com/docs/api/compute/deployments.md): Compute API endpoints for Deployments.
- [List all deployments](https://hexelstudio.com/docs/api/compute/deployments/list.md): GET /compute/v1/deployments
- [Get deployment by ID](https://hexelstudio.com/docs/api/compute/deployments/get.md): GET /compute/v1/deployments/{deployment_id}
- [Delete a deployment](https://hexelstudio.com/docs/api/compute/deployments/delete.md): DELETE /compute/v1/deployments/{deployment_id}
- [Redeploy (stop + start)](https://hexelstudio.com/docs/api/compute/deployments/redeploy.md): POST /compute/v1/deployments/{deployment_id}/redeploy
- [Stop a deployment](https://hexelstudio.com/docs/api/compute/deployments/stop.md): POST /compute/v1/deployments/{deployment_id}/stop
- [Overview](https://hexelstudio.com/docs/api/compute/skills.md): Compute API endpoints for Skills.
- [Create a new skill](https://hexelstudio.com/docs/api/compute/skills/create.md): POST /compute/v1/skills — Registers a new skill definition with content hashing
- [List all skills](https://hexelstudio.com/docs/api/compute/skills/list.md): GET /compute/v1/skills — Returns all registered skill definitions
- [Get skill by name](https://hexelstudio.com/docs/api/compute/skills/get.md): GET /compute/v1/skills/{name} — Returns a single skill definition by name
- [Update a skill](https://hexelstudio.com/docs/api/compute/skills/update.md): PUT /compute/v1/skills/{name} — Updates an existing skill definition and recomputes content hash
- [Delete a skill](https://hexelstudio.com/docs/api/compute/skills/delete.md): DELETE /compute/v1/skills/{name} — Removes a skill definition by name
- [Overview](https://hexelstudio.com/docs/api/compute/usage.md): Compute API endpoints for Usage.
- [List VM usage records](https://hexelstudio.com/docs/api/compute/usage/list.md): GET /compute/v1/usage — Returns VM usage records for the caller's org, optionally filtered by date range and tier
- [Get usage summary for current billing period](https://hexelstudio.com/docs/api/compute/usage/summary.md): GET /compute/v1/usage/summary — Returns aggregated VM-seconds consumed by tier for the current calendar month
- [Overview](https://hexelstudio.com/docs/api/compute/vms.md): Compute API endpoints for VMs.
- [List Agent VMs](https://hexelstudio.com/docs/api/compute/vms/list.md): GET /compute/v1/vms — Returns VMs scoped to the caller's org
- [Get Agent VM by ID](https://hexelstudio.com/docs/api/compute/vms/get.md): GET /compute/v1/vms/{id}
- [Delete Agent VM](https://hexelstudio.com/docs/api/compute/vms/delete.md): DELETE /compute/v1/vms/{id}
- [Allocate a new Agent VM](https://hexelstudio.com/docs/api/compute/vms/allocate.md): POST /compute/v1/vms/allocate — Allocates a VM from the pool or creates a new one for the requesting org
- [Get Agent VM endpoint](https://hexelstudio.com/docs/api/compute/vms/endpoint.md): GET /compute/v1/vms/{id}/endpoint
- [Execute code in VM](https://hexelstudio.com/docs/api/compute/vms/execute.md): POST /compute/v1/vms/{id}/execute — Runs code or shell commands in an allocated sandbox VM
- [Forward request to VM](https://hexelstudio.com/docs/api/compute/vms/forward-request-to-vm-get.md): GET /compute/v1/vms/{id}/r/{path} — Forwards any request to the runtime inside the VM. Token is injected automatically.
- [Forward request to VM](https://hexelstudio.com/docs/api/compute/vms/forward-request-to-vm-post.md): POST /compute/v1/vms/{id}/r/{path} — Forwards any request to the runtime inside the VM. Token is injected automatically.
- [Forward request to VM](https://hexelstudio.com/docs/api/compute/vms/forward-request-to-vm-delete.md): DELETE /compute/v1/vms/{id}/r/{path} — Forwards any request to the runtime inside the VM. Token is injected automatically.
- [Release Agent VM](https://hexelstudio.com/docs/api/compute/vms/release.md): POST /compute/v1/vms/{id}/release
- [Renew Agent VM TTL](https://hexelstudio.com/docs/api/compute/vms/renew.md): POST /compute/v1/vms/{id}/renew
- [Overview](https://hexelstudio.com/docs/api/registry/agents.md): Agent Registry API endpoints for Agents.
- [Create agent](https://hexelstudio.com/docs/api/registry/agents/create.md): POST /registry/v1/agents — Register a new agent in the catalog
- [List agents](https://hexelstudio.com/docs/api/registry/agents/list.md): GET /registry/v1/agents — List agents with optional filters
- [Get agent](https://hexelstudio.com/docs/api/registry/agents/get.md): GET /registry/v1/agents/{id} — Get agent by ID
- [Update agent](https://hexelstudio.com/docs/api/registry/agents/update.md): PUT /registry/v1/agents/{id} — Update agent fields
- [Delete agent](https://hexelstudio.com/docs/api/registry/agents/delete.md): DELETE /registry/v1/agents/{id} — Delete agent by ID
- [Search agents by capabilities](https://hexelstudio.com/docs/api/registry/agents/search.md): GET /registry/v1/agents/search — Find agents matching given capabilities
- [Get agent public key](https://hexelstudio.com/docs/api/registry/agents/public-key.md): GET /registry/v1/agents/{id}/public-key — Returns the Ed25519 public key for A2A signature verification
- [Overview](https://hexelstudio.com/docs/api/registry/tools.md): Agent Registry API endpoints for Tools.
- [Create tool](https://hexelstudio.com/docs/api/registry/tools/create.md): POST /registry/v1/tools — Register a new tool in the catalog
- [List tools](https://hexelstudio.com/docs/api/registry/tools/list.md): GET /registry/v1/tools — List all tools with optional category filter
- [Get tool](https://hexelstudio.com/docs/api/registry/tools/get.md): GET /registry/v1/tools/{id} — Get tool by ID

## OpenAPI specs

- [Compute API](https://hexelstudio.com/docs/openapi/compute.json)
- [Agent Registry API](https://hexelstudio.com/docs/openapi/registry.json)

Full text of every page: https://hexelstudio.com/docs/llms-full.txt