API Error Codes

Below you can find the complete list of errors that are returned by the API together with the description, API code, and corresponding HTTP status of each error.

NameHTTP Status CodeHTTP StatusStream CodeDescription
Input Error400Bad Request4When wrong data/parameter is sent to the API
Duplicate Username Error400Bad Request6When a duplicate username is sent while enforce_unique_usernames is enabled
Message Too Long Error400Bad Request20Message is too long
Event Not Supported Error400Bad Request18Event is not supported
Channel Feature Not Supported Error400Bad Request19The feature is currently disabled on the dashboard (i.e. Reactions & Replies)
Multiple Nesting Level Error400Bad Request21Multiple Levels Reply is not supported - the API only supports 1 level deep reply threads
Custom Command Endpoint Call Error400Bad Request45Custom Command handler returned an error
Custom Command Endpoint Missing Error400Bad Request44App config does not have custom_action_handler_url
Authentication Error401Unauthorised5Unauthenticated, problem with authentication
Authentication Token Expired401Unauthorised40Unauthenticated, token expired
Authentication Token Before Issued At401Unauthorised42Unauthenticated, token date incorrect
Authentication Token Not Valid Yet401Unauthorised41Unauthenticated, token not valid yet
Authentication Token Signature Invalid401Unauthorised43Unauthenticated, token signature invalid
Access Key Error401Unauthorised2Access Key invalid
Not Allowed Error403Forbidden17Unauthorised / forbidden to make request
App Suspended Error403Forbidden99App suspended
Cooldown Error403Forbidden60User tried to post a message during the cooldown period
Does Not Exist Error404Not Found16Resource not found
Request Timeout Error408Request Timeout23Request timed out
Payload Too Big Error413Request Entity Too Large22Payload too big
Rate Limit Error429Too Many Requests9Too many requests in a certain time frame
Maximum Header Size Exceeded Error431Request Header Fields Too Large24Request headers are too large
Internal System Error500Internal Server Error-1Triggered when something goes wrong in our system
No Access to Channels403Unauthorised70No access to requested channels
Message Moderation Failed400Bad Request73Message did not pass moderation
© Getstream.io, Inc. All Rights Reserved.