REST API v1.0

API Reference

Integrate Nobalmako into your own tools and CI/CD pipelines with our secure, developer-friendly REST API.

Authentication

All API requests must include an Authorization header with your personal API key. Generate and manage your keys in the API Keys dashboard.

HTTP Header

Authorization: Bearer YOUR_API_KEY

Base URL

All API requests should be made to our globally distributed edge network using the following base URL:

Live Endpoint

https://nobalmako.gm/api

Variables

Programmatically manage your project-level environment variables.

GET/api/variables

List all environment variables for a team and environment.

Parameters

teamIdUUID*

The ID of the project

environmentIdUUID*

The ID of the environment

Response Sample

{
  "variables": [
    {
      "id": "uuid",
      "key": "DATABASE_URL",
      "value": "postgres://...",
      "isSecret": true
    }
  ]
}

POST/api/variables

Create a new environment variable.

Request Payload

{
  "teamId": "uuid",
  "environmentId": "uuid",
  "key": "API_KEY",
  "value": "secret_value",
  "isSecret": true
}

Response Sample

{
  "success": true,
  "variable": { "id": "uuid", "key": "API_KEY" }
}

GET/api/environments

Get all environments for a specific project.

Parameters

teamIdUUID*

The project ID

Response Sample

{
  "environments": [
    { "id": "uuid", "name": "Production", "color": "#ef4444" },
    { "id": "uuid", "name": "Staging", "color": "#f59e0b" }
  ]
}

GET/api/audit-logs

Retrieve security audit logs for a project.

Parameters

teamIdUUID*

The project ID

limitnumber

Number of logs to return (default: 50)

Response Sample

{
  "logs": [
    {
      "id": "uuid",
      "action": "update",
      "resourceType": "variable",
      "userName": "John Doe",
      "createdAt": "2026-01-31T12:00:00Z"
    }
  ]
}

Quick Start: cURL

curl -X GET "https://nobalmako.com/api/variables?teamId=123&envId=456" \
  -H "Authorization: Bearer ${NOBALMAKO_TOKEN}"

Replace NOBALMAKO_TOKEN with your actual API key to start pulling secrets instantly.