Databases

Open a read-only database console (dashboard session only; databases:reveal). Reopening from the same sign-in returns the open session

post/databases/{databaseId}/console

Request

  • Base URL: https://hostingsurge.com/api/v1
  • URL: https://hostingsurge.com/api/v1/databases/{databaseId}/console
  • Auth: one of:
    • HTTP bearer
    • API key in cookie __Host-hs_session

Path parameters

databaseIdstring uuid required

Response

Console session (status starting until it has connected)

idstring uuid required
databaseIdstring uuid required
engine'postgresql' | 'mysql' | 'mariadb' | 'redis' | 'mongodb' required
status'starting' | 'ready' | 'closed' | 'expired' | 'failed' required

starting: the console is connecting (the team's database tools may be starting, about a minute the first time); ready: statements run; closed/expired/failed: ended, open a new session

mode'read' | 'write' required

read (default): the database refuses changes; write: statements may change data (needs databases:write)

canWriteboolean required

the caller may switch this session to write mode

preparingboolean required

the team's database tools are starting; the console connects on its own once they run

serverVersionstring nullable required
errorstring nullable required
endReason'closed' | 'idle' | 'lifetime' | 'worker_lost' | 'failed' | 'replaced' | 'unavailable' | 'null' nullable required
statementsinteger required

statements run in this session

idleTimeoutSecondsinteger required

the session ends after this long without a statement

statementTimeoutSecondsinteger required
maxRowsinteger required

rows returned per result at most

createdAtstring required

ISO-8601 timestamp

lastActivityAtstring required

ISO-8601 timestamp

expiresAtstring required

the session ends at this time at the latest

endedAtstring nullable required

ISO-8601 timestamp

Changes

No recorded changes to this operation across all 1 revision of this API.