Request an IP replacement

POST

/orders/{id}/replacement-requests

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.proxyrequest.com/api/v1/orders/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/replacement-requests");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Accept-Language: de");
headers = curl_slist_append(headers, "Authorization: Bearer <token>");
headers = curl_slist_append(headers, "Content-Type: application/json");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, "{ \"endpoint_ids\": [ \"550e8400-e29b-41d4-a716-446655440001\" ], \"reason\": \"not_working\", \"details\": \"\", \"idempotency_key\": \"idempotency key\" }");

CURLcode ret = curl_easy_perform(hnd);

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
    Method = HttpMethod.Post,
    RequestUri = new Uri("https://api.proxyrequest.com/api/v1/orders/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/replacement-requests"),
    Headers =
    {
        { "Accept-Language", "de" },
        { "Authorization", "Bearer <token>" },
    },
    Content = new StringContent("{ \"endpoint_ids\": [ \"550e8400-e29b-41d4-a716-446655440001\" ], \"reason\": \"not_working\", \"details\": \"\", \"idempotency_key\": \"idempotency key\" }")
    {
        Headers =
        {
            ContentType = new MediaTypeHeaderValue("application/json")
        }
    }
};
using (var response = await client.SendAsync(request))
{
    response.EnsureSuccessStatusCode();
    var body = await response.Content.ReadAsStringAsync();
    Console.WriteLine(body);
}

package main

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

func main() {

  url := "https://api.proxyrequest.com/api/v1/orders/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/replacement-requests"

  payload := strings.NewReader("{ \"endpoint_ids\": [ \"550e8400-e29b-41d4-a716-446655440001\" ], \"reason\": \"not_working\", \"details\": \"\", \"idempotency_key\": \"idempotency key\" }")

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

  req.Header.Add("Accept-Language", "de")
  req.Header.Add("Authorization", "Bearer <token>")
  req.Header.Add("Content-Type", "application/json")

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

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

  fmt.Println(res)
  fmt.Println(string(body))

}

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.proxyrequest.com/api/v1/orders/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/replacement-requests"))
    .header("Accept-Language", "de")
    .header("Authorization", "Bearer <token>")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{ \"endpoint_ids\": [ \"550e8400-e29b-41d4-a716-446655440001\" ], \"reason\": \"not_working\", \"details\": \"\", \"idempotency_key\": \"idempotency key\" }"))
    .build();
HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{ \"endpoint_ids\": [ \"550e8400-e29b-41d4-a716-446655440001\" ], \"reason\": \"not_working\", \"details\": \"\", \"idempotency_key\": \"idempotency key\" }");
Request request = new Request.Builder()
  .url("https://api.proxyrequest.com/api/v1/orders/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/replacement-requests")
  .post(body)
  .addHeader("Accept-Language", "de")
  .addHeader("Authorization", "Bearer <token>")
  .addHeader("Content-Type", "application/json")
  .build();

Response response = client.newCall(request).execute();

import axios from 'axios';

