vergefy-client

AI Agent Management

Create, configure, and orchestrate AI agents with multi-provider support.

Modules

• Agent (IAG): Agent creation, configuration, lifecycle, insight and analytics (IAG001-057, IAG500-505, IAG700-701)
• Template (IAT): Agent template management — /ai/agents-templates
• Template Advanced (IATEMP): Versions, analytics, recommendations, diffs — /ai/agents-templates (IATEMP001-008)
• Agent Upgrade (IAGENT): Upgrade, rollback, version management — /ai/agents/{id}/upgrade|rollback (IAGENT001-005)
• Hierarchy (IAH): Supervisor-worker relationships, delegation — /ai/agents/hierarchies
• Goal (IAGG): Autonomous goals, success criteria — /ai/agents/goals
• Pool (IAGP): Agent pool management, allocation, coordination (queries IAGP001-023, commands IAGP101-109) — /ai/agents/pools
• Execution (IAGE): Execution tracking, history — /ai/agents/executions
• Health (IAGH): Health checks, recovery — /ai/agents/health
• Communication (IAGC): Channels (IAGC001-019) and inter-agent messages (IAGC020-052) — /ai/agents/channels, /ai/agents/messages
• Handoff (IAGD): Agent handoff and transfer — /ai/agents/handoffs
• Orchestration (IAGO): Orchestration sessions — /ai/agents/orchestration/sessions
• Workflow (IAGW): Workflow assignment and execution — /ai/agents-workflows
• Capability (IACAP): Capability definitions, permissions (queries IACAP001-011, commands IACAP101-105) — /ai/capabilities
• Capability Mapping (IACF): Capability to feature mapping — /ai/agents/capability-feature-mappings

Providers: OpenAI GPT-4, Anthropic Claude, Google Gemini

This Python package is automatically generated by the OpenAPI Generator project:

• API version: 2026-05-30
• Package version: 0.12.0
• Generator version: 7.22.0
• Build package: org.openapitools.codegen.languages.PythonClientCodegen For more information, please visit https://integrahub.co

Requirements.

Python 3.10+

Installation & Usage

pip install

pip install vergefy_client

Then import the package:

import vergefy_client

Setuptools

Install via Setuptools.

python setup.py install --user

(or sudo python setup.py install to install the package for all users)

Then import the package:

import vergefy_client

Tests

Execute pytest to run the tests.

Getting Started

Please follow the installation procedure and then run the following:

import vergefy_client
from vergefy_client.rest import ApiException
from pprint import pprint

# Defining the host is optional and defaults to https://your-vergefy-host.invalid
# See configuration.py for a list of all supported configuration parameters.
configuration = vergefy_client.Configuration(
    host = "https://your-vergefy-host.invalid"
)

# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.

# Configure Bearer authorization (JWT): BearerAuth
configuration = vergefy_client.Configuration(
    access_token = os.environ["BEARER_TOKEN"]
)


# Enter a context with an instance of the API client
async with vergefy_client.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = vergefy_client.AIAICHChatApi(api_client)
    x_app_account_id = UUID('550e8400-e29b-41d4-a716-446655440000') # UUID | Required Account Id for transaction context
    conversation_create_dto = vergefy_client.ConversationCreateDTO() # ConversationCreateDTO | 
    accept_language = 'en' # str | Language for translatable content. Default: en (optional) (default to 'en')
    vergefy_version = '2026-05-30' # str | Date-based API version (YYYY-MM-DD). Omit to receive the latest version; an unknown value is rejected with 400 application/problem+json. See ADR-2026-05-30. (optional) (default to '2026-05-30')
    accept_timezone = 'UTC' # str | Timezone for date/time resolution (optional) (default to 'UTC')

    try:
        # AICH001 - Create Conversation
        api_response = await api_instance.a_ich001(x_app_account_id, conversation_create_dto, accept_language=accept_language, vergefy_version=vergefy_version, accept_timezone=accept_timezone)
        print("The response of AIAICHChatApi->a_ich001:\n")
        pprint(api_response)
    except ApiException as e:
        print("Exception when calling AIAICHChatApi->a_ich001: %s\n" % e)

API Reference

The full endpoint and model reference is generated from the Vergefy OpenAPI contract. Contact support@integrahub.co to obtain it.

Documentation For Authorization

Authentication schemes defined for the API:

BearerAuth

• Type: Bearer authentication (JWT)

Author

support@integrahub.co