Jump to

• Request
• Response

Search agents

post

<servername>/api/fusion-ai/orchestrator/a2a/v1/agents/search

Search published workflows exposed by the A2A registry. Supports optional pagination through `skip` and `top`.

Request

There are no request parameters for this operation.

Supported Media Types

• application/json

Request Body - application/json ()

Root Schema : schema

Type: object

Show Source

• query: string
  Optional search text used to match published workflow names. If omitted or blank, all published workflows are returned.
• skip: integer
  Optional number of results to skip before returning records.
• top: integer
  Optional maximum number of results to return.

{
    "type":"object",
    "properties":{
        "query":{
            "type":"string",
            "description":"Optional search text used to match published workflow names. If omitted or blank, all published workflows are returned."
        },
        "skip":{
            "type":"integer",
            "description":"Optional number of results to skip before returning records."
        },
        "top":{
            "type":"integer",
            "description":"Optional maximum number of results to return."
        }
    }
}

Back to Top

Response

Supported Media Types

• application/json

200 Response

Search results retrieved.

Body ()

Root Schema : AgentRegistryResponse

Type: object

Show Source

• registry_version: string
  Registry response version.
• resources: array resources
  List of published agent registry entries.
• total_count: integer
  Total number of resources returned.

{
    "type":"object",
    "properties":{
        "registry_version":{
            "type":"string",
            "description":"Registry response version."
        },
        "resources":{
            "type":"array",
            "description":"List of published agent registry entries.",
            "items":{
                "$ref":"#/components/schemas/AgentRegistryEntry"
            }
        },
        "total_count":{
            "type":"integer",
            "description":"Total number of resources returned."
        }
    }
}

Nested Schema : resources

Type: array

List of published agent registry entries.

Show Source

• Array of: object AgentRegistryEntry

{
    "type":"array",
    "description":"List of published agent registry entries.",
    "items":{
        "$ref":"#/components/schemas/AgentRegistryEntry"
    }
}

Nested Schema : AgentRegistryEntry

Type: object

Show Source

• id: string
  Workflow code exposed through the registry.
• location: object AgentLocation
• name: string
  Workflow display name.

{
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"Workflow code exposed through the registry."
        },
        "name":{
            "type":"string",
            "description":"Workflow display name."
        },
        "location":{
            "$ref":"#/components/schemas/AgentLocation"
        }
    }
}

Nested Schema : AgentLocation

Type: object

Show Source

• type: string
  Location type.

  Example: agent_card
• url: string
  Agent card URL.

{
    "type":"object",
    "properties":{
        "url":{
            "type":"string",
            "description":"Agent card URL."
        },
        "type":{
            "type":"string",
            "description":"Location type.",
            "example":"agent_card"
        }
    }
}

400 Response

Could not process the search request.

Body ()

Root Schema : ErrorResponse

Type: object

Show Source

• message: string
  Description of the error.
• status: string
  Short status code of the error.
• userDetails: string
  Instructions or hint for user to action upon.

{
    "type":"object",
    "properties":{
        "status":{
            "type":"string",
            "description":"Short status code of the error."
        },
        "message":{
            "type":"string",
            "description":"Description of the error."
        },
        "userDetails":{
            "type":"string",
            "description":"Instructions or hint for user to action upon."
        }
    }
}

Back to Top