curl --request POST \
--url 'https://api.flashcat.cloud/safari/a2a-agent/update?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"agent_id": "a2a_6mWqZ2pK9nLcR3tY8uVb4D",
"instructions": "Inspect deployment pipelines and propose rollbacks."
}
'import requests
url = "https://api.flashcat.cloud/safari/a2a-agent/update?app_key="
payload = {
"agent_id": "a2a_6mWqZ2pK9nLcR3tY8uVb4D",
"instructions": "Inspect deployment pipelines and propose 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',
instructions: 'Inspect deployment pipelines and propose 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',
'instructions' => 'Inspect deployment pipelines and propose 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 \"instructions\": \"Inspect deployment pipelines and propose 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 \"instructions\": \"Inspect deployment pipelines and propose 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 \"instructions\": \"Inspect deployment pipelines and propose rollbacks.\"\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4"
}{
"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",
"instructions": "Inspect deployment pipelines and propose rollbacks."
}
'import requests
url = "https://api.flashcat.cloud/safari/a2a-agent/update?app_key="
payload = {
"agent_id": "a2a_6mWqZ2pK9nLcR3tY8uVb4D",
"instructions": "Inspect deployment pipelines and propose 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',
instructions: 'Inspect deployment pipelines and propose 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',
'instructions' => 'Inspect deployment pipelines and propose 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 \"instructions\": \"Inspect deployment pipelines and propose 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 \"instructions\": \"Inspect deployment pipelines and propose 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 \"instructions\": \"Inspect deployment pipelines and propose rollbacks.\"\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4"
}{
"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 | 300 requests/minute; 20 requests/second per account |
| Permissions | Agent Manage (ai-sre) |
Usage
- Requires edit rights on the agent’s current team: an account-scoped agent (
team_id=0) can be changed only by the account owner or an admin, a team agent only by members of that team (owners and admins included only if they belong to it). - Moving to another team (
team_id > 0) requires membership in the destination team; moving to account scope (team_id=0) requires the account owner or an admin. Ifenvironmentsis not sent with a team change, the current runner entries must still be selectable by the caller or the update is rejected. auth_configreplaces the whole map: keys left out are removed. Forapi_key,token, andclient_secret, sending back the masked value from get keeps the stored secret, while an empty string clears it.- When
auth_modeis sent,secret_schemais overwritten with the value sent alongside it (empty if omitted).oauth_metadatais cleared whenauth_modeorcard_urlactually changes, unless a non-emptyoauth_metadatais sent; an emptyoauth_metadataalone leaves the stored value. - Changing
card_urlre-runs the agent card compatibility check described on create; changingagent_namere-applies its naming rules. - Every call is recorded in the account audit log.
Authorizations
Body
Partial update of an A2A agent. A null/omitted field is left unchanged.
Reassign team scope; omit to leave unchanged. Moving to a team requires membership in it; moving to account scope (0) requires the account owner or an admin. If the team changes without environments in the same request, the current runner entries must stay selectable by the caller or the update is rejected.
New auth mode; omit to leave unchanged. Values (who supplies the credential):
shared(default; an empty value behaves the same): one credential stored on the agent (auth_type+auth_config) is used for every caller.per_user_secret: each user stores their own secret, sent in the header named bysecret_schema.header_name.per_user_oauth: each user completes their own OAuth authorization; discovery and client registration run on first use.
When sent, secret_schema is overwritten with the value in the same request.
shared, per_user_secret, per_user_oauth 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.
Was this page helpful?