Why do I get a 401 Unauthorized error?

Check if your AgentLLM key is valid and correctly passed in the Authorization header. You can regenerate the key under Test → LLM → Keys.

Why is the wrong version of my agent responding?

Check the 'model' string in your request. Make sure you're using the correct version tag like @dev, @prod, or @1.0.

What do I do if my request returns no output?

Confirm that your agent is correctly configured and LLM is toggled on. Then inspect logs under Deployments → Logs.

How do I find the correct baseURL and model string?

Go to Test → LLM → Code. Always copy the baseURL and model directly from there to avoid typos or environment mismatches.

Deploy as API

Quick Steps (TL;DR)

1. Open your agent → Deploy → API → Get Endpoints
2. Test your endpoints in Swagger
3. Share or import the OpenAPI URL

Why Deploy as an API?

Deploying as an API turns your agent into a live REST service. You can test it in Swagger, share it with teammates, and integrate it into other apps with standard HTTP calls. Ideal for connecting workflows, building automations, and verifying inputs and outputs quickly.

Prerequisites

Your agent is deployed

Step 1: Open the Deploy Panel

Open your agent in the canvas
Click Deploy at the top right
In Embed, select API and click Get Endpoints

Deploy panel showing API Get Endpoints option

This opens the API Endpoints window with live Swagger and your OpenAPI URL.

Step 2: Review the API Endpoints

You will see:

Dev API and optional Prod API URL fields
Live Swagger UI to try requests
An OpenAPI URL for imports

API Endpoints modal showing Swagger and OpenAPI URL

Dev vs Prod

Use Dev while building. Add Prod when your agent is stable and ready for wider use.

Step 3: Test Directly in SmythOS

Click Test on the top toolbar
Open the API tab in the right dock
Choose an operation → Try it out → fill fields → Execute

Testing API endpoints directly in SmythOS canvas

Testing is key

Testing here is the fastest way to validate requests and responses before any external integration.

Share the OpenAPI URL by copying the OpenAPI URL from API Endpoints so teammates can explore your API in their tools
Import into Postman or SwaggerHub for collaboration and documentation
Call the API from apps and automations using standard HTTP\
Use Dev while iterating and switch to Prod when ready to go live

What's Next?

Was this page helpful?

Why Deploy as an API?​

Prerequisites​

Step 1: Open the Deploy Panel​

Step 2: Review the API Endpoints​

Step 3: Test Directly in SmythOS​

Share and Integrate​

What's Next?​