Skip to Content
SeyloDocs
API referenceSetup

Start creating the owner with GitHub

POST
/api/v1/setup.githubStart

Checks the setup token and starts the GitHub device flow (like gh auth login). Show userCode, open verificationUri, then call setup.githubPoll every intervalSeconds.

Needs no sign-in. Not available to MCP clients or the assistant.

Request Body

application/json
  1. body
token*string

The t= value of the installer's setup link.

Length1 <= length <= 200
repoAccess*boolean

Also ask for the repo scope so this GitHub login can clone private repos. Off by default: a GitHub App gives narrower access.

Defaultfalse

Response Body

Success.

application/json
  1. response
ticket*string
userCode*string
verificationUri*string
expiresAt*string
Formatdate-time
intervalSeconds*integer
Range1 <= value
Example Request
curl -X POST 'https://example.com/api/v1/setup.githubStart' \  -H 'Content-Type: application/json' \  -d '{  "token": "string",  "repoAccess": false}'
Example Response
{  "ticket": "string",  "userCode": "string",  "verificationUri": "string",  "expiresAt": "2019-08-24T14:15:22Z",  "intervalSeconds": 1}

Check the GitHub owner sign-up POST

Polls the device flow. With status done it uses up the setup token, creates the owner from the GitHub account (primary verified email) and signs them in. Needs no sign-in. Not available to MCP clients or the assistant.

Get the first-run state GET

Tells the web app whether to show setup or sign-in: whether an owner exists, whether setup is finished, and, when a setup token is given, whether that token is still usable. Needs no sign-in. Not available to MCP clients or the assistant.