API Connectors in Brightsy AI are integrations with external APIs and services registered using OpenAPI 3.0+ specifications. This guide will help you navigate and use the form to create or update API connectors within the Brightsy platform.
Accessing the Form
To access the form, navigate to the "API Connectors" section of your account dashboard. You can either create a new API connector or edit an existing one.
Form Overview
The form is designed to capture essential details about your API connector, including its name, description, status, and OpenAPI definition.
API Connector Properties
| Property | Type | Description | Required | Constraints |
|---|---|---|---|---|
| id | string | Unique identifier for the API connector | Auto-generated | Read-only |
| name | string | Name of the API connector | Yes | 2-50 characters |
| description | string | Description of the API connector's purpose | Yes | Max 5000 characters |
| status | enum | Current state of the API connector | Yes | Values: "disabled", "enabled" |
| openApiDefinition | object | OpenAPI 3.0+ definition in JSON format | Yes | Valid OpenAPI 3.0+ schema |
| createdAt | datetime | When the API connector was created | Auto-generated | Read-only |
| updatedAt | datetime | When the API connector was last updated | Auto-generated | Read-only |
Form Fields
Name
- Purpose: Enter the name of your API connector.
- Requirements: The name must be between 2 and 50 characters long.
Description
- Purpose: Provide a brief description of your API connector's purpose.
- Requirements: The description can be up to 5000 characters long.
Status
- Purpose: Set the current state of your API connector.
- Options:
- Disabled: The application is not active.
- Enabled: The application is active and operational.
OpenAPI 3.0+ Definition
- Purpose: Upload a JSON file containing the OpenAPI 3.0+ definition for your application.