LogoLogo
Nimble HomeLoginCreate an Account
  • Home
  • Quick Start Tutorials
    • Tutorial Library
      • Track SEO and SEM Ranking
      • Reddit as a Guerilla Marketing Strategy
  • Nimble Platform
    • Nimble Platform Overview
    • Online Pipelines
      • Supermarkets
        • ASDA
        • Tesco Groceries
        • Sainsbury’s
        • Morrisons
      • eCommerce
      • Restaurants
        • Yelp
        • Tabelog
        • Uber Eats Japan
        • Demaecan
        • Uber Eats US
      • Real Estate
        • Zillow
  • Nimble SDK
    • SDK Overview
    • Web API
      • Web API Overview
      • API Product Specs
      • Nimble Web API Quick Start Guide
        • Introduction
        • Nimble APIs Authentication
        • Real-time URL request
        • Delivery methods
        • Batch processing
        • Response codes
        • FAQs
      • Nimble Web API Functions
        • Realtime, Async & Batch Request
        • Geo Location Targeting
        • Javascript Rendering
        • Page Interaction
          • Wait (delay)
          • Wait for Selector
          • Wait and Click
          • Wait and Type
          • Scroll
          • Scroll to
          • Infinite Scrolling
          • Capturing Screenshots
          • Collecting Cookies
          • Executing HTTP Requests
          • Operation Reference
        • Network Capture
          • Filter by URL Matching
          • Filter By Resource Type
            • Real World Demo: Capturing Ajax Requests
          • Wait for Requests
          • Capturing XHR without Rendering
          • Operation Reference
        • Data Parsing
          • Parsing Templates
          • Merge Dynamic Parser
        • Custom Headers & Cookies
        • General Params
      • Vertical Endpoints
        • SERP API
          • Real-time search request
          • Getting local data
          • Browsing SERP pagination
          • Delivery methods
          • Batch Processing
          • Endpoints and Response Codes
        • Maps API
          • Searching for places
          • Getting information about a place
          • Collecting reviews
          • Delivery methods
          • Batch processing
          • Endpoints and Response Codes
    • Web Retrieval API
      • Web Retrieval API Overview
    • Proxy API
      • Nimble IP Overview
      • Nimble IP Quick Start Guide
        • Send a request
        • Nimble IP Autentication
        • Geotargeting and session control
        • Response codes
        • FAQs
      • Nimble IP Functions
        • Country/state/city geotargeting
        • Controlling IP rotation
        • Geo-sessions: longer, stickier, more accurate sessions
        • Using IPv6 Proxies
        • Response Codes
      • Integration Guides
        • Incogniton
        • Kameleo
        • VMLogin
        • AdsPower
        • FoxyProxy
        • Android
        • Multilogin
        • iOS
        • SwitchyOmega
        • Windows
        • macOS
        • Proxifier
        • MuLogin
        • Puppeteer
        • Selenium
        • Scrapy
    • Client Libraries
      • Installation
      • Quick Start
    • LangChain Integration
  • Technologies
    • Browserless Drivers
      • API Driver-Based Pricing
    • IP Optimization Models
    • AI Parsing Skills
  • Management Tools
    • Nimble Dashboard
      • Exploring the User Dashboard
      • Managing Pipelines
      • Reporting and Analytics
      • Account Settings
      • Experimenting with the Playground
      • Billing and history
    • Nimble Admin API
      • Admin API basics
      • Admin API reference
  • General
    • Onboarding Guide
      • Getting started with Nimble's User Dashboard
      • Nimble IP Basics
      • Nimble API Basics
      • Helpful Resources
    • FAQs
      • Account Settings and Security
      • Billing and Pricing
      • Tools and Integrations
      • Nimble API
      • Nimble IP
    • Deprecated APIs
      • E-commerce API
        • E-commerce API Authentication
        • Real-time product request
        • Real-time product search request
        • Delivery methods
        • Batch Processing
        • Endpoints and Response Codes
      • Unlocker Proxy Overview
        • Unlocker Proxy Quick Start Guide
          • Real-time request
          • FAQs
        • Unlocker Proxy FAQ
Powered by GitBook
On this page
  1. Management Tools
  2. Nimble Admin API

Admin API reference

PreviousAdmin API basicsNextOnboarding Guide

Last updated 6 days ago

INTRODUCTION

