API

Documentation

Version 1.0

API Changelog

This changelog documents all notable changes to the AutoTechJobs API, including new features, improvements, bug fixes, and deprecations. We follow semantic versioning (MAJOR.MINOR.PATCH) and maintain backward compatibility within the same major version.

API Versioning

The current API version is v1. All API endpoints are prefixed with /v1/. We will provide at least 6 months' notice before deprecating any API version.

v1.5.0

LatestReleased on April 1, 2025

New Features

  • Advanced Search API: Added new /v1/search endpoint with support for full-text search across jobs, employers, and candidates.
    Documentation: Search API
  • Bulk Operations: Added support for bulk creation and updates of jobs via the new /v1/jobs/bulk endpoint.
  • Webhooks Enhancements: Added support for webhook signatures and retry configurations.

Improvements

  • Rate Limits: Increased rate limits for authenticated API calls from 60 to 100 requests per minute.
  • Job Applications: Added more detailed status tracking for job applications.
  • Performance: Optimized response times for listing endpoints with large result sets.

Bug Fixes

  • Fixed an issue where filtering by multiple skills would return incorrect results.
  • Corrected the format of date fields in webhook payloads to consistently use ISO 8601.

v1.4.2

Released on February 15, 2025

Bug Fixes

  • Fixed pagination issues when sorting by non-indexed fields.
  • Resolved an error that occurred when updating job listings with certain special characters.
  • Fixed inconsistent error responses for invalid authentication tokens.

v1.4.1

Released on January 20, 2025

Improvements

  • Enhanced error messages to provide more actionable information.
  • Improved documentation for filtering and sorting parameters.

Bug Fixes

  • Fixed an issue with the distance parameter not working correctly with certain location formats.

v1.4.0

Released on December 5, 2024

New Features

  • Candidate Profiles: Added new endpoints for managing candidate profiles and resumes.
  • Application Tracking: Introduced a new application status tracking system with webhooks for status changes.
  • Enhanced Filtering: Added support for advanced filtering operators (_gt, _lt, _in, etc.).

Improvements

  • Added support for CORS on all API endpoints.
  • Improved rate limit handling with clearer headers and documentation.

v1.3.0

Released on October 10, 2024

New Features

  • Webhooks: Introduced webhooks for real-time notifications of API events.
  • Job Analytics: Added new endpoints for retrieving job posting analytics.

Improvements

  • Enhanced job search with support for location-based radius searches.
  • Added more fields to job and employer resources.

Deprecations

  • The location_radius parameter is deprecated in favor of the new distance parameter.

v1.2.0

Released on August 15, 2024

New Features

  • Sorting: Added support for sorting results by multiple fields.
  • Pagination: Implemented cursor-based pagination for improved performance.

Improvements

  • Enhanced authentication with support for API key rotation.
  • Improved error handling and validation messages.

v1.1.0

Released on June 1, 2024

New Features

  • Filtering: Added support for filtering results by various criteria.
  • Employers API: Introduced new endpoints for managing employer profiles.

Improvements

  • Enhanced job posting API with additional fields and options.
  • Improved documentation with more examples and use cases.

v1.0.0

Released on April 15, 2024

Initial Release

  • Jobs API: Core endpoints for creating, reading, updating, and deleting job listings.
  • Applications API: Basic functionality for job applications.
  • Authentication: API key-based authentication system.
  • Documentation: Initial API documentation and guides.

Staying Updated

To stay informed about API changes and updates:

For questions about API changes, please contact our Developer Support Team.