API Integration

What you'll accomplish: Connect agents to REST, GraphQL, and SOAP APIs through integration skills.

REST APIs

Custom REST API skills follow this pattern:

  1. Define the skill with endpoints, auth, and schema
  2. Store credentials in the vault
  3. Install and assign to a competency

Example: Claims management system

# Store the API key
hoziron vault set CLAIMCENTER_API_KEY

# Install the integration
hoziron catalog install guidewire-claimcenter

# Start the integration server
hoziron integration start guidewire-claimcenter

Quick setup

For common integrations, the add command handles install + credential storage:

hoziron add github --key ghp_...
hoziron add slack --key xoxb-...
hoziron add notion --key ntn_...

GraphQL APIs

GraphQL integrations work identically — the integration server handles query construction:

hoziron catalog install graphql-connector
hoziron vault set GRAPHQL_ENDPOINT
hoziron vault set GRAPHQL_AUTH_TOKEN
hoziron integration start graphql-connector

Legacy SOAP services

For legacy systems using SOAP/XML:

hoziron catalog install soap-connector
hoziron vault set SOAP_ENDPOINT_URL
hoziron vault set SOAP_USERNAME
hoziron vault set SOAP_PASSWORD
hoziron integration start soap-connector

The SOAP connector translates between the agent's JSON tool interface and SOAP XML envelopes.

Installing from custom sources

# From a local directory
hoziron skill install ./my-custom-integration/

# From a Git URL
hoziron skill install https://github.com/company/hoziron-salesforce-skill.git

Testing API integrations

# Verify connectivity
hoziron integration status guidewire-claimcenter

# Send a test message through the agent
hoziron message claims-agent "List the 5 most recent open claims"

Next steps

Related: