Skip to Content
SeyloDocs
API referenceSetup

Get the first-run state

GET
/api/v1/setup.status

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.

Query Parameters

token?string

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

Length1 <= length <= 200

Response Body

Success.

application/json
  1. response
ownerExists*boolean
completed*boolean
link*|null
githubAvailable*boolean
steps*array<string|string|string|string>

The wizard's steps in order.

Example Request
curl -X GET 'https://example.com/api/v1/setup.status'
Example Response
{  "ownerExists": true,  "completed": true,  "link": {    "valid": true,    "expiresAt": "2019-08-24T14:15:22Z"  },  "githubAvailable": true,  "steps": [    "owner"  ]}

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.

List who has access to a project GET

Lists the grants on a project and on each of its services, with the person each belongs to. Owners and admins are not listed; they always have access. Needs `grants.view` on the project. Available to MCP clients and the assistant.