> Agent-readable docs index: /llms.txt. Download /docs.zip to grep all markdown files locally.

---
title: "Register deployment"
description: "Registers a project via GitHub Actions OIDC. JWT is verified against GitHub JWKS; owner/repo are derived from the token claims. Called automatically by the Holocron Vite plugin at build time."
api: "POST /api/v0/register-deployment"
gridGap: 30
---

<Aside full>

<RequestExample>

```bash lines=false
curl -X POST "https://api.example.com/api/v0/register-deployment" \
  -H "Content-Type: application/json" \
  -d '{}'
```

</RequestExample>

</Aside>

<OpenAPIEndpoint {...{"method":"post","path":"/api/v0/register-deployment","summary":"Register deployment","description":"Registers a project via GitHub Actions OIDC. JWT is verified against GitHub JWKS; owner/repo are derived from the token claims. Called automatically by the Holocron Vite plugin at build time.","parameters":[],"requestBody":{"required":true,"contentType":"application/json","schema":{"type":"object","properties":{}}},"responses":[{"status":"200","description":"","schema":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean"},"projectId":{"type":"string"},"branch":{"type":"string","description":"Derived branch name from the OIDC JWT (head_ref for PRs, ref for pushes)."},"preview":{"type":"boolean","description":"True when the OIDC token comes from a pull_request event."}}}},{"status":"401","description":"","schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}},{"status":"default","description":""}],"security":[],"servers":[]}} />

---

*Powered by [holocron.so](https://holocron.so)*