Skip to main content
Documentation

API Reference

TestAuto.app exposes three API versions, each designed for a different learning objective. Select an API below to view its complete endpoint reference.

Common Concepts

Task Resource Schema

All three APIs work with the same Task structure:

  • id (integer) β€” Auto-assigned
  • title (string, required) β€” direct API create/update validation accepts 1–100 characters
  • description (string, optional) β€” direct API create/update validation accepts up to 500 characters
  • status (enum) β€” TODO | IN_PROGRESS | DONE
  • priority (enum) β€” LOW | MEDIUM | HIGH | URGENT
  • dueDate (date, optional) β€” YYYY-MM-DD
  • labels (string array, optional) β€” up to 10 free-text labels
  • checklistItems (array, optional) β€” ordered checklist items with text and done
  • comments (array) β€” ordered comment timeline attached to the task
  • attachments (array) β€” ordered attachment metadata with id, fileName, contentType, fileSizeBytes, and uploadedAt
  • sortOrder (integer) β€” manual board-order position within the current status column
  • createdAt (ISO 8601 timestamp, system-managed)
  • updatedAt (ISO 8601 timestamp, system-managed and refreshed on successful updates)

Attachment binary uploads use nested multipart endpoints rather than the JSON task create/update payloads. All three API versions cap tasks at 3 attachments and enforce a 1 MB per-file limit.

  • POST /tasks/{id}/attachments β€” upload one or more files via multipart/form-data using the files part name
  • DELETE /tasks/{taskId}/attachments/{attachmentId} β€” remove a stored attachment

Interactive Documentation

For interactive API exploration, use the Swagger UI.