Nimble’s Admin API allows you to perform a number of key account functions, including:

  • Create, list, update, and delete pipelines

  • View account status and remaining credits

  • View account-level and pipeline-level usage reports

  • Manage authenticated IPs

Authentication

Authenticated IPs

Pipelines

Account Status

Global Preferences

Location

Generate a new API key

post

This API uses JWT/Bearer authentication: To generate an API-KEY, make a request with the following body/payload: { "key_name": "string"}

Authorizations
Body
key_namestringRequiredExample: my_key
Responses
201
API key successfully created
application/json
400
Invalid or missing request payload
application/json
401
Unauthorized
application/json
403
Forbidden – no permission to create API key
application/json
500
Internal server error
application/json
post
POST /api/v1/account/api-key HTTP/1.1
Host: api.nimbleway.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 21

{
  "key_name": "my_key"
}
{
  "guid": "abc123",
  "key_name": "my_key",
  "key": "abc123",
  "createdAt": "2024-06-01T12:00:00Z",
  "created_by": "[email protected]",
  "account_name": "my_account"
}

Get new authentication token

post

This API uses basic authentication: To generate a token, make a request without a body while authorized with your old token auth.Token TTL time is 72 HRs.

Authorizations
Responses
200
OK
application/json
401
Unauthorized
application/json
post
POST /api/v1/account/login/refresh HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Accept: */*
{
  "token": "text"
}

List account rules

get

Authenticated IPs allow the use of Nimble pipelines without username or password in your proxy settings

Authorizations
Responses
200
OK
application/json
401
Unauthorized
application/json
get
GET /api/v1/account/authenticatedips HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Accept: */*
{
  "authorized_ips": [
    "text"
  ],
  "id": "text",
  "pipeline_rules": [
    {
      "pipeline_name": "text",
      "port_range_end": 1,
      "port_range_start": 1
    }
  ]
}

List all Pipelines

get

List all account pipelines

Authorizations
Responses
200
OK
application/json
401
Unauthorized
application/json
404
Not Found
application/json
get
GET /api/v1/account/pipelines HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Accept: */*
[
  {
    "name": "text",
    "id": "text",
    "system_name": "text",
    "pipeline_type": "text",
    "proxy_pass": "text",
    "used_gb": 1,
    "spent_requests": 1,
    "created_at": "text",
    "updated_at": "text",
    "traffic": {
      "limit": {
        "amount": 1,
        "limit_type": "text"
      },
      "usage": {
        "bytes": 1,
        "last_reset_date": "text",
        "requests": 1,
        "usd": 1
      }
    },
    "allow_ipv6": true,
    "connection_string": "text",
    "optimization_engine": [
      "text"
    ],
    "pipeline_password": "text",
    "pipeline_username": "text",
    "proxy_server_address": "text",
    "proxy_server_port": 1,
    "session_settings": {
      "ip_rotation_type": "rotating",
      "rotation_time_in_seconds": 1,
      "session_ip_fallback": "replace_ip"
    },
    "status": "text",
    "target_locations": [
      {
        "country_code": "text",
        "state_code": "text",
        "city_code": "text"
      }
    ]
  }
]

Get a single Pipeline

get
Authorizations
Path parameters
pipelineNamestringRequired

Pipeline Name

Responses
200
OK
application/json
401
Unauthorized
application/json
404
Not Found
application/json
get
GET /api/v1/account/pipelines/{pipelineName} HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Accept: */*
{
  "name": "text",
  "id": "text",
  "system_name": "text",
  "pipeline_type": "text",
  "proxy_pass": "text",
  "used_gb": 1,
  "spent_requests": 1,
  "created_at": "text",
  "updated_at": "text",
  "traffic": {
    "limit": {
      "amount": 1,
      "limit_type": "text"
    },
    "usage": {
      "bytes": 1,
      "last_reset_date": "text",
      "requests": 1,
      "usd": 1
    }
  },
  "allow_ipv6": true,
  "connection_string": "text",
  "optimization_engine": [
    "text"
  ],
  "pipeline_password": "text",
  "pipeline_username": "text",
  "proxy_server_address": "text",
  "proxy_server_port": 1,
  "session_settings": {
    "ip_rotation_type": "rotating",
    "rotation_time_in_seconds": 1,
    "session_ip_fallback": "replace_ip"
  },
  "status": "text",
  "target_locations": [
    {
      "country_code": "text",
      "state_code": "text",
      "city_code": "text"
    }
  ]
}

