Get an installed Agent's public A2A v1 Agent Card

curl --request GET \
  --url https://api.checkfu.com/a2a/v1/workspaces/{workspace}/agent-installations/{installation}/surface-scopes/{surface}/agent-card.json

import requests

url = "https://api.checkfu.com/a2a/v1/workspaces/{workspace}/agent-installations/{installation}/surface-scopes/{surface}/agent-card.json"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.checkfu.com/a2a/v1/workspaces/{workspace}/agent-installations/{installation}/surface-scopes/{surface}/agent-card.json', 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.checkfu.com/a2a/v1/workspaces/{workspace}/agent-installations/{installation}/surface-scopes/{surface}/agent-card.json",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.checkfu.com/a2a/v1/workspaces/{workspace}/agent-installations/{installation}/surface-scopes/{surface}/agent-card.json"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.checkfu.com/a2a/v1/workspaces/{workspace}/agent-installations/{installation}/surface-scopes/{surface}/agent-card.json")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "name": "<string>",
  "description": "<string>",
  "supportedInterfaces": [],
  "version": "<string>",
  "capabilities": {
    "streaming": true,
    "pushNotifications": true,
    "extensions": [
      {
        "uri": "<string>",
        "description": "<string>",
        "required": true,
        "params": {}
      }
    ],
    "extendedAgentCard": true
  },
  "defaultInputModes": [
    "<string>"
  ],
  "defaultOutputModes": [
    "<string>"
  ],
  "skills": [],
  "provider": {
    "url": "<string>",
    "organization": "<string>"
  },
  "documentationUrl": "<string>",
  "securitySchemes": {},
  "securityRequirements": [
    {
      "schemes": {}
    }
  ],
  "signatures": [
    {
      "protected": "<string>",
      "signature": "<string>",
      "header": {}
    }
  ],
  "iconUrl": "<string>"
}

{
  "error": {
    "type": "validation.not_found",
    "message": "<string>",
    "more": "https://docs.checkfu.com/reference/errors#validation-not-found"
  }
}

{
  "error": {
    "type": "runtime.internal",
    "message": "<string>",
    "more": "https://docs.checkfu.com/reference/errors#runtime-internal"
  }
}

Get an installed Agent's public A2A v1 Agent Card

Projects the active AgentInstallation, SurfaceScope, exact published AgentRelease, and active Skills into an A2A v1 Agent Card. The card is public and cacheable; invoking or observing tasks still requires an audience-bound Principal credential and live PermissionAssignments.

Checkfu support posture: preview; hosted. Required evidence journey: a2a-serve. Deployment-specific readiness and the latest proven release are available from GET /v1/support/capabilities.

GET

a2a

workspaces

{workspace}

agent-installations

{installation}

surface-scopes

{surface}

agent-card.json

Get an installed Agent's public A2A v1 Agent Card

curl --request GET \
  --url https://api.checkfu.com/a2a/v1/workspaces/{workspace}/agent-installations/{installation}/surface-scopes/{surface}/agent-card.json

import requests

url = "https://api.checkfu.com/a2a/v1/workspaces/{workspace}/agent-installations/{installation}/surface-scopes/{surface}/agent-card.json"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.checkfu.com/a2a/v1/workspaces/{workspace}/agent-installations/{installation}/surface-scopes/{surface}/agent-card.json', 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.checkfu.com/a2a/v1/workspaces/{workspace}/agent-installations/{installation}/surface-scopes/{surface}/agent-card.json",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.checkfu.com/a2a/v1/workspaces/{workspace}/agent-installations/{installation}/surface-scopes/{surface}/agent-card.json"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.checkfu.com/a2a/v1/workspaces/{workspace}/agent-installations/{installation}/surface-scopes/{surface}/agent-card.json")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "name": "<string>",
  "description": "<string>",
  "supportedInterfaces": [],
  "version": "<string>",
  "capabilities": {
    "streaming": true,
    "pushNotifications": true,
    "extensions": [
      {
        "uri": "<string>",
        "description": "<string>",
        "required": true,
        "params": {}
      }
    ],
    "extendedAgentCard": true
  },
  "defaultInputModes": [
    "<string>"
  ],
  "defaultOutputModes": [
    "<string>"
  ],
  "skills": [],
  "provider": {
    "url": "<string>",
    "organization": "<string>"
  },
  "documentationUrl": "<string>",
  "securitySchemes": {},
  "securityRequirements": [
    {
      "schemes": {}
    }
  ],
  "signatures": [
    {
      "protected": "<string>",
      "signature": "<string>",
      "header": {}
    }
  ],
  "iconUrl": "<string>"
}

{
  "error": {
    "type": "validation.not_found",
    "message": "<string>",
    "more": "https://docs.checkfu.com/reference/errors#validation-not-found"
  }
}

{
  "error": {
    "type": "runtime.internal",
    "message": "<string>",
    "more": "https://docs.checkfu.com/reference/errors#runtime-internal"
  }
}

Path Parameters

workspace

string

required

Pattern: ^wrkspc_[0-9a-f]{32}$

installation

string

required

Pattern: ^aini_[0-9a-f]{32}$

surface

string

required

Pattern: ^surf_[0-9a-f]{32}$

Response

A2A v1 Agent Card

name

string

required

Required string length: 1 - 1024

description

string

required

Required string length: 1 - 16384

supportedInterfaces

tuple

required

version

string

required

Required string length: 1 - 1024

capabilities

object

required

Show child attributes

defaultInputModes

tuple

required

Show child attributes

defaultOutputModes

tuple

required

Show child attributes

skills

tuple

required

provider

object

Show child attributes

documentationUrl

string

Maximum string length: 2048

securitySchemes

object

Show child attributes

securityRequirements

object[]

Maximum array length: 32

Show child attributes

signatures

object[]

Maximum array length: 16

Show child attributes

iconUrl

string

Maximum string length: 2048

Developer tools

Canonical tables

Author protocols

Generated HTTP API

Get an installed Agent's public A2A v1 Agent Card

Path Parameters

Response