Update A2A agent
Apply a partial update to an A2A agent. Omit a field to leave it unchanged.
Restrictions
Usage
- Requires edit permission (
access.CanEdit) on the agent’s current team before any field may change. - Reassigning
team_idrequires rights on the destination team; if the team changes without also sending a new environment binding, the existing runner binding must remain selectable by the caller or the update is rejected. - Changing
auth_modealways rewritessecret_schematogether with it; omittingoauth_metadataalongside a newauth_modeclears it to empty. - Sending back a masked or empty value for a sensitive
auth_configkey (api_key,token,client_secret) keeps the stored secret instead of overwriting it. - 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 instructions. Omit to leave unchanged. A deprecated description field is also accepted; if both are sent they must match.
2000New card URL. Omit to leave unchanged.
New auth type. Omit to leave unchanged.
Replace the auth config. Omit to leave unchanged. Sending back the masked value (or an empty string) for a sensitive key keeps the stored secret instead of overwriting it.
Toggle streaming support. Omit to leave unchanged.
Reassign team scope. Omit to leave unchanged. Reassigning requires rights on the destination team; if the team changes without also sending a new environment binding, the existing runner binding must remain selectable by the caller or the update is rejected.
New execution environment binding: empty for automatic, byoc for a specific runner. cloud is rejected. Omit to leave unchanged.
New BYOC runner ID. Required alongside environment_kind=byoc. Omit to leave unchanged.
New auth mode: shared, per_user_secret, or per_user_oauth. Changing it always rewrites secret_schema together with it.
New JSON secret schema.
New JSON OAuth metadata. If omitted while auth_mode changes, it is cleared to empty.
Toggle non-loopback HTTP OAuth discovery for this agent. Omit to leave unchanged.
Toggle TLS certificate verification skipping for this agent. Omit to leave unchanged.
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.