List pipeline rules

get

Authenticated IPs allow the use of Nimble pipelines without username or password in your proxy settings

Authorizations
Path parameters
pipelineNamestringRequired

Pipeline name

Responses
200
OK
application/json
401
Unauthorized
application/json
get
GET /api/v1/account/pipelines/{pipelineName}/authenticatedips/portrange HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Accept: */*
{
  "pipeline_name": "text",
  "port_range_end": 1,
  "port_range_start": 1
}

Delete a rule

delete

Delete a pipeline port range rule

Authorizations
Path parameters
pipelineNamestringRequired

Pipeline name

Responses
200
OK
401
Unauthorized
application/json
delete
DELETE /api/v1/account/pipelines/{pipelineName}/authenticatedips/portrange HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Accept: */*

No content

Change pipeline password

put

New password will be automatically generated for the Pipeline

Authorizations
Path parameters
pipelineNamestringRequired

Pipeline Name

Responses
200
OK
application/json
400
Bad Request
application/json
401
Unauthorized
application/json
404
Not Found
application/json
put
PUT /api/v1/account/pipelines/{pipelineName}/password HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Accept: */*
{
  "name": "text",
  "id": "text",
  "system_name": "text",
  "pipeline_type": "text",
  "proxy_pass": "text",
  "used_gb": 1,
  "spent_requests": 1,
  "created_at": "text",
  "updated_at": "text",
  "traffic": {
    "limit": {
      "amount": 1,
      "limit_type": "text"
    },
    "usage": {
      "bytes": 1,
      "last_reset_date": "text",
      "requests": 1,
      "usd": 1
    }
  },
  "allow_ipv6": true,
  "connection_string": "text",
  "optimization_engine": [
    "text"
  ],
  "pipeline_password": "text",
  "pipeline_username": "text",
  "proxy_server_address": "text",
  "proxy_server_port": 1,
  "session_settings": {
    "ip_rotation_type": "rotating",
    "rotation_time_in_seconds": 1,
    "session_ip_fallback": "replace_ip"
  },
  "status": "text",
  "target_locations": [
    {
      "country_code": "text",
      "state_code": "text",
      "city_code": "text"
    }
  ]
}

Summary of daily Pipeline usage

get

Returns a daily summary of requests and response size (GB)

Authorizations
Path parameters
pipelineNamestringRequired

Pipeline Name

Query parameters
fromDatestringOptional

From Date (DD/MM/YYYY)

toDatestringOptional

To Date (DD/MM/YYYY)

Responses
200
OK
application/json
401
Unauthorized
application/json
404
Not Found
application/json
get
GET /api/v1/account/pipelines/{pipelineName}/reports/daily-usage HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Accept: */*
[
  {
    "daily_usages": [
      {
        "date": "text",
        "request_gb": 1,
        "response_gb": 1
      }
    ],
    "last_updated_at": "text",
    "total_request_gb": 1,
    "total_response_gb": 1
  }
]

Last 100 proxy requests made for specific pipeline

get
Authorizations
Path parameters
pipelineNamestringRequired

Pipeline Name

Responses
200
OK
application/json
401
Unauthorized
application/json
404
Not Found
application/json
get
GET /api/v1/account/pipelines/{pipelineName}/reports/detailed-requests HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Accept: */*
[
  {
    "account_name": "text",
    "client_ip": "text",
    "country_code": "text",
    "datetime": "text",
    "pipeline": "text",
    "request_host": "text",
    "request_port": 1,
    "request_size": 1,
    "response_size": 1,
    "total_size": 1,
    "type": "text"
  }
]

Deletes the pipelines quota daily limit

delete
Authorizations
Path parameters
pipelineNamestringRequired

Pipeline Name

Responses
200
OK
401
Unauthorized
application/json
404
Not Found
application/json
delete
DELETE /api/v1/account/pipelines/{pipelineName}/spendlimit HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Accept: */*

No content

Get account status

