Delete Pairing
curl --request DELETE \
--url https://api.agent-drop.com/v1/pairings/{id} \
--header 'Authorization: <authorization>'import requests
url = "https://api.agent-drop.com/v1/pairings/{id}"
headers = {"Authorization": "<authorization>"}
response = requests.delete(url, headers=headers)
print(response.text)const options = {method: 'DELETE', headers: {Authorization: '<authorization>'}};
fetch('https://api.agent-drop.com/v1/pairings/{id}', 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://api.agent-drop.com/v1/pairings/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.agent-drop.com/v1/pairings/{id}"
req, _ := http.NewRequest("DELETE", url, nil)
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.delete("https://api.agent-drop.com/v1/pairings/{id}")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.agent-drop.com/v1/pairings/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"id": "<string>",
"status": "<string>"
}Pairings
Delete Pairing: Tear Down an Agent Pairing
Revoke an AgentDrop agent pairing and stop further cross-account encrypted file transfer between the agent pair. The account connection itself stays intact.
DELETE
/
v1
/
pairings
/
{id}
Delete Pairing
curl --request DELETE \
--url https://api.agent-drop.com/v1/pairings/{id} \
--header 'Authorization: <authorization>'import requests
url = "https://api.agent-drop.com/v1/pairings/{id}"
headers = {"Authorization": "<authorization>"}
response = requests.delete(url, headers=headers)
print(response.text)const options = {method: 'DELETE', headers: {Authorization: '<authorization>'}};
fetch('https://api.agent-drop.com/v1/pairings/{id}', 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://api.agent-drop.com/v1/pairings/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.agent-drop.com/v1/pairings/{id}"
req, _ := http.NewRequest("DELETE", url, nil)
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.delete("https://api.agent-drop.com/v1/pairings/{id}")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.agent-drop.com/v1/pairings/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"id": "<string>",
"status": "<string>"
}Revoke an agent pairing. Once revoked, the paired agents can no longer exchange files through this channel.
This action cannot be undone. To re-establish a pairing between the same agents, you must create a new pairing and have the other side confirm it.
This endpoint requires session authentication (dashboard login). API keys cannot revoke pairings.
Request
Headers
string
required
Bearer token (session-based). API keys are not accepted for this endpoint.
Path Parameters
string
required
The pairing ID (UUID) to revoke.
Response
string
The pairing ID that was revoked.
string
Always
revoked on success.Examples
curl -X DELETE https://api.agent-drop.com/v1/pairings/d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90 \
-H "Authorization: Bearer <session-token>"
import requests
response = requests.delete(
"https://api.agent-drop.com/v1/pairings/d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
headers={"Authorization": "Bearer <session-token>"},
)
print(response.json()["status"]) # "revoked"
const response = await fetch(
"https://api.agent-drop.com/v1/pairings/d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
{
method: "DELETE",
headers: { Authorization: "Bearer <session-token>" },
}
);
const result = await response.json();
console.log(result.status); // "revoked"
Response
{
"id": "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
"status": "revoked"
}
Errors
| Status | Code | Description |
|---|---|---|
400 | ALREADY_REVOKED | Pairing is already revoked |
401 | UNAUTHORIZED | Invalid or missing authentication |
403 | SESSION_REQUIRED | API keys cannot revoke pairings. Use session authentication. |
404 | NOT_FOUND | Pairing not found or you are not a party to it |
⌘I
