northflank_list_repositories
List connected GitHub repositories
List GitHub repositories accessible through Northflank's linked GitHub accounts, with repository URLs and account logins for northflank_create_combined_service. Does not connect a new GitHub account. GET /v1/integrations/vcs/repos.
ParameterspagecursorteamIdper_pageaccountLogin
northflank_list_plans
List deployment plans
List Northflank deployment plan IDs, CPU, RAM and vendor prices. Choose an explicit deploymentPlan for northflank_create_combined_service; these are Northflank infrastructure charges, separate from UsefulAPI. GET /v1/plans.
Takes no parameters.
northflank_create_combined_service
Create GitHub build and deployment service (incurs charges)
MUTATING: create a combined service that builds a connected GitHub repository and deploys it. May incur Northflank build/compute charges and expose the selected HTTP port publicly. Confirm the repository, branch, plan, port and inherited-secret access with the user, then pass confirm=true. Supply absolute Dockerfile/context paths. environmentSecretReferences maps runtime variable names to existing inherited variable NAMES (for example DATABASE_URL: DB_CONNECTION becomes ${DB_CONNECTION}); never supply secret values. Secret groups must already apply to this service through project scope, existing tags or stageId. This tool does not change secret-group restrictions. A successful creation is not proof of a successful build or healthy deployment: inspect the service and build history. Never blindly retry an uncertain creation; list services first. POST /v1/projects/{projectId}/services/combined.
ParametersnamerequiredtagsbranchrequiredpublicrequiredteamIdconfirmrequiredstageIdhttpPortrequiredbuildPlaninstancesprojectIdrequiredhealthCheck+6 more
northflank_list_projects
List projects
List projects for the authenticated token (or a specific team). Good first call to discover project ids. GET /v1/projects (team: GET /v1/teams/{teamId}/projects).
ParameterspagecursorteamIdper_page
northflank_get_project
Get project
Get details of a single project, including region, cluster and associated services/jobs/addons. GET /v1/projects/{projectId}.
ParametersprojectIdrequired
northflank_list_services
List services
List services in a project (build / deployment / combined) with their build+deployment status. GET /v1/projects/{projectId}/services.
ParameterspagecursorteamIdper_pageprojectIdrequired
northflank_get_service
Get service
Get details and current status of a single service. GET /v1/projects/{projectId}/services/{serviceId}.
ParametersteamIdprojectIdrequiredserviceIdrequired
northflank_list_jobs
List jobs
List jobs (manual / cron) in a project. GET /v1/projects/{projectId}/jobs.
Parameterspagecursorper_pageprojectIdrequired
northflank_get_job
Get job
Get details of a single job, including build/deploy config and cron schedule. GET /v1/projects/{projectId}/jobs/{jobId}.
ParametersjobIdrequiredprojectIdrequired
northflank_list_addons
List addons
List addons (managed databases / services) in a project with their status. GET /v1/projects/{projectId}/addons.
Parameterspagecursorper_pageprojectIdrequired
northflank_get_addon
Get addon
Get details and status of a single addon. GET /v1/projects/{projectId}/addons/{addonId}.
ParametersaddonIdrequiredprojectIdrequired
northflank_list_service_builds
List service builds
List a build service's build runs / history (branch, sha, status, timestamps). GET /v1/projects/{projectId}/services/{serviceId}/build.
ParameterspagecursorteamIdper_pageprojectIdrequiredserviceIdrequired
northflank_get_service_metrics
Get service metrics
Get CPU / memory metrics for a service's containers. GET /v1/projects/{projectId}/services/{serviceId}/metrics. Use queryType=single (default) for a current snapshot or queryType=range with duration/startTime/endTime.
ParameterstimeendTimedurationprojectIdrequiredqueryTypeserviceIdrequiredstartTimemetricTypes
northflank_list_secret_groups
List secret groups
List a project's secret groups — METADATA ONLY (id, name, type, priority, restrictions). Does NOT return secret values. GET /v1/projects/{projectId}/secrets.
ParameterspagecursorteamIdper_pageprojectIdrequired
northflank_list_domains
List domains
List custom domains for the account (or a team), with verification status. GET /v1/domains (team: GET /v1/teams/{teamId}/domains).
ParameterspagecursorteamIdper_page
northflank_trigger_service_build
Trigger service build (mutates infra)
MUTATING: start a new build for a build/combined service. With an empty body it builds the latest commit on the linked branch; optionally target a branch, a specific commit sha, or a pull request. POST /v1/projects/{projectId}/services/{serviceId}/build.
ParametersshabranchprojectIdrequiredserviceIdrequiredpullRequestId
northflank_restart_service
Restart service (mutates infra)
MUTATING: restart all running containers of a service. POST /v1/projects/{projectId}/services/{serviceId}/restart.
ParametersprojectIdrequiredserviceIdrequired
northflank_scale_service
Scale service (mutates infra)
MUTATING: set the number of running instances (replicas) for a service. POST /v1/projects/{projectId}/services/{serviceId}/scale.
ParametersinstancesrequiredprojectIdrequiredserviceIdrequired
northflank_pause_service
Pause service (mutates infra)
MUTATING: pause a service, scaling it to zero running instances. POST /v1/projects/{projectId}/services/{serviceId}/pause.
ParametersprojectIdrequiredserviceIdrequired
northflank_resume_service
Resume service (mutates infra)
MUTATING: resume a paused service. Optionally set the instance count and CI/CD/autoscaling state to restore. POST /v1/projects/{projectId}/services/{serviceId}/resume.
ParametersinstancesprojectIdrequiredserviceIdrequireddisabledCDdisabledCIenableAutoscaling