get
Authorizations
Responses
200
OK
application/json
401
Unauthorized
application/json
404
Not Found
application/json
get
GET /api/v1/account/remaining-credits HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Accept: */*
{
  "billing": {
    "auto_renewal": true,
    "billing_period_end": "text",
    "billing_period_start": "text",
    "next_payment_date": "text",
    "payment_method": "text",
    "remaining_credits": 1,
    "roll_over": true,
    "spent_credits": 1,
    "subscription_services": [
      {
        "name": "ip",
        "spent_data_in_gb": 1,
        "spent_requests": 1
      }
    ]
  },
  "id": "text",
  "name": "text",
  "proxy_gateway_name": "text",
  "subscription_status": "text",
  "trials": {
    "activeTrials": [
      {
        "free_quota": 1,
        "free_used": 1,
        "name": "ip",
        "quota_type": "gigabytes",
        "status": "text",
        "trial_end": "text",
        "trial_start": "text"
      }
    ]
  }
}

Summary of daily account usage

get

Returns a daily summary of requests and response size (GB)

Authorizations
Query parameters
fromDatestringOptional

From Date (DD/MM/YYYY)

toDatestringOptional

To Date (DD/MM/YYYY)

Responses
200
OK
application/json
401
Unauthorized
application/json
404
Not Found
application/json
get
GET /api/v1/account/reports/daily-usage HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Accept: */*
[
  {
    "daily_usages": [
      {
        "date": "text",
        "request_gb": 1,
        "response_gb": 1
      }
    ],
    "last_updated_at": "text",
    "total_request_gb": 1,
    "total_response_gb": 1
  }
]

Last 100 proxy requests made (entire Account)

get
Authorizations
Responses
200
OK
application/json
401
Unauthorized
application/json
get
GET /api/v1/account/reports/detailed-requests HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Accept: */*
[
  {
    "account_name": "text",
    "client_ip": "text",
    "country_code": "text",
    "datetime": "text",
    "pipeline": "text",
    "request_host": "text",
    "request_port": 1,
    "request_size": 1,
    "response_size": 1,
    "total_size": 1,
    "type": "text"
  }
]

Gets a custom timeout for a specific port

get

Gets a custom timeout for a specific port

Authorizations
Path parameters
portstringRequired

Port to query its timeout

Responses
200
OK
400
Bad Request
application/json
get
GET /api/v1/account/timeout/{port} HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Accept: */*

No content

List of supported cities

get

Gets the list of supported cities in either JSON or HTML table. When using HTML table, addCountriesAndUsStates boolean can be used to add the rest of the supported countries and US states.

Authorizations
Query parameters
tablebooleanOptional

table

addCountriesAndUsStatesbooleanOptional

addCountriesAndUsStates

Responses
200
OK
application/json
Responsestring[]
400
Bad Request
application/json
500
Internal Server Error
application/json
get
GET /api/v1/location/cities HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Accept: */*
[
  "text"
]
  • INTRODUCTION
  • Authentication
  • POSTGet authentication token
  • POSTGet new authentication token
  • POSTGenerate a new API key
  • Authenticated IPs
  • GETList account rules
  • PUTCreate a rule
  • DELETEDelete a rule
  • Pipelines
  • GETList all Pipelines
  • POSTCreate a new Pipeline
  • GETGet a single Pipeline
  • PATCHUpdate a pipeline
  • GETList pipeline rules
  • PUTCreate a pipeline rule
  • DELETEDelete a rule
  • PUTChange pipeline password
  • GETSummary of daily Pipeline usage
  • GETLast 100 proxy requests made for specific pipeline
  • POSTSets daily quota limit for a pipeline
  • DELETEDeletes the pipelines quota daily limit
  • Account Status
  • GETGet account status
  • GETSummary of daily account usage
  • GETLast 100 proxy requests made (entire Account)
  • Global Preferences
  • POSTSets custom timeout to an allowed port
  • DELETERemoves custom timeout to an allowed port
  • GETGets a custom timeout for a specific port
  • Location
  • GETList of supported cities

Get authentication token

post

This API uses JWT/Bearer authentication:

To generate a token, make a request with the following body/payload: { "username": "string", "password": "string" }

Apply the received token in your following API request, by adding the header: authorization: Bearer [token]

auth.Token TTL time is 72 HRs.

Body
usernamestringRequired
passwordstringRequired
Responses
200
OK
application/json
400
Bad Request
application/json
401
Unauthorized
application/json
post
POST /api/v1/account/login HTTP/1.1
Host: api.nimbleway.com
Content-Type: application/json
Accept: */*
Content-Length: 37

