Crow NestDocs

Reference

Error codes

Errors from the browser library are thrown as an Error with a code. The API and server code calls answer with JSON in the same shape:

json
{ "error": { "code": "forbidden", "message": "Only the app's owner can change this." } }

The message is written to be shown to a person as it is.

Data, files and APIs

CodeMeaningWhat to do
sign_in_requiredA signed-out visitor tried something that needs sign-inThe library sends them to sign in automatically
forbiddenThe rules don't allow this person to do thisCheck read and write in crow.json
not_foundNo such document, file or appCheck the ID
bad_requestThe request doesn't match what's expected, such as a field typeFix the input; the message says what's wrong
too_largeA document, file, body or query result is over its limitSee Limits
limit_reachedA quota is used up: data size, daily writes, tasksWait for the next day, or delete data
rate_limitedToo many calls in a short timeSlow down and retry
conflictA unique value is already takenAsk for a different value, like another slot
edit_closedThe editFor window for a visitor's entry has passedThe entry can't be changed any more
payment_requiredPaid usage has grown with no card for 14 daysThe owner adds a card in Settings

AI

CodeMeaning
ai_not_enabledThe app's crow.json has no ai section
ai_no_keyNo AI key is set up for this app
ai_key_needs_ackThe owner hasn't accepted the warning for using their own key on a shared app

Publishing and billing

CodeMeaning
visibility_requiredA new app needs a visibility; ask the person
card_requiredThis account has no card on file yet (new accounts add one at sign-up); the message links to Settings
owner_onlyOnly the organization's owner can do this, such as change billing
functions_unavailableServer code can't be published right now

Server code

StatusCodeMeaning
503function_over_limitThe request ran past its CPU or outside-request limit
503function_errorThe code failed to answer
403blocked_addressfetch() to a Crow Nest address, an IP address or an internal name

App status

StatusMeaning
403The viewer can't open this app; the page offers Request access
423The organization paused this app
451Crow Nest suspended this app (see Security and trust)

Still stuck?

Email support@crow-nest.com with the error code, the app's address and what you were doing. If Crow Nest itself failed (an internal error), the answer and the dashboard show a reference; include it and we can find the exact error.