Skip to content

Ask the regfish assistant

GET /help/search

Operation ID: SearchHelp

Put a question to Flossi, the regfish assistant, and get back the answer it would give in the dashboard chat. Same assistant, same knowledge base (help center articles, curated procedures, the service FAQ derived from the console itself, the legal pages and the developer documentation), same access to the account behind the API key.

Ask it before describing a click path: the assistant knows the exact menu names, and those are what invented instructions get wrong. It also answers questions no article covers, because they are about this account: when a domain expires, which domains have no DNSSEC, whether anything is unpaid.

Account data follows the key’s own permissions. A key with domain:read gets domain answers; billing answers need billing:read, certificate answers need tls:read. Without the right the assistant leaves that part out rather than refusing the whole question.

The answer is Markdown and may link places in the dashboard as relative paths (/my/…). Resolve them against dashboard_url from the response.

One question at a time: the assistant runs on a single local GPU. A busy assistant answers 503, and so does one that cannot be reached. Rate limit: 10 questions per minute and API key, 20 per 10 minutes and account.

NameTypeRequiredDescription
qstringyesThe question, in the customer’s own words. There is no conversation state: each call stands alone, so a follow-up has to carry its own context (“when does example.de expire?”, not “and when does it?”).
localestringnoAnswer language and the regfish world the assistant links to. Omitted, it answers in the language of the question and links to regfish.com.
StatusTypeDescription
200helpSearchResponseThe assistant’s answer
400ErrorMissing or invalid query
401ErrorUnauthorized
403ErrorAssistant not available for this credential or account
429ErrorToo many questions
500ErrorUnexpected error
503ErrorAssistant busy or unreachable, retrying later is worth it
FieldTypeRequiredDescription
successbooleanyesSuccess indicator
codeintegernoResponse/Error Code
responsehelpSearchResponseno-
Terminal window
curl -X GET "https://api.regfish.com/help/search" \
-H "x-api-key: $REGFISH_API_KEY"

Fill in values - the call below updates as you type. Nothing is sent: the API does not currently allow browser requests from this domain (CORS). The API key is not stored.