{
  "username": "text",
  "password": "text"
}
{
  "token": "text"
}

Create a rule

put

An authenticated IP can only be used with a single account. Authenticated IP will identify the target account in your proxy requests, replacing the need for using username or password

Authorizations
Body
ip_addressesstring[]Required
Responses
200
OK
application/json
401
Unauthorized
application/json
put
PUT /api/v1/account/authenticatedips HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 25

{
  "ip_addresses": [
    "text"
  ]
}
{
  "authorized_ips": [
    "text"
  ],
  "id": "text",
  "pipeline_rules": [
    {
      "pipeline_name": "text",
      "port_range_end": 1,
      "port_range_start": 1
    }
  ]
}

Delete a rule

delete

Delete an authenticated IP rule

Authorizations
Body
ip_addressstringRequired
Responses
200
OK
401
Unauthorized
application/json
delete
DELETE /api/v1/account/authenticatedips HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 21

{
  "ip_address": "text"
}

No content

Create a new Pipeline

post
  • Pipeline name - Use A-Z, a-z, 0-9 (can include space '.', '-', '_'). Up to 50 characters.
  • Target country - Default target country for the pipeline. Will apply to all request that do not specify a target country. Use ISO country code of 2-letter country code i.e. US, DE, BR.
  • Session settings configuration: When using rotating type, fallback is required in case a session_id is provided in order to set the behavior in case ip is not available When using fixed_interval type, rotation_time_in_seconds is required in order to set the interval of ip rotation and fallback is required as well for the same reason as above. replace_ip fallback will replace the session's ip to a new one and will keep using it as if it was selected in the first place. keep_asn fallback will find a new ip within the same asn and will keep using it as if it was selected in the first place. fail_request fallback will fail the request.
Authorizations
Body
namestring · min: 2 · max: 50Required

in swagger indicate wat's optional

allow_ipv6booleanOptional

Sets the default behavior of the project to allow the use of ipv6 from peers.

optimization_enginestring[] · max: 1Optional
pipeline_passwordstring · min: 8 · max: 12Optional
pipeline_typestring · enumRequiredPossible values:
session_settingsall ofOptional

Sets the default behavior of the project's session

Responses
201
Created
application/json
400
Bad Request
application/json
401
Unauthorized
application/json
404
Not Found
application/json
post
POST /api/v1/account/pipelines HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 311

{
  "name": "text",
  "allow_ipv6": true,
  "optimization_engine": [
    "text"
  ],
  "pipeline_password": "text",
  "pipeline_type": "ip",
  "session_settings": {
    "ip_rotation_type": "rotating",
    "rotation_time_in_seconds": 1,
    "session_ip_fallback": "replace_ip"
  },
  "target_locations": [
    {
      "country_code": "text",
      "state_code": "text",
      "city_code": "text"
    }
  ]
}
{
  "name": "text",
  "id": "text",
  "system_name": "text",
  "pipeline_type": "text",
  "proxy_pass": "text",
  "used_gb": 1,
  "spent_requests": 1,
  "created_at": "text",
  "updated_at": "text",
  "traffic": {
    "limit": {
      "amount": 1,
      "limit_type": "text"
    },
    "usage": {
      "bytes": 1,
      "last_reset_date": "text",
      "requests": 1,
      "usd": 1
    }
  },
  "allow_ipv6": true,
  "connection_string": "text",
  "optimization_engine": [
    "text"
  ],
  "pipeline_password": "text",
  "pipeline_username": "text",
  "proxy_server_address": "text",
  "proxy_server_port": 1,
  "session_settings": {
    "ip_rotation_type": "rotating",
    "rotation_time_in_seconds": 1,
    "session_ip_fallback": "replace_ip"
  },
  "status": "text",
  "target_locations": [
    {
      "country_code": "text",
      "state_code": "text",
      "city_code": "text"
    }
  ]
}

Update a pipeline

patch

Change pipeline's target country, session settings, Ipv6, project quota limit and status

  • Session settings configuration: When using rotating type, fallback is required in case a session_id is provided in order to set the behavior in case ip is not available When using fixed_interval type, rotation_time_in_seconds is required in order to set the interval of ip rotation and fallback is required as well for the same reason as above. replace_ip fallback will replace the session's ip to a new one and will keep using it as if it was selected in the first place. keep_asn fallback will find a new ip within the same asn and will keep using it as if it was selected in the first place. fail_request fallback will fail the request.
