Inbound API
Inbound API
Generate an API Key: in your workspace settings
Authenticate: requests using the API key in headers
Access your data: via standard REST endpoints
All API requests require an API key passed in the `X-API-Key` header:
```bash
curl -X GET "https://api.nixa.ca/v1/entities" \
-H "X-API-Key: your-api-key-here"
```
### Health & Docs
`GET /v1/health` - Check public API reachability
`GET /v1/openapi.json` - Fetch the OpenAPI contract
### Entities
`GET /v1/entities` - List all entities in your workspace
`GET /v1/entities/:id` - Get entity details and schema
### Records
`GET /v1/entities/:id/records` - List records with filtering & pagination
`GET /v1/entities/:id/records/:recordId` - Get a single record
`POST /v1/entities/:id/records` - Create a new record
`PATCH /v1/entities/:id/records/:recordId` - Update a record
`DELETE /v1/entities/:id/records/:recordId` - Delete a record
### Filtering & Pagination
```bash
GET /v1/entities/123/records?status=active
GET /v1/entities/123/records?limit=50&offset=100
GET /v1/entities/123/records?sort=createdAt&order=desc
```
### API Key Management
Create multiple API keys with descriptive names
Revoke keys instantly when compromised
Track last usage for each key
Keys are hashed - only shown once at creation
### Rate Limiting
Automatic rate limiting protects your workspace
Configurable limits per API key
Clear error messages when limits exceeded
### Audit Trail
All API access is logged
Track which key accessed what data
Monitor for unusual patterns
Custom Integrations — Connect proprietary systems to Nixa
Mobile Apps — Build custom mobile experiences
Reporting — Pull data into external BI tools
Automation — Script bulk operations
Sync Systems — Keep external databases in sync
IoT Devices — Send sensor data to Nixa
All responses follow a consistent JSON structure:
```json
{
"data": [...],
"meta": {
"total": 150,
"limit": 25,
"offset": 0
}
}
```
Errors return appropriate HTTP status codes with details:
```json
{
"error": {
"code": "unauthorized",
"message": "Invalid or expired API key",
"details": {},
"requestId": "..."
}
}
```



•
Initial release as installable marketplace app
•
API key management (create, revoke, track usage)
•
RESTful endpoints for entities and records
•
Filtering, pagination, and sorting
•
Rate limiting and audit logging
•
Comprehensive error handling
Install your first app in 30 seconds. No credit card required.