Project proxies

​

List proxies

​

GET /:project/api/proxies

• Query – source=db forces the API to return only proxies stored in the database. Without the query parameter, Browsary asks the configured ProxyProvider for dynamic proxies tied to the user and project.
• Response – array of proxy descriptors { id?, name?, hostname, port, protocol, username?, password?, metadata }.

​

Create

​

POST /:project/api/proxies

• Auth – requires proxies.write on the project.
• Body

{
  "name": "Corp exit node",
  "hostname": "proxy.corp.example",
  "port": 3128,
  "protocol": "http",
  "username": "bot",
  "password": "secret",
  "metadata": { "region": "us-east-1" }
}

• Validation – hostname/protocol must be non-empty strings; port must be a positive integer. Optional fields are checked for type consistency.
• Response – the created proxy row as stored in the database.

​

Get / patch / delete