List A2A agents
Newest first. Sorts by created_at, updated_at, last_used_at and name; q searches names, addresses and descriptions. Filters, each repeatable: health as people see it (healthy, unhealthy, revoked, pending, paused, card_changed), auth_type, status, created_by, updated_by.
Query parameters
workspace_idstringhealthstring[]auth_typestring[]statusstring[]created_bystring[]updated_bystring[]limitintegerRows per page, 1 to 200.
Default50at least 1at most 200cursorstringqstringSearch: rows whose name (or the list's other searchable text) contains this, any case.
at most 200 charactersorderstringSort field; a leading
-sorts down. Each list names the fields it sorts by.at most 64 charactersmatches ^-?[a-z_]+$includestring[]total_count(counted up to 10,000) andfacets(a count per filter value).One oftotal_countfacetscreated_afterstringOnly rows created at or after this time (RFC 3339).
date-timecreated_beforestringOnly rows created at or before this time (RFC 3339).
date-timeupdated_afterstringOnly rows last changed at or after this time (RFC 3339).
date-timeupdated_beforestringOnly rows last changed at or before this time (RFC 3339).
date-time
Response200
objectstringlistdataA2aAgent[]36 fields
idstringobjectstringa2a_agentauth_typestringOne ofnonebearerheadersauto_accept_changesbooleancall_timeout_sintegercalls_totalintegercardA2aCardSummary or nullAn Agent Card as we read it (either protocol version).
15 fields
authobject[]descriptionstringdocumentation_urlstring or nullendpoint_urlstring or nullicon_urlstring or nullinput_modesstring[]interfacesA2aInterface[]3 fields
bindingstringurlstringversionstring
namestringoutput_modesstring[]protocol_versionstring or nullOne of1.00.3providermap<string, string>push_notificationsbooleanskillsA2aSkill[]7 fields
idstringdescriptionstringexamplesstring[]namestringtagsstring[]input_modesstring[]output_modesstring[]
streamingbooleanversionstring
card_changed_atstring or nullcard_pendingA2aCardSummary or nullAn Agent Card as we read it (either protocol version).
15 fields
authobject[]descriptionstringdocumentation_urlstring or nullendpoint_urlstring or nullicon_urlstring or nullinput_modesstring[]interfacesA2aInterface[]3 fields
bindingstringurlstringversionstring
namestringoutput_modesstring[]protocol_versionstring or nullOne of1.00.3providermap<string, string>push_notificationsbooleanskillsA2aSkill[]7 fields
idstringdescriptionstringexamplesstring[]namestringtagsstring[]input_modesstring[]output_modesstring[]
streamingbooleanversionstring
card_pending_rawobject or nullAny JSON object.
card_rawobject or nullAny JSON object.
card_urlstringcheck_errorstring or nullcreated_atstring or nulldata_classstringOne ofpublicinternalpiisensitivephidescriptionstring or nullendpoint_urlstring or nullerrors_totalintegerheader_namesstring[]healthstringhealth_reasonstring or nullhealth_shownstringinstructionsstring or nulllast_checked_atstring or nulllast_used_atstring or nullmax_output_bytesintegernamestringprotocol_versionstring or nullOne of1.00.3row_versionintegerside_effectsstringOne ofreadwritedestructivestatusstringOne ofpendingactivedisabledupdated_atstring or nullusablebooleanworkspace_idstringcreated_byActorRef or nullWho created or last changed something, resolved to a name for display.
system,workload(an automation) andend_user(a widget visitor) have no ID or name: the console words them.nameis null for someone the directory no longer knows.idis what the lists'created_by/updated_byfilters take.avatar_versionis set for a person with a photo: it is atGET /v1/members/{id}/avatar?v=<avatar_version>while they are a member.5 fields
idstring or nullkindstringOne ofuserapi_keyservice_accountworkloadend_usersystemnamestring or nullavatar_versionstring or nullemailstring or null
updated_byActorRef or nullWho created or last changed something, resolved to a name for display.
system,workload(an automation) andend_user(a widget visitor) have no ID or name: the console words them.nameis null for someone the directory no longer knows.idis what the lists'created_by/updated_byfilters take.avatar_versionis set for a person with a photo: it is atGET /v1/members/{id}/avatar?v=<avatar_version>while they are a member.5 fields
idstring or nullkindstringOne ofuserapi_keyservice_accountworkloadend_usersystemnamestring or nullavatar_versionstring or nullemailstring or null
has_morebooleannext_cursorstring or nullfacetsmap<string, map<string, integer>> or nullpeoplemap<string, ActorRef> or null5 fields
idstring or nullkindstringOne ofuserapi_keyservice_accountworkloadend_usersystemnamestring or nullavatar_versionstring or nullemailstring or null
total_countinteger or nulltotal_count_exactboolean or null
Status codes
- 200Successful Response
- 422The request is not valid:
errors[]names each field. - 4XXThe request was refused: the problem says why.
- 5XXThe API could not answer: the problem says why.
curl "https://api.mydeepagents.com/v1/a2a/agents?limit=20" \
-H "Authorization: Bearer $MDA_API_KEY"{
"object": "list",
"data": [
{
"id": "oag_01jc1pxfe3k6x8qt1wve5305pn",
"object": "a2a_agent",
"auth_type": "none",
"auto_accept_changes": true,
"call_timeout_s": 60,
"calls_total": 2,
"card": {
"auth": [
{}
],
"description": "Reads new support email and drafts a reply.",
"documentation_url": "https://example.com",
"endpoint_url": "https://example.com",
"icon_url": "https://example.com",
"input_modes": [
"input mode"
],
"interfaces": [
{}
],
"name": "Support triage",
"output_modes": [
"output mode"
],
"protocol_version": "1.0",
"provider": {
"key": "key"
},
"push_notifications": true,
"skills": [
{}
],
"streaming": true,
"version": "version"
},
"card_changed_at": "2026-11-10T09:30:00.000Z",
"card_pending": {
"auth": [
{}
],
"description": "Reads new support email and drafts a reply.",
"documentation_url": "https://example.com",
"endpoint_url": "https://example.com",
"icon_url": "https://example.com",
"input_modes": [
"input mode"
],
"interfaces": [
{}
],
"name": "Support triage",
"output_modes": [
"output mode"
],
"protocol_version": "1.0",
"provider": {
"key": "key"
},
"push_notifications": true,
"skills": [
{}
],
"streaming": true,
"version": "version"
},
"card_pending_raw": {},
"card_raw": {},
"card_url": "https://example.com",
"check_error": null,
"created_at": "2026-11-10T09:30:00.000Z",
"created_by": {
"kind": "user",
"id": "usr_01jcf1j9wjxfrnhqda3mq7ejxn",
"name": "Ada Lovelace",
"email": "ada@example.com"
},
"data_class": "public",
"description": "Reads new support email and drafts a reply.",
"endpoint_url": "https://example.com",
"errors_total": 2,
"header_names": [
"X-Api-Key"
],
"health": "health",
"health_reason": null,
"health_shown": "health shown",
"instructions": "instructions",
"last_checked_at": "2026-11-10T09:30:00.000Z",
"last_used_at": "2026-11-10T09:30:00.000Z",
"max_output_bytes": 1048576,
"name": "Support triage",
"protocol_version": "1.0",
"row_version": 4,
"side_effects": "read",
"status": "pending",
"updated_at": "2026-11-10T09:30:00.000Z",
"updated_by": {
"kind": "user",
"id": "usr_01jcf1j9wjxfrnhqda3mq7ejxn",
"name": "Ada Lovelace",
"email": "ada@example.com"
},
"usable": true,
"workspace_id": "ws_01jccj30nr8ad7mx1yc5v9zx3h"
}
],
"has_more": false,
"next_cursor": null,
"total_count": 1
}