vergefy

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.58.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

Then import the package:

import vergefy

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

Tests

Execute pytest to run the tests.

Getting Started

Please follow the installation procedure and then run the following:

import vergefy
from vergefy.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.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.Configuration(
    access_token = os.environ["BEARER_TOKEN"]
)


# Enter a context with an instance of the API client
async with vergefy.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = vergefy.AIAICHChatApi(api_client)
    x_app_account_id = UUID('550e8400-e29b-41d4-a716-446655440000') # UUID | The account the call acts as, among those the signed-in user holds (a UUID).
    conversation_create_dto = vergefy.ConversationCreateDTO() # ConversationCreateDTO | 
    accept_language = 'en' # str | The language of messages: the first of English or Turkish in the list. A list naming neither, or none, gives English. (optional) (default to 'en')
    vergefy_version = '2026-05-30' # str | The date-based API version (`YYYY-MM-DD`). Omitted, the tenant's pinned version or the latest is used; an unknown value is a 400 problem+json. Every response states the version it was answered in. The deprecated `accept-version` alias is still read. (optional) (default to '2026-05-30')
    accept_timezone = 'UTC' # str | The IANA time zone dates are resolved and shown in, such as `Europe/Istanbul`. Default `UTC`. (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