const options = {
  method: 'POST',
  url: 'https://api.proxyrequest.com/api/v1/orders/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/replacement-requests',
  headers: {
    'Accept-Language': 'de',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  data: {
    endpoint_ids: ['550e8400-e29b-41d4-a716-446655440001'],
    reason: 'not_working',
    details: '',
    idempotency_key: 'idempotency key'
  }
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

const url = 'https://api.proxyrequest.com/api/v1/orders/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/replacement-requests';
const options = {
  method: 'POST',
  headers: {
    'Accept-Language': 'de',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: '{"endpoint_ids":["550e8400-e29b-41d4-a716-446655440001"],"reason":"not_working","details":"","idempotency_key":"idempotency key"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

val client = OkHttpClient()

val mediaType = MediaType.parse("application/json")
val body = RequestBody.create(mediaType, "{ \"endpoint_ids\": [ \"550e8400-e29b-41d4-a716-446655440001\" ], \"reason\": \"not_working\", \"details\": \"\", \"idempotency_key\": \"idempotency key\" }")
val request = Request.Builder()
  .url("https://api.proxyrequest.com/api/v1/orders/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/replacement-requests")
  .post(body)
  .addHeader("Accept-Language", "de")
  .addHeader("Authorization", "Bearer <token>")
  .addHeader("Content-Type", "application/json")
  .build()

val response = client.newCall(request).execute()

use serde_json::json;
use reqwest;

#[tokio::main]
pub async fn main() {
    let url = "https://api.proxyrequest.com/api/v1/orders/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/replacement-requests";

    let payload = json!({
        "endpoint_ids": ("550e8400-e29b-41d4-a716-446655440001"),
        "reason": "not_working",
        "details": "",
        "idempotency_key": "idempotency key"
    });

    let mut headers = reqwest::header::HeaderMap::new();
    headers.insert("Accept-Language", "de".parse().unwrap());
    headers.insert("Authorization", "Bearer <token>".parse().unwrap());
    headers.insert("Content-Type", "application/json".parse().unwrap());

    let client = reqwest::Client::new();
    let response = client.post(url)
        .headers(headers)
        .json(&payload)
        .send()
        .await;

    let results = response.unwrap()
        .json::<serde_json::Value>()
        .await
        .unwrap();

    dbg!(results);
}

curl --request POST \
  --url https://api.proxyrequest.com/api/v1/orders/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/replacement-requests \
  --header 'Accept-Language: de' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "endpoint_ids": [ "550e8400-e29b-41d4-a716-446655440001" ], "reason": "not_working", "details": "", "idempotency_key": "idempotency key" }'

wget --quiet \
  --method POST \
  --header 'Accept-Language: de' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --body-data '{ "endpoint_ids": [ "550e8400-e29b-41d4-a716-446655440001" ], "reason": "not_working", "details": "", "idempotency_key": "idempotency key" }' \
  --output-document \
  - https://api.proxyrequest.com/api/v1/orders/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/replacement-requests

Submit distinct active endpoints from one owned order and a reason for administrator approval. A custom reason is limited to 255 characters. Pending requests do not reserve inventory or change the paid rental period.

Authorizations

BearerAuth
StaticAuth

Parameters

Path Parameters

required

string format: uuid

Header Parameters

Accept-Language

string

default: en

Preferred language for human-readable API errors. Supported languages: en, ru, uk, de, it, fr, es. Regional language tags and quality weights are accepted; unsupported or omitted values use English.

Examples

de

fr-CA, fr;q=0.9, en;q=0.5

Request Body^required

object

endpoint_ids

required

Array<string>

>= 1 items <= 10000 items

reason

required

not_working - not_working * slow_speed - slow_speed * blocked - blocked * other - other

string

Allowed values: not_working slow_speed blocked other

details

string

"" <= 255 characters

idempotency_key

required

string

>= 1 characters <= 128 characters

Examples

example

Example request

{
  "endpoint_ids": [
    "550e8400-e29b-41d4-a716-446655440001"
  ],
  "reason": "not_working",
  "details": "",
  "idempotency_key": "idempotency key"
}

object

endpoint_ids

required

Array<string>

>= 1 items <= 10000 items

reason

required

not_working - not_working * slow_speed - slow_speed * blocked - blocked * other - other

string

Allowed values: not_working slow_speed blocked other

details

string

"" <= 255 characters

idempotency_key

required

string

>= 1 characters <= 128 characters

Examples

example

Example request

endpoint_ids=550e8400-e29b-41d4-a716-446655440001&reason=not_working&details=&idempotency_key=idempotency+key

object

endpoint_ids

required

Array<string>

>= 1 items <= 10000 items

reason

required

not_working - not_working * slow_speed - slow_speed * blocked - blocked * other - other

string

Allowed values: not_working slow_speed blocked other

details

string

"" <= 255 characters

idempotency_key

required

string

>= 1 characters <= 128 characters

Examples

example

Example request

{
  "endpoint_ids": [
    "550e8400-e29b-41d4-a716-446655440001"
  ],
  "reason": "not_working",
  "details": "",
  "idempotency_key": "idempotency key"
}

Responses

200

The operation completed successfully.

application/json

object

key

additional properties

Examples

example

Example response

{}

400

The request is malformed or violates a business rule.

application/json

Validation and API error payload. Field names may be added dynamically; field errors are returned as arrays of human-readable messages.

object

detail

string

non_field_errors

Array<string>

key

additional properties

One of:

string
Array<string>

string

Examples

example

Validation error

{
  "non_field_errors": [
    "The request could not be processed."
  ]
}

Headers

Content-Language

string

Language used for human-readable errors.

401

Authentication credentials are missing, expired, or invalid.

application/json

Validation and API error payload. Field names may be added dynamically; field errors are returned as arrays of human-readable messages.

object

detail

string

non_field_errors

Array<string>

key

additional properties

One of:

string
Array<string>

string

Examples

example

Authentication required

{
  "detail": "Authentication credentials were not provided."
}

Headers

Content-Language

string

Language used for human-readable errors.

403

The authenticated account cannot perform this operation.

application/json

Validation and API error payload. Field names may be added dynamically; field errors are returned as arrays of human-readable messages.

object

detail

string

non_field_errors

Array<string>

key

additional properties

One of:

string
Array<string>

string

Examples

example

Permission denied

{
  "detail": "You do not have permission to perform this action."
}

Headers

Content-Language

string

Language used for human-readable errors.

404

The requested resource does not exist in the current account scope.

application/json

Validation and API error payload. Field names may be added dynamically; field errors are returned as arrays of human-readable messages.

object

detail

string

non_field_errors

Array<string>

key

additional properties

One of:

string
Array<string>

string

Examples

example

Resource not found

{
  "detail": "Not found."
}

Headers

Content-Language

string

Language used for human-readable errors.

Request an IP replacement

Authorizations

Parameters

Path Parameters

Header Parameters

Examples

Request Bodyrequired

Examples

Examples

Examples

Responses

200

Examples

400

Examples

Headers

401

Examples

Headers

403

Examples

Headers

404

Examples

Headers

Request Body^required