Skip to main content
Northflank logo
  • Category: developer tools
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 20
  • Triggers: 0
  • Slug: NORTHFLANK
  • Version: 20261101_00

Tools

Slug: NORTHFLANK_CREATE_OR_UPDATE_PROJECTTool to create a new project or update an existing project in Northflank (upsert operation). Use when you need to ensure a project exists with specific configuration, regardless of whether it’s already created.

Input Parameters

string
required
The unique identifier for the project. Used to determine if the project should be created or updated
string
required
The name of the project
string
The color of the project in the Northflank App (hex color format: #RRGGBB or #RGB)
string
required
The region where the project will be hosted
object
Advanced project networking settings.
string
The description of the project (max length: 200 characters)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NORTHFLANK_CREATE_OR_UPDATE_SECRETTool to create or update a secret group in a Northflank project. Use when you need to store encrypted runtime variables or build arguments that can be inherited by services and jobs.

Input Parameters

string
required
Unique identifier for the secret group
string
required
Display name for the secret group
integer
required
Priority order for secret inheritance. Higher numbers indicate higher priority
string
required
The unique identifier of the project where the secret will be created or updated
object
required
Key-value pairs of secret variables to store. Keys are variable names and values are the secret values
string
required
Type of secret. Common values include ‘environment-variables’, ‘environment’, ‘files’
string
Description of the secret group’s purpose

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NORTHFLANK_CREATE_SECRETTool to create a secret group in a Northflank project. Use when you need to store encrypted environment variables that can be inherited by services and jobs.

Input Parameters

string
required
Unique identifier for the secret group
string
required
Display name for the secret group
integer
required
Priority order for secret inheritance. Higher numbers indicate higher priority
string
required
The unique identifier of the project where the secret will be created
object
required
Key-value pairs of secret variables to store. Keys are variable names and values are the secret values. Keys may only contain letters, numbers, hyphens, forward slashes and dots
string
required
Type of secret. Common values include ‘environment-variables’, ‘environment’, ‘files’
string
Description of the secret group’s purpose

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NORTHFLANK_DELETE_PROJECTTool to permanently delete a Northflank project and all associated resources. Use when you need to remove a project including all builds, deployments, jobs, addons, secret groups, and configurations.

Input Parameters

string
required
The unique identifier of the project to delete. This operation permanently deletes the project and all associated resources.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NORTHFLANK_GET_DNS_IDTool to retrieve the DNS identifier for the authenticated account. Use when you need to get the DNS ID used for generating DNS entries for services and domains.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NORTHFLANK_GET_PROJECTTool to retrieve detailed information about a specific Northflank project. Use when you need to get project configuration, region, networking settings, or metadata.

Input Parameters

string
required
The unique identifier of the project to retrieve information about

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NORTHFLANK_GET_SECRETTool to retrieve a secret from a Northflank project including its contents. Use when you need to view the actual secret values and metadata for a specific secret.

Input Parameters

string
required
The unique identifier of the secret to retrieve
string
required
The unique identifier of the project containing the secret

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NORTHFLANK_GET_SECRET_DETAILSTool to view a secret with details about its linked addons from a Northflank project. Use when you need to understand addon dependencies and detailed metadata for a specific secret.

Input Parameters

string
required
The unique identifier of the secret to retrieve details for
string
required
The unique identifier of the project containing the secret

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NORTHFLANK_LIST_ADDON_TYPESTool to retrieve information about available addon types in Northflank. Use when you need to understand what addon types are supported and their features.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NORTHFLANK_LIST_CLOUD_PROVIDER_NODE_TYPESTool to retrieve supported cloud provider node types available on Northflank. Use when you need to see available node types across various cloud providers including AWS, GCP, Azure, Civo, Oracle Cloud, and CoreWeave.

Input Parameters

integer
Page number for pagination
string
Cursor for cursor-based pagination to retrieve the next page of results
integer
Number of results per page (default: 50)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NORTHFLANK_LIST_CLOUD_PROVIDER_REGIONSTool to retrieve supported cloud provider regions available on Northflank. Use when you need to see available regions across various cloud providers including AWS, GCP, Azure, Civo, Oracle Cloud, and CoreWeave.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NORTHFLANK_LIST_PIPELINESList pipelines for a Northflank project, with page, cursor, and page-size pagination support.

Input Parameters

integer
Page number for pagination
string
Cursor for cursor-based pagination
integer
Number of results per page (default: 50)
string
required
The unique identifier of the project to list pipelines for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NORTHFLANK_LIST_PLANSTool to retrieve available billing/resource plans in Northflank. Use when you need to see available plan options and their specifications.

Input Parameters

integer
Page number for pagination
string
Cursor for cursor-based pagination to retrieve the next page of results
integer
Number of results per page (default: 50)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NORTHFLANK_LIST_PROJECTSTool to list all projects in your Northflank team with pagination support. Use when you need to retrieve projects for the authenticated user or team.

Input Parameters

string
Cursor for cursor-based pagination to retrieve the next page of results. This value is returned in the pagination object of the previous response.
integer
Number of results to return per page. Default is 50, maximum is 100.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NORTHFLANK_LIST_REGIONSTool to retrieve available project regions in Northflank. Use when you need to see which geographic regions are available for deploying projects and resources.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NORTHFLANK_LIST_SECRETSTool to list all secrets belonging to a Northflank project. Use when you need to retrieve secret groups configured in a project. Supports cursor-based pagination with default 50 results per page.

Input Parameters

integer
The page number to access
string
Cursor returned from the previous page of results, used to request the next page. Used for cursor-based pagination.
integer
Number of results per page (default: 50, maximum: 100)
string
required
The unique identifier of the project to retrieve secrets from

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NORTHFLANK_LIST_SERVICESTool to list all services belonging to a Northflank project. Use when you need to retrieve services configured in a project. Supports cursor-based pagination with 50 results per page.

Input Parameters

string
Cursor returned from the previous page of results, used to request the next page. Used for cursor-based pagination.
string
required
The unique identifier of the project to retrieve services from

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NORTHFLANK_PATCH_SECRETTool to partially update a secret group in a Northflank project. Use when you need to modify specific properties of an existing secret without providing all fields.

Input Parameters

string
Display name for the secret group
integer
Priority order for secret inheritance. Higher numbers indicate higher priority
string
required
The unique identifier of the secret group to update
string
required
The unique identifier of the project containing the secret group
object
Key-value pairs of secret variables to update. Keys are variable names (must contain only letters, numbers, hyphens, forward slashes, and dots) and values are the secret values
string
Type of secret. Common values include ‘environment-variables’, ‘environment’, ‘files’
string
Description of the secret group’s purpose

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NORTHFLANK_UPDATE_PROJECTTool to update a project in Northflank. Use when you need to modify project settings such as description, color, or advanced networking configuration.

Input Parameters

string
The color of the project in hex format (e.g., #3B82F6)
string
required
ID of the project to update
object
Advanced project networking settings.
string
The description of the project (max length: 200 characters)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NORTHFLANK_UPDATE_SECRETTool to update a secret in a Northflank project. Use when you need to modify existing secret variables or add new variables to an existing secret.

Input Parameters

string
required
The unique identifier of the secret to update
string
required
The unique identifier of the project where the secret exists
object
required
Key-value pairs of secret variables to update. Keys are variable names and values are the secret values. This will update existing variables or add new ones

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not