Skip to Content
SeyloDocs
API referenceCloudflare tunnels

Get a service's Cloudflare tunnel

GET
/api/v1/tunnels.get

Returns the Cloudflare tunnel of a service: on or off, quick or token mode, its public URL and state.

Needs tunnels.view on the service (a grant on its project covers it). Available to MCP clients and the assistant.

Authorization

cookieseylo_session<token>

Query Parameters

serviceId*string

Panel-issued id.

Match^[a-z0-9]{16}$

Response Body

Success.

application/json
  1. response
serviceId*string

Panel-issued id.

Match^[a-z0-9]{16}$
enabled*boolean
mode*string|string
state*string|string|string|string
targetPort*integer

Port the container listens on.

Range1 <= value <= 65535
url*string|null
hostname*|null
tokenSource*string|string|string
expiresAt*|null
error*string|null
Example Request
curl -X GET 'https://example.com/api/v1/tunnels.get?serviceId=string'
Example Response
{  "serviceId": "string",  "enabled": true,  "mode": "quick",  "state": "off",  "targetPort": 1,  "url": "string",  "hostname": "string",  "tokenSource": "service",  "expiresAt": "2019-08-24T14:15:22Z",  "error": "string"}

Start a CLI sign-in POST

Starts a browser-approved sign-in for the laptop CLI. Show userCode, open verificationUrl, then call cliLogin.poll with deviceCode every intervalSeconds until it is no longer pending. Needs no sign-in. Not available to MCP clients or the assistant.

Get Cloudflare tunnel settings GET

Says whether a global Cloudflare tunnel token is set (services in token mode without their own token use it). The token itself is never returned. Needs `settings.view`, which owners and admins hold. Not available to MCP clients or the assistant.