User Guide
API DOCSVOICE GATEWAYHELPSECURITY
Current Version
Current Version
  • Welcome
  • What's New
  • 🚀GETTING STARTED
    • Login
    • Concepts and Glossary
    • Language Models
      • Syntphony NLP
      • Other NLP and LLM Connectors
      • FAQs
    • Build a Virtual Agent
      • Overview
      • From Scratch
      • By Importing
      • Pre-Built Templates
      • Training task
    • Testing
      • Automated Test
      • Advanced Request
      • Simulate Dialog
      • View Logs
    • Create and manage profiles
  • 💬BUILD DIALOGS
    • Flows
    • Dialog Cells
      • Intent
      • Entity
      • Answer
      • Input
      • Jump
      • End
      • Service
      • Rest Connector
      • Code
      • Rule
        • Variable answers using Code and Rule cells
        • Enable and disable flows using Rule Cells
    • Data Masking of Personal Identificable Information
    • Dynamic Content and Contexts
    • Voice Agent
    • Multilingual Agent (beta)
  • ✨GENERATIVE AI
    • AI features
    • Assist Answer (beta)
    • Examples Generator
    • Knowledge AI
    • Prompt cell
      • Prompt crafting
      • Practical examples
    • Rephrase Answer
    • Zero-Shot LLM
  • 🌐CHANNELS
    • Channels
      • WhatsApp (by Infobip)
      • Facebook Messenger
      • Microsoft Teams
      • Integrating Existing Channels
    • Webchat Plugin
  • ⚙️CONFIGURATIONS
    • Parameters
    • Advanced Resources
    • Other Options
      • Intent Navigator
  • 📊ANALYTICS & INSIGHTS
    • Dashboards
      • Overview
      • Funnel charts
      • User messages
      • Conversations
      • Reports
    • External Analytics Platforms
  • API DOCS
    • Overview
    • API Guidelines
      • Conversation API
      • Cloner API
      • EVG Connector
      • Management API
        • Admin API
          • Bot Admin
          • Environment
          • Organization
          • User
          • Notification
        • Instance API
          • Knowledge AI
          • Knowledge AI NLP
          • Answer
          • Automated Tests
          • Bot
          • Broker
          • Channel
          • Dashboard
          • Dialog Manager
          • Entity
          • Generative Service
          • Intent
          • Parameters
          • Tag
          • Technical Log
          • Training
          • Transactional Service
          • Rest Connector
          • Wait Input
          • Websnippet
      • Webhooks
    • Infrastructure Guidelines
      • Syntphony CAI server Installation guide
      • Maintenance Methods
      • Supported/verified third-party software
    • Data Structure
      • Admin Data Structure
      • Environment Data Structure
    • Voice Gateway
      • Genesys Cloud CX
Powered by GitBook
On this page
  • Remove and Restore methods
  • Organizations
  • Environments
  • Instances

Was this helpful?

  1. API DOCS
  2. Infrastructure Guidelines

Maintenance Methods

Eva-server installations will find the need for some managing methods. Those are listed below.

In distinction to eva-cloud, several maintenance operations may be performed by yourself. The following methods are all handy quality of life methods provided to ease the managing of your Syntphony CAI environments.

Those are internal, unlisted methods in our API which are not meant to be implemented into your system, but rather, to be used sporadically to perform specific tasks.

All methods listed below are internal methods. This imples that they are permanently locked out of external access, regardless of your configurations. In order to perform any of the methods listed below, you are expected to connect to the specified Syntphony CAI's service or pod through a localhost. Your port forward localhost IP will be referred to as 'IP_PF' in this document.

Remove and Restore methods

The following methods allow you to remove organizations, environments, and even full instances you own. None will affect your pricings, as those deletions are logical deletes, which can be reactivated.

When removing an environment, you must also clear all settings from that environment in your config server and update the scope of all active microservices. This may be performed, for instance, with a short reboot.

As with removal, the Restore methods require you to reconfigure your config server in order to have the environment settings.

While you technically could just keep the config servers between removal and restore, we strongly recommend you to perform full clears. Incomplete setups on restore may leave some fields behind that are unwanted or wrong, causing errors. The recommended practice is to re-do the whole proccess, always double checking your configurations.

Organizations

Port forward to: eva-organization

Organizations cannot be removed if there is any active environment within it.

DELETE (Remove)
http://{IP_PF}/internal/organizations/{orgUUID}?userUUID={userUUID}

PUT (Restore)
http://{IP_PF}/internal/organizations/{orgUUID}/restore?userUUID={userUUID}

These endpoints will receive the following parameters:

· orgUUID: an id of an organization validates to be removed or restored

· userUUID valid user id for audit fields

Some errors may occur when accessing the endpoint:

· 404: when the environment or organization does not exist

· 400: when try remove a organization with active environments

· 500: internal errors

Environments

Port forward to: eva-environment

DELETE (Remove)
http://{IP_PF}/internal/org/{orgUUID}/environments/{envUUID}?userUUID={userUUID}

PUT (Restore)
http://{IP_PF}/internal/org/{orgUUID}/environments/{envUUID}/restore?userUUID={userUUID} 

These endpoints will receive the following parameters:

· orgUUID: an id of an organization validates

· envUUID: environment id to be removed or restored

· userUUID valid user id for audit fields

Some errors may occur when accessing the endpoint:

· 404: when the environment or organization does not exist

· 500: internal errors

Instances

Port forward to: eva-environment

DELETE (Remove)
http://{IP_PF}/internal/instances/{instanceUUID}?userUUID={userUUID}

PUT (Restore)
http://{IP_PF}/internal/instances/{instanceUUID}/restore?userUUID={userUUID}

These endpoints will receive the following parameters:

· instanceUUID: instance id to be removed or restored

· userUUID valid user id for audit fields

Some errors may occur when accessing the endpoint:

· 404: when the environment or organization does not exist

· 400 when try remove an instance with active environments

· 500: internal errors

PreviousSyntphony CAI server Installation guideNextSupported/verified third-party software

Last updated 8 months ago

Was this helpful?