Jobs Management API

Manage job openings, recruitment pipelines, and AI evaluation criteria programmatically via the Jobs API.

---

1. List Organization Jobs

Retrieve all active and draft job configurations under your organization.

GEThttps://api.xecubes.com/recruiter/jobs

cURL

curl -X GET "https://api.xecubes.com/recruiter/jobs" \
  -H "X-API-Key: xh_live_your_secret_key"

Node.js

const res = await fetch('https://api.xecubes.com/recruiter/jobs', {
  headers: {
    'X-API-Key': 'xh_live_your_secret_key'
  }
});
const jobs = await res.json();
console.log(jobs.data);

Python

import requests

response = requests.get(
    "https://api.xecubes.com/recruiter/jobs",
    headers={"X-API-Key": "xh_live_your_secret_key"}
)
print(response.json())

Sample Response

{
  "status": "success",
  "data": [
    {
      "id": "job_37H283J8K",
      "title": "Senior Staff AI Architect",
      "company_name": "xecubes Labs",
      "location": "San Francisco, CA",
      "status": "active",
      "openings": 1,
      "created_at": "2026-06-05T12:00:00Z"
    }
  ]
}

---

2. Create Job Opening

Create a new job with specified requirements, hiring pipeline, and automated screening thresholds.

POSThttps://api.xecubes.com/recruiter/jobs/create

Request Payload

Field	Type	Required	Description
title	String	Yes	Position title (e.g. "Senior Staff AI Architect").
description	String	Yes	Full job description & technical requirements.
location	String	Yes	Geographic location or "Remote".
company_name	String	Yes	Hiring entity name.
openings	Number	No	Number of target hires (default: 1).
pipeline_id	String	No	Target screening pipeline ID (e.g. "default", "senior-eng").

cURL

curl -X POST "https://api.xecubes.com/recruiter/jobs/create" \
  -H "X-API-Key: xh_live_your_secret_key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Senior Staff AI Architect",
    "description": "Scale fine-tuning paradigms, agentic reasoning architectures, and low-latency inference engines.",
    "location": "San Francisco, CA",
    "company_name": "xecubes Labs",
    "openings": 1,
    "pipeline_id": "default"
  }'

Node.js

const payload = {
  title: "Senior Staff AI Architect",
  description: "Scale fine-tuning paradigms...",
  location: "San Francisco, CA",
  company_name: "xecubes Labs",
  openings: 1,
  pipeline_id: "default"
};

const response = await fetch('https://api.xecubes.com/recruiter/jobs/create', {
  method: 'POST',
  headers: {
    'X-API-Key': 'xh_live_your_secret_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(payload)
});
const result = await response.json();
console.log('Created Job ID:', result.job_id);

Python

import requests

payload = {
    "title": "Senior Staff AI Architect",
    "description": "Scale fine-tuning paradigms...",
    "location": "San Francisco, CA",
    "company_name": "xecubes Labs",
    "openings": 1,
    "pipeline_id": "default"
}

response = requests.post(
    "https://api.xecubes.com/recruiter/jobs/create",
    headers={"X-API-Key": "xh_live_your_secret_key"},
    json=payload
)
print(response.json())

Success Response

{
  "status": "success",
  "message": "Job added successfully",
  "job_id": "job_37H283J8K"
}