GoRunner docs
Search or askSearch⌘K

Open a sign-in in this tab

Since v2026.10.8

POST/api/connections/oauth2/attempts/{attemptId}/go

For GoRunner’s own pages: opens a tab sign-in in the same tab when a popup is blocked.

Needs an API token with the Write permission for connections (connection:write).

Parameters

Path

attemptIdRequired · string

A sign-in started with mode: tab.

Not for API tokens

Only the person who started the sign-in can open it, once, in the browser that started it. From code, use Start a sign-in for a new connection with a returnUrl.

Responses

  • 200OK

    Where to send the tab. It also sets the cookie the return needs.

  • The token lacks the Write permission for connections.

  • The workspace’s account is suspended. Nothing starts until it is resumed.

  • Not a sign-in you started.

  • The sign-in was already opened or has ended, or isn’t a tab sign-in. Start it again.

  • The workspace’s account was deleted.

  • The sign-in couldn’t be opened.

  • This server can’t reach sign-ins now.

  • The account’s state couldn’t be read. Nothing started. Try again.

Any call can also answer: 401 UNAUTHORIZED · 401 TOKEN_ENDED · 403 TOKEN_SURFACE_OFF · 403 FEATURE_OFF · 403 EMBED_NOT_ALLOWED · 403 EMBED_NOT_AVAILABLE · 413 PAYLOAD_TOO_LARGE · 415 INVALID_CONTENT_TYPE · 429 RATE_LIMITED · 503 BUSY · 503 PAUSED · 503 SERVICE_UNAVAILABLE. See Errors.

Request

GORUNNER="https://api.gorunner.io"
GORUNNER_TOKEN="grt_…"  # needs Write for connections
ATTEMPT_ID="your-attempt-id"  # from the start

URL="$GORUNNER/api/connections/oauth2/attempts/"
URL="${URL}$ATTEMPT_ID/go"
curl -X POST "$URL" \
  -H "Authorization: Bearer $GORUNNER_TOKEN"

Response · 200 OK

json
{
  "data": {
    "redirectUrl": "https://accounts.google.com/o/oauth2/v2/auth?…"
  }
}
Every field

It takes no body.

Response · 200 OK

dataobject
redirectUrlURL