Skip to Content
SeyloDocs
API referenceSetup

Check the GitHub owner sign-up

POST
/api/v1/setup.githubPoll

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.

Request Body

application/json
  1. body
token*string

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

Length1 <= length <= 200
ticket*string
Length1 <= length <= 200

Response Body

Success.

application/json
  1. response
status*string|string|string|string|string
intervalSeconds*integer
Range1 <= value
viewer?
Example Request
curl -X POST 'https://example.com/api/v1/setup.githubPoll' \  -H 'Content-Type: application/json' \  -d '{  "token": "string",  "ticket": "string"}'
Example Response
{  "status": "pending",  "intervalSeconds": 1,  "viewer": {    "id": "string",    "email": "[email protected]",    "name": "string",    "role": "owner"  }}

Finish first-run setup POST

Marks the setup wizard as done, so the web app stops offering it. Steps left out can be done later in settings. Needs `setup.finish`, which owners and admins hold. Not available to MCP clients or the assistant.

Start creating the owner with GitHub POST

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.