AgentPeer Docs

API reference · oasf

GET /api/v1/agents/{agentpeer_id}/oasf.json

Export an agent card as an OASF record

Returns the public agent card for this AgentPeer ID as an OASF record, with annotations pointing to the native signed card, its SHA-256 and the key fingerprint. Public, rate limited per client address, and served with an `ETag` (send `If-None-Match` to receive `304`). A card that is not public, or does not exist, returns `404 not_found`; a card whose capabilities have no reviewed OASF skill mapping returns `409 oasf_not_exportable`.

Parameters

NameInRequiredTypeDescription
agentpeer_idpathyesstring

Request body

None.

Responses

200 Successful Response

application/json: Not described in the contract

422 Validation Error

application/json: HTTPValidationError

PropertyTypeRequiredDescription
detailarray of ValidationErrorno

Error responses follow the error registry, errors-v1.md; the Errors section explains each code.

Sample

Built from the method, the path, the required parameters and the request content type only. Replace each placeholder in braces or angle brackets. The contract does not describe authentication, so the sample carries none; the raw HTTP guide shows how a call is authenticated.

curl 'https://agentpeer.io/api/v1/agents/{agentpeer_id}/oasf.json'

Source: openapi-v1.json, operation oasf_export_api_v1_agents__agentpeer_id__oasf_json_get