Embedding AI Agents
via Signed Access URLs
Last updated
via Signed Access URLs
Last updated
MindStudio allows you to embed your AI Agents seamlessly into your product or website, using signed access URLs—without requiring end users to sign up for a MindStudio account.
Signed access URLs provide secure access to a specific AI Agent for a specific user. These are particularly useful if you already manage your own user accounts and want to embed an agent without forcing additional authentication steps.
URLs expirations can be set (1 hour to infinite)
You can generate unlimited URLs
Old URLs do not expire when new ones are generated
Your backend requests a signed access URL from the MindStudio API.
You optionally include your internal user ID (for run history tracking).
MindStudio responds with a signed URL.
You serve this URL to your user—via redirect or iframe.
If a userId
is provided, run history for that user will be consistent across sessions. Otherwise, a new temporary user will be created each time.
Here’s how you can integrate it into your product:
User logs in to your app.
Frontend loads a secure route (e.g., /tools/my-agent
).
Frontend calls your backend, which:
Verifies the user’s session
Calls MindStudio’s generate-signed-access-url
endpoint
Your backend returns the URL to the frontend.
Frontend embeds the agent in an <iframe>
:
Or, you can redirect the user to the URL directly.
Always generate a new signed URL per session.
Never expose your API key in client-side code.
A Make.com account
Your MindStudio API key
Your Agent’s ID
A backend HTTP module or webhook trigger (to retrieve or forward the signed URL)
Optional: A source for the user ID (e.g., webhook, form, database)
Create a Scenario: Start with a Webhook trigger from your frontend
Add HTTP Module: Use the HTTP → Make a Request module.
Configure the HTTP POST:
URL: https://api.mindstudio.ai/developer/v2/generate-signed-access-url
Method: POST
Headers:
Authorization
Bearer YOUR_API_KEY
Content-Type: JSON (application/json)
Body Type: Raw
Request content:
Parse the Response: Yes
You'll need to extract the url
field from the API response.
Use the Signed URL in the frontend iframe code.
Zapier account
A MindStudio API key and Agent ID
Zapier Webhooks by Zapier (Premium trigger/action)
Optional: A source for the user ID (e.g., webhook, form, database)
Create a Zap: Start with a Webhook trigger from your frontend
Add Webhooks by Zapier – POST Request
URL: https://api.mindstudio.ai/developer/v2/generate-signed-access-url
Payload Type: JSON
Data:
agentId
YOUR_AGENT_ID
userId
user_id_from_trigger
Headers:
Authorization
Bearer YOUR_API_KEY
Content-Type
application/json
Extract the URL: Use the url
from the webhook response in subsequent steps.
Use the Signed URL in the frontend iframe code.
An active n8n instance
Your MindStudio API Key
The Agent ID you want to embed
Optional: A source for the user ID (e.g., webhook, form, database)
Start with a Webhook trigger from your frontend
Add an HTTP Request Node
HTTP Method: POST
URL: https://api.mindstudio.ai/developer/v2/generate-signed-access-url
Authentication: None (manual headers)
Headers:
Authorization
Bearer YOUR_API_KEY
Content-Type
application/json
Body Content Type: JSON
JSON Parameters: Enabled
Body Parameters:
You can replace {{$json.userId}}
with however you're passing in or storing user identifiers.
Extract the URL: After the HTTP node runs, you’ll get a response that includes a url
field.
Use the Signed URL in the frontend iframe code.