API Response Status Codes

Success Responses

200 OK

• Description: Request successful, data returned as expected

• When returned: Successful GET, POST, PUT, or DELETE operations

• Action: Process the returned data normally

Client Error Responses (4xx)

400 Bad Request

• Description: Invalid request format or parameters

• When returned: Missing required fields, malformed JSON, invalid data types, or parameter validation failures

• Action: Review request payload and ensure all required fields are present and properly formatted

401 Unauthorized

• Description: Authentication required or failed

• When returned: Missing authentication token, expired token, or invalid credentials

• Action: Authenticate or refresh your access token

403 Forbidden

• Description: Authenticated but lacks permission

• When returned: User attempting to access resources or perform actions outside their permission scope

• Action: Check user role and permissions for the requested resource

404 Not Found

• Description: Requested resource doesn't exist

• When returned: Invalid dataset ID, model ID, or endpoint URL

• Action: Verify the resource identifier and endpoint path

405 Method Not Allowed

• Description: HTTP method not supported for this endpoint

• When returned: Using GET on POST-only endpoints, or vice versa

• Action: Check API documentation for correct HTTP method

409 Conflict

• Description: Request conflicts with current resource state

• When returned: Attempting to create duplicate resources, concurrent modification conflicts

• Action: Check for existing resources or retry with updated data

413 Request Entity Too Large

• Description: Request payload exceeds size limits

• When returned: Dataset uploads or API requests exceeding size thresholds

• Action: Reduce payload size or upgrade Graphite Note licence

429 API Rate Limit Exceeded

• Description: Too many requests in given time period

• When returned: Exceeding rate limits defined in your subscription plan

• Action: Implement request throttling, check rate limit headers, wait before retrying

Custom Business Logic Errors (44x)

441 Subscription Plan Limit

• Description: Action exceeds subscription plan limits

• When returned: Attempting operations beyond plan quotas (datasets, models, API calls)

• Action: Upgrade subscription plan or remove unused resources

442 Email Already Exists

• Description: Email address already registered

• When returned: User registration or email update with existing email

• Action: Use different email or attempt login/password recovery

443 Free Trial Finished

• Description: Free trial period has ended

• When returned: Attempting paid features after trial expiration

• Action: Subscribe to a paid plan to continue access

445 Model Creation Limit

• Description: Maximum model creation limit reached

• When returned: Creating models beyond plan allowance

• Action: Delete unused models or upgrade subscription plan

Server Error Responses (5xx)

500 Internal Server Error

• Description: Unexpected server error occurred

• When returned: Server-side exceptions, database failures, or unhandled errors

• Action: Retry request, contact support if persists with request details

501 Not Implemented

• Description: Functionality not yet implemented

• When returned: Accessing beta or upcoming features not available in current version

• Action: Check API versioning or feature availability documentation