Skip to main content
POST
Update A2A agent

Restrictions

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. If environments is not sent with a team change, the current runner entries must still be selectable by the caller or the update is rejected.
  • auth_config replaces the whole map: keys left out are removed. For api_key, token, and client_secret, sending back the masked value from get keeps the stored secret, while an empty string clears it.
  • When auth_mode is sent, secret_schema is overwritten with the value sent alongside it (empty if omitted). oauth_metadata is cleared when auth_mode or card_url actually changes, unless a non-empty oauth_metadata is sent; an empty oauth_metadata alone leaves the stored value.
  • Changing card_url re-runs the agent card compatibility check described on create; changing agent_name re-applies its naming rules.
  • Every call is recorded in the account audit log.

Authorizations

app_key
string
query
required

APP Key created in the Flashduty console under My → APP Key. Send it as the app_key query parameter or in the Fd-App-Key request header. Its effective access is the intersection of the key's permission scope and the creator's current role permissions. Keep it secret.

Body

application/json

Partial update of an A2A agent. A null/omitted field is left unchanged.

agent_id
string
required

Target agent ID, from the list returned by POST /safari/a2a-agent/list.

agent_name
string | null

New display name; omit to leave unchanged. Same rules as create: no @, not general / explore, unique within the scope.

Maximum string length: 128
instructions
string | null

New instructions document (same contract as create: optional summary frontmatter, non-empty body, at most 50 KiB). Omit to leave unchanged. A deprecated description field is also accepted; if both are sent they must match.

Maximum string length: 51200
card_url
string | null

New card URL; omit to leave unchanged. Validated and compatibility-checked the same way as on create; a real change also clears oauth_metadata unless a new one is sent.

auth_type
enum<string> | null

New auth type; omit to leave unchanged.

  • none: no credential header.
  • api_key: sends auth_config.api_key in the header named by auth_config.header.
  • bearer: sends Authorization: Bearer <auth_config.token>.
Available options:
none,
api_key,
bearer
auth_config
object

Replace the whole auth config; omit to leave unchanged. Keys missing from the map are dropped. For a sensitive key, sending back the masked value keeps the stored secret, while sending an empty string clears it.

streaming
boolean | null

Toggle streaming support. Omit to leave unchanged.

team_id
integer<int64> | null

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.

environments
string[] | null

Execution environments this agent is callable from: cloud and/or BYOC runner environment IDs. Omit (null) to leave unchanged; send a list to set it — an empty list clears the restriction back to all environments.

auth_mode
enum<string> | null

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 by secret_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.

Available options:
shared,
per_user_secret,
per_user_oauth
secret_schema
string | null

New JSON secret schema, e.g. {"header_name":"X-Api-Key"}. Applied only together with auth_mode; sent alone it is ignored.

oauth_metadata
string | null

New JSON OAuth metadata. A non-empty value is stored as sent. When omitted or empty, the stored value is kept unless auth_mode or card_url changes, in which case it is cleared.

allow_insecure_oauth_http
boolean | null

Toggle non-loopback HTTP OAuth discovery for this agent. Omit to leave unchanged.

allow_insecure_tls_skip_verify
boolean | null

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.

request_id
string
required

Unique ID for this request. Mirrored in the Flashcat-Request-Id header. Include it when reporting issues.

Example:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

error
object

Error payload inside the response envelope. Present only on non-2xx responses.

data
null

Not returned on success; the body carries only request_id.