Soul Machines Interactions API

Setup

Wiring the Soul Machines Interactions API by hand means passing its x-api-key header on every call, pointing at the interactions-api.soulmachines.cloud host, and handling retries across its generator and trigger endpoints yourself. Through Jentic you install once, import the Soul Machines Interactions API from the API Directory, store the API key once, and your agent calls it.

Permission scoping

The Soul Machines Interactions API carries its targets in the request body and header rather than resource ids in the URL path, so limit the agent to the operations it needs, such as creating a generator interaction or listing people. You choose the operations it may call, so state-changing ones like subscribing or unsubscribing triggers are not included unless you add them.

Credential isolation

Your Soul Machines API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'create a generator interaction' or 'list available tones', and Jentic returns the matching Soul Machines Interactions API operation with its input schema so the agent calls the right endpoint without browsing the reference docs.