AI Desk

Master Server Information

Hostname {{ master_hostname }}
IP Address {{ master_ip }}
Port {{ master_port }}
Start Time {{ master_start_time }}

API Documentation

Authentication

POST
/api/login

Authenticates a user and creates a session.

Parameters:

  • username - User username
  • password - User password
POST
/api/logout

Destroys the current user session.

File Operations

POST
/api/generate-file

Generates a file from provided content. Requires authentication.

Parameters:

  • filename - Name of the file to generate
  • content - Multi-line text content for the file
POST
/api/upload-file

Uploads a file. Requires authentication.

Parameters:

  • file - File data as multipart/form-data

Instance Management

POST
/api/instances/register

Registers another aidesk instance with this server. No authentication required.

Parameters:

  • hostname - Instance hostname
  • ip - Instance IP address
  • port - Instance port number
  • start_time - Instance start time (ISO format)
POST
/api/instances/ping

Updates instance status (heartbeat). No authentication required.

Parameters:

  • instance_id - ID of the instance (format: ip:port)
GET
/api/instances

Gets all registered instances. Requires authentication.

DELETE
/api/instances/{instance_id}

Removes a registered instance. Requires authentication.