API Reference

The Embedd.to API is a RESTful JSON API.

Base URL

https://api.embedd.to/v1

Authentication

Embedd.to uses two authentication methods:

Endpoint Category	Auth Method	Header
Organizations, members, invitations	Supabase JWT	Authorization: Bearer <jwt>
All other endpoints	API key	Authorization: Bearer sk_...

See Authentication for details.

Environment Scoping

API key requests are scoped to an environment via the X-Environment-Id header:

X-Environment-Id: env_abc123

If omitted, requests default to the prod environment.

Pagination

List endpoints support cursor-based pagination:

Parameter	Type	Default	Description
limit	integer	20	Items per page (1-100)
cursor	string	null	Cursor from previous response

Responses include a pagination object:

{
  "data": [...],
  "pagination": {
    "limit": 20,
    "has_more": true,
    "next_cursor": "eyJpZCI6ICIxMjMifQ=="
  }
}

Error Format

All errors follow a consistent format:

{
  "error": {
    "code": "resource_not_found",
    "message": "Connection 'conn_123' not found",
    "resolution": "Verify the connection ID and ensure it belongs to your organization",
    "docs_url": "https://embedd.to/errors/resource_not_found",
    "request_id": "req_abc123"
  }
}

See Errors for the full error code reference.

Endpoints

Resource	Description
Auth	Passwordless authentication (OTP, verify, refresh)
Organizations	Organization management, members, invitations
API Keys	API key creation, listing, revocation
Environments	Manage isolated environments
Connections	Database connection management
Embedding Providers	Embedding API credentials and model catalog
Vector Tables	Vector table CRUD, backfill, and schema
Query	Semantic search
Sync	Sync status and control
Tasks	Background task monitoring