API Reference

REST API endpoints for the Nebion platform. Used by the Nebion CLI and available for custom integrations.

Endpoints at a Glance

Method	Path	Description
GET	/api/me	Current user and organizations
GET	/api/projects	List projects
GET	/api/projects/{id}/environments	List environments for a project
GET	/api/environments/{id}/logs	Container logs
GET	/api/environments/{id}/tasks	Deployment task history
GET	/api/environments/{id}/diagnostics	Error diagnostics for failed deploys
POST	/api/servers/{id}/ssh	Request SSH certificate

Authentication

All requests require an OAuth2 Bearer token:

Authorization: Bearer <access_token>

To obtain a token, log in with the CLI Tool:

nebioncli login

The token is stored in ~/.config/nebioncli/credentials.json. You can use it for custom integrations.

Many endpoints also support the optional X-Nebion-Organization header to scope results to a specific organization.

Quick Example

Request

curl -s https://nebion.wsagency.io/api/projects \
  -H "Authorization: Bearer <access_token>" \
  -H "X-Nebion-Organization: 1"

Response

[
  {
    "id": 42,
    "name": "My Project",
    "repo_url": "git@github.com:example/project.git",
    "domain": "example.com",
    "environment_count": 3,
    "servers": [
      {
        "id": 10,
        "name": "Production Server",
        "hostname": "192.168.1.100"
      }
    ]
  }
]

Interactive Reference

Expand any endpoint below to see parameters, request format, and example responses.