openapi: 3.1.0
info:
  title: eSpatial Agent API
  description: API for AI agents to sign users up for an eSpatial free trial.
  version: 1.0.0
servers:
  - url: https://webapi.espatial.com
    description: eSpatial Web Application Server
paths:
  /endpoints/ai/rest/maps-server-sign-up.php:
    post:
      summary: Register a user for an eSpatial free trial.
      operationId: createFreeTrial
      description: Submits user details to trigger a free trial registration. Upon success, a confirmation email with a sign-in link is sent to the user.
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
                - email
                - company_name
                - first_name
                - last_name
              properties:
                email:
                  type: string
                  format: email
                  description: The user's valid email address.
                company_name:
                  type: string
                  description: The name of the user's company or organization.
                first_name:
                  type: string
                  description: The user's first name.
                last_name:
                  type: string
                  description: The user's last name.
      responses:
        '200':
          description: Trial successfully initiated. The agent should instruct the user to check their email.
        '400':
          description: Invalid input (e.g., missing required fields or malformed email).
        '500':
          description: Internal server error. The request could not be processed due to an unexpected condition.