Skip to main content
POST
List A2A agents

Restrictions

Usage

  • Pagination uses offset/limit (not p/limit).
  • scope=account restricts to account-scoped agents; scope=team restricts to the caller’s visible teams; the default all combines both, subject to include_account.
  • query performs a case-insensitive substring search across agent name, instructions, card URL, agent ID, and the resolved card name.
  • card_resolve_timeout and task_timeout are always 0 today — the API does not yet expose a way to set them.

Authorizations

app_key
string
query
required

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

application/json

Pagination, scope, and search filter for listing A2A agents.

offset
integer
default:0

Row offset for pagination.

limit
integer
default:20

Page size.

scope
enum<string>
default:all

Visibility scope: all (account-scope plus the caller's visible teams), account (account-scope only), or team (team-scoped rows across the caller's visible teams).

Available options:
all,
account,
team
query
string

Case-insensitive substring search across agent name, instructions, card URL, agent ID, and the resolved card name.

Maximum string length: 128
team_ids
integer<int64>[]

Filter to these team IDs; empty = the caller's visible set.

include_account
boolean | null

Include account-scoped (team_id=0) rows. Defaults to true.

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
object

Paginated A2A agent list.