openapi: 3.0.3
info:
  title: 'Pixel House API Documentation'
  description: ''
  version: 1.0.0
servers:
  -
    url: 'https://partners.pixelhouse.com.au'
tags:
  -
    name: Endpoints
    description: ''
components:
  securitySchemes:
    default:
      type: http
      scheme: bearer
      description: '<h2>Important Authentication Information</h2><p>All API requests must include the <code>X-Api-Key</code> header with your assigned Partner API key.</p><p>For authenticated user requests, first authenticate using the authentication endpoint. Once authenticated, include both:</p><ul><li>The token returned by the authentication endpoint: <code>Authorization: Bearer &lt;token&gt;</code></li><li>The <code>X-Api-Key</code> header</li></ul><p>This ensures secure access to the API and proper authentication for user-specific requests.</p>'
security:
  -
    default: []
paths:
  /api/v1/healthcheck:
    get:
      summary: ''
      operationId: getApiV1Healthcheck
      description: ''
      parameters:
        -
          in: header
          name: X-Api-Key
          description: ''
          example: your-api-key
          schema:
            type: string
      responses:
        200:
          description: ''
          content:
            application/json:
              schema:
                type: object
                example:
                  status: up
                properties:
                  status:
                    type: string
                    example: up
      tags:
        - Endpoints
      security: []
  /api/v1/users/auth:
    post:
      summary: 'Authenticate with User'
      operationId: authenticateWithUser
      description: 'Authenticate with the user and get a token to use in future requests'
      parameters:
        -
          in: header
          name: X-Api-Key
          description: ''
          example: your-api-key
          schema:
            type: string
      responses:
        200:
          description: ''
          content:
            application/json:
              schema:
                type: object
                example:
                  data:
                    token: 'encrypted string'
                properties:
                  data:
                    type: object
                    properties:
                      token:
                        type: string
                        example: 'encrypted string'
        404:
          description: ''
          content:
            application/json:
              schema:
                type: object
                example:
                  message: 'User not found'
                properties:
                  message:
                    type: string
                    example: 'User not found'
      tags:
        - Endpoints
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                user_id:
                  type: string
                  description: 'The User ID from your system'
                  example: 1
                  nullable: false
                email:
                  type: string
                  description: 'The email of the user'
                  example: test@example.com
                  nullable: false
      security: []
  /api/v1/prospects/magic-link:
    post:
      summary: 'Magic Links'
      operationId: magicLinks
      description: 'This endpoint lets you generate a magic link to redirect your user to create a prospect against a property'
      parameters:
        -
          in: header
          name: X-Api-Key
          description: ''
          example: your-api-key
          schema:
            type: string
      responses:
        200:
          description: ''
          content:
            application/json:
              schema:
                type: object
                example:
                  data:
                    magic_link: string
                properties:
                  data:
                    type: object
                    properties:
                      magic_link:
                        type: string
                        example: string
      tags:
        - Endpoints
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                type:
                  type: enum
                  description: ''
                  example: price_update
                  nullable: false
                  enum:
                    - introduction
                    - proposal
                    - price_update
                property_id:
                  type: string
                  description: 'The ID of the property (from your system) to create a prospect against'
                  example: 123
                  nullable: false
              required:
                - type
                - property_id