Skip to main content

API Reference

The Cocobase REST API allows you to interact with your database using standard HTTP requests.

Base URL

Authentication

All API requests require authentication using your API key in the Authorization header:

Request Format

  • All request bodies should be JSON
  • Set Content-Type: application/json header

Response Format

All responses are JSON with the following structure: Success Response:
Error Response:

HTTP Status Codes

Rate Limits

  • Standard: 100 requests per minute
  • Pro: 1000 requests per minute
  • Enterprise: Custom limits
Rate limit headers are included in responses:

Pagination

List endpoints support pagination with these parameters:

Quick Examples

Create a Document

List Documents

Get a Document


API Sections

Collections API

CRUD operations for documents

Auth API

User authentication endpoints

Storage API

File upload and download

Realtime API

Real-time subscriptions