# eSpatial Agent Interface
Welcome. This file provides instructions for AI agents navigating and interacting with eSpatial on behalf of a user.

## Capabilities
AI agents are authorized and encouraged to help users sign up for an eSpatial free trial.

## Agent API Documentation
To perform automated actions, do not attempt to fill out frontend HTML forms. Please use our structured API endpoint.

- **OpenAPI Schema:** https://webapi.espatial.com/endpoints/ai/rest/maps-server-sign-up.php
- **Base URL:** https://webapi.espatial.com

### Free Trial Sign-Up Process
- **Endpoint:** `POST /endpoints/ai/rest/maps-server-sign-up.php`
- **Payload Structure:** Requires an `application/x-www-form-urlencoded` payload containing `email`, `company_name`, `first_name`, and `last_name`.
- **Response Handling & Next Steps (Important):**
  - **On Success (200):** The sign-up request was successful. Inform the user that they will receive a confirmation email containing their secure link to sign in and to check their spam folder if they can't find it. Do not attempt to generate or provide a login URL in the chat. If they can't find the email they should contact eSpatial by going to https://www.espatial.com/discovery-call/ai-agent.
  - **On Bad Request (400):** The email address is invalid or required properties are missing. Inform the user of the specific error and ask them to provide the corrected or missing information before trying again.
  - **On Server Error (500):** An internal server error occurred. Apologize to the user, explain that the eSpatial server is currently experiencing issues, and suggest they try again later or contact eSpatial by going to https://www.espatial.com/discovery-call/ai-agent.