Skip to main content

​
Introduction

The Jobs API allows you to programmatically manage job postings captured through the Vega AI browser extension or other integrations. This API enables you to create job entries, track your quota usage, and integrate job tracking into your workflow.

​
Base URL

All API requests should be made to: 
https://api.vegaai.com/api/jobs

​
Authentication

All Jobs API endpoints require authentication using a Bearer token. Include your API token in the Authorization header: 
Authorization: Bearer YOUR_API_TOKEN
Keep your API token secure and never share it publicly. Tokens have the same permissions as your user account.

​
Available Endpoints

The Jobs API provides the following endpoints:

Create Job

Add a new job posting to your tracker

Get Quota Status

Check your monthly job capture quota

​
Common Response Codes

Status CodeDescription
200Success
400Bad Request - Invalid input data
401Unauthorized - Invalid or missing token
409Conflict - Resource already exists
500Internal Server Error

​
Rate Limits

API requests are subject to rate limiting based on your subscription tier. Free tier users have a monthly quota for job captures that can be checked using the Get Quota Status endpoint.
Duplicate jobs (same source URL) do not count against your quota.

​
Job Types

The following job types are supported:
  • full_time - Full-time position
  • part_time - Part-time position
  • contract - Contract/temporary position
  • intern - Internship
  • remote - Remote position
  • freelance - Freelance work
  • other - Other employment types

​
Job Status Values

Jobs can have the following status values:
  • interested - Initial state when job is saved
  • applied - Application submitted
  • interviewing - In interview process
  • offer_received - Job offer received
  • rejected - Application rejected
  • not_interested - No longer interested

​
Error Handling

All error responses follow a consistent format: 
{
  "error": "Error message describing what went wrong"
}

​
Common Errors

Status: 400 Bad RequestThe request body is missing required fields or contains invalid data types.Solution: Verify all required fields are present and have valid values.
Status: 409 ConflictA job with the same source URL already exists in your tracker.Solution: Update the existing job or use a different source URL.
Status: 401 UnauthorizedAuthentication token is missing or invalid.Solution: Include a valid Bearer token in the Authorization header.
Status: 403 ForbiddenYour monthly job capture quota has been reached.Solution: Upgrade your plan or wait for the quota to reset.

​
Next Steps

Create Your First Job

Learn how to add jobs to your tracker

Monitor Your Quota

Track your API usage and limits

Build docs developers (and LLMs) love

Get started for freeTalk to us