Build with agents

Give your AI agent the Core API knowledge and workflows it needs to prepare and execute authorized requests.

The Brella Core API skill helps an agent structure event data, choose the right endpoints and prepare correct requests. It includes agenda and speaker workflows, registrant imports, lead exports, meeting guidance and the API’s permission and update rules.

A skill is a folder of instructions and references in the Agent Skills format, following the same approach as Supabase’s agent skills. It does not require Supabase or a Brella MCP server.

Install the skill

Download the skill bundle, extract it, and add the brella-core-api folder through your agent’s supported skill installation workflow.

For a coding project, agents that discover .agents/skills can load it at:

.agents/skills/brella-core-api/SKILL.md

Keep the bundled references and assets folders beside SKILL.md. Installing only the entrypoint loses the detailed API references.

With the skills CLI, you can install from the public archive:

npx skills add https://docs.brella.io/downloads/brella-core-api-skill.zip

Review the downloaded instructions before installation. Follow your team’s normal third-party tooling policy when running the CLI. The archive is hosted on this public documentation site; customers do not need access to Brella’s internal GitHub repository.

You can read the skill entrypoint and inspect the download checksum. Replace the installed bundle when you want the latest documentation; an existing download does not update itself.

What an agent can do

Your environment	What this enables
Chat or an agent that can read documents	Structure source material, identify gaps, produce a reviewed plan and generate requests.
An agent with an authorized HTTPS tool or local runtime	Execute the approved requests using your Core token, inspect results and reconcile an import.
A ChatGPT setup with a separately configured API action	Potentially call the API through that action. The skill does not configure or verify an action for you.

ChatGPT and coding-agent skill support depends on the product and environment. See OpenAI’s skill documentation for supported installation locations, and GPT Actions for API connections. If your chat environment cannot load skills, attach the relevant Markdown guides and use the prompt below to prepare requests for a teammate to execute.

Start with a concrete task

Use the Brella Core API skill to help build our event agenda from these notes.
Extract a proposed session and speaker plan first. Flag missing times,
timezone, identities and track information. Show the exact changes and
side effects for review before executing anything that is not yet approved.
Use only documented Core API operations. Tell me whether your current
environment can execute authenticated HTTPS requests or only prepare them.

Follow the agenda import guide for the complete workflow and a downloadable planning template.

Connect safely

Ask your organization administrator for a Core API token restricted to the intended events, resources, actions and fields. Put it in your agent runtime’s secret store or local environment as BRELLA_API_ACCESS_TOKEN; set BRELLA_API_BASE_URL to the API origin supplied by Brella. Do not paste a token into a conversation or the public docs forms.

For writes, approve the concrete plan and expected effects. Review one sample and reconcile the result before processing the rest. The skill helps an agent follow these steps; the API enforces the token’s actual permissions.

Documentation for machines

Documentation index.
Markdown pages: append .md to a documentation path, for example /cookbook/build-event-agenda.md.
Agent skill discovery index, using the discovery proposal adopted by Supabase. Client support varies; the archive download is the direct installation path.

The Markdown exports include the same request examples and field definitions as the interactive pages.