Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
  • The public API is exposed as part of the BusinessGPT Firewall.

Table of Contents
stylenone

Getting API KEY

The API allows sending requests to AI service through HTTP requests.

Each user has a unique API key to authenticate the API. The API key is viewed on the User Settings page in the dashboard. You need to copy it and send in the request.

...

Chat service - POST request

POST: https://[firewall API address]/firewallApi/v1/chat

Sample URL for BGD10 environment:
https://bgd10-firewall.agatdemo.com/firewallApi/v1/alivechat

Allows to send a prompt to the AI and receive a response based on some particular content or all company data

Input parameters - should be sent as JSON:

  • APIKey

  • PromptPromptScope

  • DataSource (private and public=both, public, private).

  • PrivateDataSource(Content, Collection, All)

  • PromptScopeId PrivateDataID(id of the content or the collection, not needed for All)

  • AIModel (optional. Default will be as for the user. Available values: GPT3_5, GPT4, WizardLM, GPT4o, GPT_4o_Mini)

  • ChatId (optional): If provided, the question will be added to the existing chat with an external chat ID that equals the provided value. If no chat exists, a new one will be created.

  • MaxWordsInAnswer (optional) - If provided it should limit the number of words in the answer. The min word limit is 5.

  • User (optional) - the user that has asked the question

  • ChatAIService (optional. Default will be BusinessGPTDashboard . Available values: ChatGPT, Gemini, BusinessGPTDashboard , MicrosoftCopilot , Cohere, Claude, SlackBot)

  • Context (Optional) - the context of the chat. For example, the name of the Slack channel or Word document that the prompt was used from.

  • ChatName (optional) - the name of the chat in the auditing

Output - for HTTP status OK (200):

...

In case of an error, it will return an error message.

...

How do you find the ID of the collection or content item for the “PromptScopeId” parameter?

To find the ID triple-click the line to get some system info:

...

For a document it is the contentID as in the image below

...

Upload service - POST request

POST: https://[firewall API address]/firewallApi/v1/upload

...

  • APIKey

  • FileName

  • FileContent - binary

  • ContentSourceName (optional)- The name of the client using the API (for example, File loader)

  • ContentSourceIP (optional)- The IP of the client using the API (for example the host of the File loader)

  • AllowedGroups -a comma-separated list of group names with file permissionAllowedEmail - a comma-separated list of words with file permission(optional)

  • AllowedEmails (optional)

  • Action (string, optional, default: "Add")
    The action to be performed on the file. Possible values include:

    • Add: Upload a new file (default action).

    • UpdatePermissions: Modify permissions for an existing file.

    • Rename: Change the name of an existing file.

    • Delete: Remove an existing file.

  • ContentId (string, required for UpdatePermissions, Rename, or Delete)

Output - for HTTP status OK (200):

...

In case of an error, it will return an error message.image-20240819-102430.pngImage Removed

...

Get classifications service - GET request

GET: https://[firewall API address]/firewallApi/v1/getClassifications

...

In case of an error, it will return an error message.

...

Healthcheck service - GET request

GET: https://[firewall API address]/firewallApi/v1/alive

Sample URL for BGD10 environment:
https://bgd10-firewall.agatdemo.com/firewallApi/v1/alive

...

Postman Samples for all APIs

Attached is the Postman collection with example requests.

...