Remy Reference/agent/runFromConnectorRegistry

runFromConnectorRegistry

Run a raw API connector to a third-party service

mindstudio.runFromConnectorRegistry({ actionId, displayName, icon, configurationValues }) → Result

Executes a named action from the connector registry, invoking the underlying third-party API on behalf of the current agent and returning the response payload as parsed JSON. Actions are addressed by a service/action identifier, such as elevenlabs/create-speech, along with an input object matching that action's expected parameters. Authentication and request formatting for the target service are handled using the workspace's configured connection, so you only need to supply the action-specific inputs.

Parameters

actionId

string

RequiredThe connector action identifier in the format serviceId/actionId

displayName

string

RequiredHuman-readable name of the connector action

icon

string

RequiredIcon URL for the connector

configurationValues

object

RequiredKey-value configuration parameters for the connector action

__connectionId

string

OAuth connection ID used to authenticate the connector request

Call from a method

import { mindstudio } from '@mindstudio-ai/agent';

const result = await mindstudio.runFromConnectorRegistry({
  actionId: /* ... */,
  displayName: /* ... */,
  icon: /* ... */,
  configurationValues: /* ... */
});