Authorizations
Path parameters
pipelineNamestringRequired

Pipeline Name

Body
allow_ipv6booleanOptional

Sets the default behavior of the project to allow the use of ipv6 from peers.

optimization_enginestring[] · max: 1Optional
pipeline_passwordstring · min: 8 · max: 12Optional
session_settingsall ofOptional

Sets the default behavior of the project's session

statusstringOptional
Responses
200
OK
application/json
400
Bad Request
application/json
401
Unauthorized
application/json
404
Not Found
application/json
patch
PATCH /api/v1/account/pipelines/{pipelineName} HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 292

{
  "allow_ipv6": true,
  "optimization_engine": [
    "text"
  ],
  "pipeline_password": "text",
  "session_settings": {
    "ip_rotation_type": "rotating",
    "rotation_time_in_seconds": 1,
    "session_ip_fallback": "replace_ip"
  },
  "status": "text",
  "target_locations": [
    {
      "country_code": "text",
      "state_code": "text",
      "city_code": "text"
    }
  ]
}
{
  "name": "text",
  "id": "text",
  "system_name": "text",
  "pipeline_type": "text",
  "proxy_pass": "text",
  "used_gb": 1,
  "spent_requests": 1,
  "created_at": "text",
  "updated_at": "text",
  "traffic": {
    "limit": {
      "amount": 1,
      "limit_type": "text"
    },
    "usage": {
      "bytes": 1,
      "last_reset_date": "text",
      "requests": 1,
      "usd": 1
    }
  },
  "allow_ipv6": true,
  "connection_string": "text",
  "optimization_engine": [
    "text"
  ],
  "pipeline_password": "text",
  "pipeline_username": "text",
  "proxy_server_address": "text",
  "proxy_server_port": 1,
  "session_settings": {
    "ip_rotation_type": "rotating",
    "rotation_time_in_seconds": 1,
    "session_ip_fallback": "replace_ip"
  },
  "status": "text",
  "target_locations": [
    {
      "country_code": "text",
      "state_code": "text",
      "city_code": "text"
    }
  ]
}

Create a pipeline rule

put

An authenticated port range can only be used with a single pipeline. Authenticated port will identify the target pipeline in your proxy requests, replacing the need for using username or password

Authorizations
Path parameters
pipelineNamestringRequired

Pipeline name

Body
port_range_endintegerRequired
port_range_startintegerRequired
Responses
200
OK
application/json
401
Unauthorized
application/json
put
PUT /api/v1/account/pipelines/{pipelineName}/authenticatedips/portrange HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 41

{
  "port_range_end": 1,
  "port_range_start": 1
}
{
  "authorized_ips": [
    "text"
  ],
  "id": "text",
  "pipeline_rules": [
    {
      "pipeline_name": "text",
      "port_range_end": 1,
      "port_range_start": 1
    }
  ]
}

Sets daily quota limit for a pipeline

post

Sets a daily limit to prevent pipeline from over spending. Two limit types are available:

  • "gb" for limiting the transferred data by GBs
  • "credit" for limiting the amount of used credits
Authorizations
Path parameters
pipelineNamestringRequired

Pipeline Name

Body
amountnumberOptional
typestringRequired
Responses
200
OK
401
Unauthorized
application/json
404
Not Found
application/json
post
POST /api/v1/account/pipelines/{pipelineName}/spendlimit HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 26

{
  "amount": 1,
  "type": "text"
}

No content

Sets custom timeout to an allowed port

post
  • Sets custom timeout to an allowed port, to allow ports contact Nimble admin (the value can range between 10 and 30 seconds)
  • Port must be allowed in order to set a custom timeout
Authorizations
Body
portintegerRequired
timeout_in_secsinteger · min: 10 · max: 30Required
Responses
200
OK
400
Bad Request
application/json
post
POST /api/v1/account/timeout HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 30

{
  "port": 1,
  "timeout_in_secs": 1
}

No content

Removes custom timeout to an allowed port

delete

Removes custom timeout to an allowed port

Authorizations
Body
portintegerRequired
Responses
200
OK
400
Bad Request
application/json
delete
DELETE /api/v1/account/timeout HTTP/1.1
Host: api.nimbleway.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 10

{
  "port": 1
}

No content