Errors & SDKs

Error Response Format

Error response


{
  "error": {
    "type": "validation_error",
    "message": "Invalid request parameters",
    "details": [
      {
        "field": "title",
        "issue": "Title is required"
      }
    ],
    "request_id": "req_abc123"
  }
}

HTTP Status Codes

Code	Meaning	Description
200	OK	Successful request
201	Created	Resource created successfully
400	Bad Request	Invalid request parameters
401	Unauthorized	Missing or invalid API key
403	Forbidden	Insufficient permissions
404	Not Found	Resource does not exist
429	Too Many Requests	Rate limit exceeded
500	Internal Server Error	Contact support

Error Types

authentication_error
validation_error
permission_error
rate_limit_error
not_found_error
server_error

SDKs

Python

Install (pip)


pip install rosetta-client

List documents


from rosetta import RosettaClient
 
client = RosettaClient(api_key="YOUR_API_KEY")
documents = client.documents.list(limit=10)

JavaScript / TypeScript

Install (npm)


npm install @rosetta/client

List documents


import { RosettaClient } from "@rosetta/client";
 
const client = new RosettaClient({ apiKey: "YOUR_API_KEY" });
const documents = await client.documents.list({ limit: 10 });