curl --request POST \
--url 'https://api.flashcat.cloud/safari/a2a-agent/update?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"agent_id": "a2a_6mWqZ2pK9nLcR3tY8uVb4D",
"description": "Inspects deployment pipelines and proposes rollbacks."
}
'import requests
url = "https://api.flashcat.cloud/safari/a2a-agent/update?app_key="
payload = {
"agent_id": "a2a_6mWqZ2pK9nLcR3tY8uVb4D",
"description": "Inspects deployment pipelines and proposes rollbacks."
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
agent_id: 'a2a_6mWqZ2pK9nLcR3tY8uVb4D',
description: 'Inspects deployment pipelines and proposes rollbacks.'
})
};
fetch('https://api.flashcat.cloud/safari/a2a-agent/update?app_key=', 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.flashcat.cloud/safari/a2a-agent/update?app_key=",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'agent_id' => 'a2a_6mWqZ2pK9nLcR3tY8uVb4D',
'description' => 'Inspects deployment pipelines and proposes rollbacks.'
]),
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://api.flashcat.cloud/safari/a2a-agent/update?app_key="
payload := strings.NewReader("{\n \"agent_id\": \"a2a_6mWqZ2pK9nLcR3tY8uVb4D\",\n \"description\": \"Inspects deployment pipelines and proposes rollbacks.\"\n}")
req, _ := http.NewRequest("POST", 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.post("https://api.flashcat.cloud/safari/a2a-agent/update?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"agent_id\": \"a2a_6mWqZ2pK9nLcR3tY8uVb4D\",\n \"description\": \"Inspects deployment pipelines and proposes rollbacks.\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/safari/a2a-agent/update?app_key=")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"agent_id\": \"a2a_6mWqZ2pK9nLcR3tY8uVb4D\",\n \"description\": \"Inspects deployment pipelines and proposes rollbacks.\"\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"data": null
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "InvalidParameter",
"message": "The specified parameter skill_id is not valid."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "Unauthorized",
"message": "You are unauthorized."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "AccessDenied",
"message": "Access Denied."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "RequestTooFrequently",
"message": "Request too frequently."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "InternalError",
"message": "We encountered an internal error, and it has been reported. Please try again later."
}
}Update A2A agent
Apply a partial update to an A2A agent. Omit a field to leave it unchanged.
curl --request POST \
--url 'https://api.flashcat.cloud/safari/a2a-agent/update?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"agent_id": "a2a_6mWqZ2pK9nLcR3tY8uVb4D",
"description": "Inspects deployment pipelines and proposes rollbacks."
}
'import requests
url = "https://api.flashcat.cloud/safari/a2a-agent/update?app_key="
payload = {
"agent_id": "a2a_6mWqZ2pK9nLcR3tY8uVb4D",
"description": "Inspects deployment pipelines and proposes rollbacks."
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
agent_id: 'a2a_6mWqZ2pK9nLcR3tY8uVb4D',
description: 'Inspects deployment pipelines and proposes rollbacks.'
})
};
fetch('https://api.flashcat.cloud/safari/a2a-agent/update?app_key=', 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.flashcat.cloud/safari/a2a-agent/update?app_key=",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'agent_id' => 'a2a_6mWqZ2pK9nLcR3tY8uVb4D',
'description' => 'Inspects deployment pipelines and proposes rollbacks.'
]),
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://api.flashcat.cloud/safari/a2a-agent/update?app_key="
payload := strings.NewReader("{\n \"agent_id\": \"a2a_6mWqZ2pK9nLcR3tY8uVb4D\",\n \"description\": \"Inspects deployment pipelines and proposes rollbacks.\"\n}")
req, _ := http.NewRequest("POST", 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.post("https://api.flashcat.cloud/safari/a2a-agent/update?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"agent_id\": \"a2a_6mWqZ2pK9nLcR3tY8uVb4D\",\n \"description\": \"Inspects deployment pipelines and proposes rollbacks.\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/safari/a2a-agent/update?app_key=")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"agent_id\": \"a2a_6mWqZ2pK9nLcR3tY8uVb4D\",\n \"description\": \"Inspects deployment pipelines and proposes rollbacks.\"\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"data": null
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "InvalidParameter",
"message": "The specified parameter skill_id is not valid."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "Unauthorized",
"message": "You are unauthorized."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "AccessDenied",
"message": "Access Denied."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "RequestTooFrequently",
"message": "Request too frequently."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "InternalError",
"message": "We encountered an internal error, and it has been reported. Please try again later."
}
}Restrictions
| Aspect | Value |
|---|---|
| Rate limits | 1,000 requests/minute; 50 requests/second per account |
| Permissions | Agent Manage (ai-sre) |
Usage
- Every call is recorded in the account audit log.
Authorizations
App key issued from the Flashduty console. Required on every public API call. Keep it secret — it grants the same access as the owning account.
Body
Partial update of an A2A agent. A null/omitted field is left unchanged.
Target agent ID.
New display name. Omit to leave unchanged.
128New description. Omit to leave unchanged.
2000New card URL. Omit to leave unchanged.
New auth type. Omit to leave unchanged.
Replace the auth config. Omit to leave unchanged.
Show child attributes
Show child attributes
Toggle streaming support. Omit to leave unchanged.
Reassign team scope. Omit to leave unchanged.
New auth mode: shared, per_user_secret, or per_user_oauth.
New JSON secret schema.
New JSON OAuth metadata.
Response
Success
Standard response envelope used by every Flashduty public API. On success data contains the endpoint-specific payload and error is absent. On failure error is present and data is absent. request_id is always present and is also mirrored in the Flashcat-Request-Id response header.
Unique ID for this request. Mirrored in the Flashcat-Request-Id header. Include it when reporting issues.
"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"
Error payload inside the response envelope. Present only on non-2xx responses.
Show child attributes
Show child attributes
Always null on success.
Was this page helpful?