Update proxy

cURL

curl --request PATCH \
  --url https://us.infisical.com/api/v1/agent-vault/proxies/{proxyId} \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "allowedHosts": "<string>",
  "pollInterval": 155
}
'

import requests

url = "https://us.infisical.com/api/v1/agent-vault/proxies/{proxyId}"

payload = {
    "name": "<string>",
    "allowedHosts": "<string>",
    "pollInterval": 155
}
headers = {"Content-Type": "application/json"}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({name: '<string>', allowedHosts: '<string>', pollInterval: 155})
};

fetch('https://us.infisical.com/api/v1/agent-vault/proxies/{proxyId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://us.infisical.com/api/v1/agent-vault/proxies/{proxyId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'allowedHosts' => '<string>',
    'pollInterval' => 155
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://us.infisical.com/api/v1/agent-vault/proxies/{proxyId}"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"allowedHosts\": \"<string>\",\n  \"pollInterval\": 155\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://us.infisical.com/api/v1/agent-vault/proxies/{proxyId}")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"allowedHosts\": \"<string>\",\n  \"pollInterval\": 155\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://us.infisical.com/api/v1/agent-vault/proxies/{proxyId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"allowedHosts\": \"<string>\",\n  \"pollInterval\": 155\n}"

response = http.request(request)
puts response.read_body

{
  "proxy": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "heartbeat": "2023-11-07T05:31:56Z",
    "isHealthy": true,
    "rootCaFingerprint": "<string>",
    "rootCaExpiresAt": "2023-11-07T05:31:56Z",
    "trafficPolicy": "any-host",
    "allowedHosts": "<string>",
    "pollInterval": 123,
    "createdAt": "2023-11-07T05:31:56Z"
  }
}

{
  "reqId": "<string>",
  "statusCode": 400,
  "message": "<string>",
  "error": "<string>",
  "details": "<unknown>"
}

{
  "reqId": "<string>",
  "statusCode": 401,
  "message": "<string>",
  "error": "<string>"
}

{
  "reqId": "<string>",
  "statusCode": 403,
  "message": "<string>",
  "error": "<string>",
  "details": "<unknown>"
}

{
  "reqId": "<string>",
  "statusCode": 404,
  "message": "<string>",
  "error": "<string>"
}

{
  "reqId": "<string>",
  "statusCode": 422,
  "error": "<string>",
  "message": "<unknown>"
}

{
  "reqId": "<string>",
  "statusCode": 500,
  "message": "<string>",
  "error": "<string>"
}

PATCH

api

agent-vault

proxies

{proxyId}

cURL

curl --request PATCH \
  --url https://us.infisical.com/api/v1/agent-vault/proxies/{proxyId} \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "allowedHosts": "<string>",
  "pollInterval": 155
}
'

import requests

url = "https://us.infisical.com/api/v1/agent-vault/proxies/{proxyId}"

payload = {
    "name": "<string>",
    "allowedHosts": "<string>",
    "pollInterval": 155
}
headers = {"Content-Type": "application/json"}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({name: '<string>', allowedHosts: '<string>', pollInterval: 155})
};

fetch('https://us.infisical.com/api/v1/agent-vault/proxies/{proxyId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://us.infisical.com/api/v1/agent-vault/proxies/{proxyId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'allowedHosts' => '<string>',
    'pollInterval' => 155
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://us.infisical.com/api/v1/agent-vault/proxies/{proxyId}"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"allowedHosts\": \"<string>\",\n  \"pollInterval\": 155\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://us.infisical.com/api/v1/agent-vault/proxies/{proxyId}")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"allowedHosts\": \"<string>\",\n  \"pollInterval\": 155\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://us.infisical.com/api/v1/agent-vault/proxies/{proxyId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"allowedHosts\": \"<string>\",\n  \"pollInterval\": 155\n}"

response = http.request(request)
puts response.read_body

{
  "proxy": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "heartbeat": "2023-11-07T05:31:56Z",
    "isHealthy": true,
    "rootCaFingerprint": "<string>",
    "rootCaExpiresAt": "2023-11-07T05:31:56Z",
    "trafficPolicy": "any-host",
    "allowedHosts": "<string>",
    "pollInterval": 123,
    "createdAt": "2023-11-07T05:31:56Z"
  }
}

{
  "reqId": "<string>",
  "statusCode": 400,
  "message": "<string>",
  "error": "<string>",
  "details": "<unknown>"
}

{
  "reqId": "<string>",
  "statusCode": 401,
  "message": "<string>",
  "error": "<string>"
}

{
  "reqId": "<string>",
  "statusCode": 403,
  "message": "<string>",
  "error": "<string>",
  "details": "<unknown>"
}

{
  "reqId": "<string>",
  "statusCode": 404,
  "message": "<string>",
  "error": "<string>"
}

{
  "reqId": "<string>",
  "statusCode": 422,
  "error": "<string>",
  "message": "<unknown>"
}

{
  "reqId": "<string>",
  "statusCode": 500,
  "message": "<string>",
  "error": "<string>"
}

Path Parameters

proxyId

string<uuid>

required

The ID of the proxy.

Body

application/json

name

string

The name of the proxy.

Required string length: 1 - 64

trafficPolicy

enum<string>

Which hosts an agent may reach through this proxy. any-host lets every request out; bundle-hosts allows only hosts an access bundle covers, plus anything in allowedHosts, and refuses the rest with a 403.

Available options:

any-host,

bundle-hosts

allowedHosts

string | null

Hosts that stay reachable under the bundle-hosts traffic policy even though no access bundle covers them. Still intercepted, and given no credential.

Maximum string length: 1024

pollInterval

integer

How often, in seconds, the proxy refreshes its sessions and settings. Between 10 and 300.

Required range: 10 <= x <= 300

Response

Default Response

proxy

Admin view · object

required

Show child attributes

Get started

Organization

Project

Shared

Identity auth

Secrets management

Certificate management

Secret sharing

Infisical KMS

Agent Vault

KMIP servers

Gateways

External migrations

Other

Path Parameters

Body

Response