Skip to main content

Error Response Format

All errors return a JSON object with an error field:

HTTP Status Codes

Common Errors

Missing API Key

Solution: Include your API key in the x-api-key header:

Invalid API Key

Solution: Check that your API key is correct and hasn’t been deleted.

No Active Subscription

Solution: Subscribe at roselabs.ai.

Agent Not Found

Solution: Verify the agent ID is correct. Agents may be deleted after completion.

Missing Goal

Solution: Include the goal field in your request body when creating an agent.

Invalid Model

Solution: Use a valid model: rose-1-lite or rose-1-ultra.

Rate Limit Exceeded

Solution: Implement exponential backoff and retry logic.

Error Handling Best Practices

Retry with Exponential Backoff

Handle Specific Error Types

Getting Help

If you encounter persistent errors:
  1. Check the status page for outages
  2. Review your API key in Settings
  3. Contact support at support@roselabs.ai