Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Netter steps API

The steps API from Netter — 16 operation(s) for steps.

Netter steps API is one of 44 APIs that Netter publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include steps. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 22 operations across 16 paths, and defines 30 schemas. It is described by OpenAPI 3.1.0, at version 0.1.0.

Requests are made against the base URL https://api.netter.ai.

22 operations 16 paths 30 schemas 2 DELETE7 GET2 PATCH9 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
0.1.0
Base URL
https://api.netter.ai
Resource Areas
1

Paths & Operations 22

Across 16 paths, the API surfaces 22 operations — 2 DELETE, 7 GET, 2 PATCH, 9 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

steps 22
GET
/api/v1/steps/
List Steps
list_steps_api_v1_steps__get 1 param → 200422
POST
/api/v1/steps/
Create Step
create_step_api_v1_steps__post 1 param body → 201422
GET
/api/v1/steps/{step_id}
Get Step
get_step_api_v1_steps__step_id__get 1 param → 200422
PATCH
/api/v1/steps/{step_id}
Update Step
update_step_api_v1_steps__step_id__patch 1 param body → 200422
DELETE
/api/v1/steps/{step_id}
Delete Step
delete_step_api_v1_steps__step_id__delete 1 param → 204422
GET
/api/v1/steps/{step_id}/code
Get Step Code
get_step_code_api_v1_steps__step_id__code_get 1 param → 200422
PUT
/api/v1/steps/{step_id}/code
Update Step Code
update_step_code_api_v1_steps__step_id__code_put 1 param body → 200422
POST
/api/v1/steps/{step_id}/suppress
Suppress Step
suppress_step_api_v1_steps__step_id__suppress_post 1 param → 200422
PUT
/api/v1/steps/project/{project_id}/batch
Batch Replace Steps
batch_replace_steps_api_v1_steps_project__project_id__batch_put 1 param body → 200422
POST
/api/v1/steps/project/{project_id}/validate
Validate Project Dag
validate_project_dag_api_v1_steps_project__project_id__validate_post 1 param → 200422
GET
/api/v1/steps/{step_id}/swap-candidates
Get Swap Candidates
get_swap_candidates_api_v1_steps__step_id__swap_candidates_get 1 param → 200422
POST
/api/v1/steps/{step_id}/swap-input
Post Swap Input
post_swap_input_api_v1_steps__step_id__swap_input_post 1 param body → 200422
POST
/api/v1/steps/{step_id}/trigger
Create Trigger
create_trigger_api_v1_steps__step_id__trigger_post 1 param body → 201422
PATCH
/api/v1/steps/{step_id}/trigger
Update Trigger
update_trigger_api_v1_steps__step_id__trigger_patch 1 param body → 200422
DELETE
/api/v1/steps/{step_id}/trigger
Delete Trigger
delete_trigger_api_v1_steps__step_id__trigger_delete 1 param → 204422
POST
/api/v1/steps/project/{project_id}/run
Trigger Run
trigger_run_api_v1_steps_project__project_id__run_post 1 param body → 201422
GET
/api/v1/steps/project/{project_id}/runs
List Runs
list_runs_api_v1_steps_project__project_id__runs_get 2 params → 200422
GET
/api/v1/steps/run/{run_id}
Get Run
get_run_api_v1_steps_run__run_id__get 1 param → 200422
POST
/api/v1/steps/run/{run_id}/cancel
Cancel Run
cancel_run_api_v1_steps_run__run_id__cancel_post 1 param → 200422
POST
/api/v1/steps/{step_id}/auto-fix
Auto Fix Step
auto_fix_step_api_v1_steps__step_id__auto_fix_post 1 param → 202422
GET
/api/v1/projects/{project_id}/changes
List Changes
list_changes_api_v1_projects__project_id__changes_get 7 params → 200422
POST
/api/v1/projects/{project_id}/changes/goto
Goto Change
goto_change_api_v1_projects__project_id__changes_goto_post 1 param body → 200422

Schemas 30

The contract defines 30 schemas that model the data the API accepts and returns. The most detailed are StepRead (28 properties), StepBatchItem (15 properties), app__steps__schemas__RunRead (15 properties), StepRunRead (15 properties). Each schema is shown below with its type and property counts.

CodeType
string
Runtime language for the step code.
StepBatchReplace
object
Replace all steps in a project (used at deploy time).
1 property 1 required
TriggerRead
object
Trigger response.
7 properties 7 required
TriggerType
string
How a root step can be triggered. EVENT (polling) was deprecated in commit c523d2be (2026-05-02) and deleted entirely in Phase 5: cross-dataset reactive update…
Severity
string
TriggerCreate
object
Attach a trigger to a root step.
2 properties 1 required
StepRunRead
object
StepRun response.
15 properties 8 required
StepUpdate
object
Patch a step (all fields optional).
14 properties
SwapColumnDiff
object
4 properties 4 required
RunCreate
object
Trigger a new run. rootstepid is the target output (a database step). Null rootstepid means Run All — run every active step in the project. forcefull bypasses…
2 properties
StepCodeUpdate
object
Verbatim replacement of a customcode step's Python source.
1 property 1 required
TriggerUpdate
object
Patch a trigger.
2 properties
SwapCandidate
object
9 properties 9 required
StepCreate
object
Create a new step in a project DAG.
13 properties 2 required
StepBatchItem
object
One step in a batch replace.
15 properties 2 required
SwapCurrentSource
object
4 properties 4 required
ChangesListResponse
object
2 properties 1 required
SwapInputResponse
object
3 properties 3 required
app__steps__schemas__RunRead
object
Run response.
15 properties 12 required
DAGChangeEventRead
object
14 properties 13 required
GotoRequest
object
Body for POST /{projectid}/changes/goto — browser-style timeline navigation. eventid=None rewinds to the initial state (before any recorded events).
1 property
SwapInputRequest
object
1 property 1 required
StepRead
object
Step response.
28 properties 21 required
SwapRetyped
object
3 properties 3 required
SinkTarget
string
Where a datasink step writes its output.
ValidationError
object
5 properties 3 required
StepType
string
The role a step plays in the project DAG.
SwapColumn
object
2 properties 1 required
HTTPValidationError
object
1 property
SwapCandidateList
object
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

netter-steps-api-openapi.yml Raw ↑

Other APIs Netter publishes across the network.

Netter actions API
Netter api-keys API
Netter app-chat API
Netter apps API
Netter apps-query API
Netter assistant API
Netter attributes API
Netter automations API
Netter chats API
Netter companies API
Netter dashboard-chat API
Netter dashboard-data API