API Reference

Comprehensive documentation for interacting with the mnnn API.

Quick Start

To get started, create an API key from the Enterprise dashboard. Use this key with all requests.

Example Request

$ curl -X GET https://api.mnnn.com/v1/status \
  -H 'Authorization: Bearer YOUR_API_KEY'

Authentication

All requests must include an Authorization header with your API key.

Header Format

GET /v1/status HTTP/1.1
Authorization: Bearer YOUR_API_KEY

Replace YOUR_API_KEY with your actual access token.

Endpoints

GET /v1/status

Checks API health

Response Example

{ "status": "OK", "version": "1.2.4" }

POST /v1/deploy

Triggers deployment

Request Body

{
  "environment": "production",
  "projectId": "app-123",
  "region": "us-east-1"
}

Response Example

{ "deploymentId": "dpl-789" }

Rate Limiting

The API enforces rate limits to ensure fair usage. Free tier accounts get 1000 requests/month.

Headers

X-Rate-Limit-Limit

Maximum requests per minute

X-Rate-Limit-Remaining

Requests remaining this minute

Error Responses

All error responses include a JSON object with code and message fields.

Example Error

{
  "code": 401,
  "message": "Invalid API key"
}