Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.nometria.com/llms.txt

Use this file to discover all available pages before exploring further.

The Nometria API lets you trigger deployments, check migration status, and manage your projects programmatically. Use it to integrate Nometria into your CI/CD pipeline or build internal tooling.

​
Base URL

https://api.nometria.com/v1

​
Authentication

All API requests require an API key passed in the Authorization header: 
Authorization: Bearer <your-api-key>
Get your API key: Dashboard → Settings → API Keys → New Key. API keys are scoped to your account and have access to all your projects. Treat them like passwords — never commit them to source code.
If an API key is compromised, revoke it immediately from Dashboard → Settings → API Keys.

​
Request format

All request bodies must be JSON with Content-Type: application/json. 
curl -X POST https://api.nometria.com/v1/deployments \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{"project_id": "proj_abc123"}'

​
Response format

All responses are JSON. Successful responses return a data object. Errors return an error object: 
// Success
{
  "data": {
    "id": "dep_xyz789",
    "status": "queued",
    "project_id": "proj_abc123"
  }
}

// Error
{
  "error": {
    "code": "not_found",
    "message": "Project proj_abc123 not found."
  }
}

​
HTTP status codes

CodeMeaning
200Success
201Created
400Bad request — check your request body
401Unauthorized — invalid or missing API key
403Forbidden — API key doesn’t have access to this resource
404Not found
429Rate limited — back off and retry
500Server error — contact support

​
Rate limits

TierRequests per minute
Free30
Pro120
Team600
Rate limit headers are included in every response: 
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 115
X-RateLimit-Reset: 1705000800

​
Pagination

List endpoints return paginated results using cursor-based pagination: 
{
  "data": [...],
  "pagination": {
    "has_more": true,
    "next_cursor": "cur_abc123"
  }
}
Pass cursor=cur_abc123 as a query parameter to get the next page.

​
SDKs

The Nometria API is a REST API — use it with any HTTP client. Node.js example: 
const response = await fetch('https://api.nometria.com/v1/projects', {
  headers: {
    'Authorization': `Bearer ${process.env.Nometria_API_KEY}`,
    'Content-Type': 'application/json'
  }
});
const { data } = await response.json();
Python example: 
import urllib.request
import json
import os

req = urllib.request.Request(
    'https://api.nometria.com/v1/projects',
    headers={
        'Authorization': f"Bearer {os.environ['Nometria_API_KEY']}",
        'Content-Type': 'application/json'
    }
)
with urllib.request.urlopen(req) as res:
    data = json.loads(res.read())

​
API endpoints

Migrations

Create, list, and check the status of migrations

Deployments

Trigger, list, and rollback deployments