Datenmodell

Stellen

Eine offene Stelle. Trägt Titel, Abteilung, Standort, Beschäftigungsart, KI-Fit-Profil (Anforderungen + Knockout-Kriterien), Status und einen öffentlichen Karriereseiten-Slug. Übergeordnetes Objekt für Bewerbungen.

Modellname: job

Endpunkte: 5

Max. Seitengröße: 200

Felder

Validierungsregeln pro Feld. Werte, die diese Bedingungen verletzen, werden mit 400 abgewiesen, bevor sie die Datenbank erreichen.

Feld	Typ	Regeln
slug	`string`	max. Länge`120`
tags	`tags`	-
color	`string`	max. Länge`24`
title	`string`	max. Länge`200`
public	`bool`	-
remote	`enum`	enum`onsite \| hybrid \| remote`
status	`enum`	enum`draft \| open \| paused \| closed \| filled`
country	`string`	max. Länge`80`
summary	`string`	max. Länge`600`
benefits	`string`	max. Länge`4000`
currency	`string`	max. Länge`8`
language	`string`	max. Länge`16`
location	`string`	max. Länge`120`
team_ids	`list`	-
closed_at	`string`	max. Länge`32`
headcount	`number`	-
opened_at	`string`	max. Länge`32`
seniority	`enum`	enum`junior \| mid \| senior \| lead \| principal`
department	`string`	max. Länge`120`
salary_max	`number`	-
salary_min	`number`	-
description	`string`	max. Länge`16000`
nice_to_have	`string`	max. Länge`4000`
requirements	`string`	max. Länge`8000`
employment_type	`enum`	enum`full_time \| part_time \| internship \| working_student \| freelance \| contract`
ai_screen_prompt	`string`	max. Länge`4000`
responsibilities	`string`	max. Länge`8000`
ai_screen_enabled	`bool`	-
hiring_manager_id	`string`	max. Länge`64`
salary_visibility	`enum`	enum`public \| team \| private`
target_close_date	`string`	max. Länge`32`
external_apply_url	`url`	max. Länge`2048`
knockout_questions	`list`	-
screening_questions	`list`	-

Mutabilität

Welche Felder darfst du senden, und wann? Felder ohne Markierung werden vom Server vergeben - das Senden ist kein Fehler, sie werden stillschweigend ignoriert.

Anlegbar - im POST-Body lesbar.Änderbar - im PATCH-Body lesbar.Server-verwaltet - vom Body ignoriert.

Feld	Typ	Anlegbar	Änderbar
slug	string
tags	tags
color	string
title	string
public	bool
remote	enum
status	enum
country	string
summary	string
benefits	string
currency	string
language	string
location	string
team_ids	list
closed_at	string
headcount	number
opened_at	string
seniority	enum
department	string
salary_max	number
salary_min	number
description	string
nice_to_have	string
requirements	string
employment_type	enum
ai_screen_prompt	string
responsibilities	string
ai_screen_enabled	bool
hiring_manager_id	string
salary_visibility	enum
target_close_date	string
external_apply_url	url
knockout_questions	list
screening_questions	list

Felder mit Anlegbar, aber ohne Änderbar, sind nach dem Erstellen unveränderlich. Server-verwaltete Felder umfassen id, Zeitstempel, Eigentümerschaft und Status.

Filter & Sortierung

Auf Listen-Endpunkten kombinierbar. Wiederholte Filter-Keys werden zu IN-Bedingungen, ein - vor einem Sort-Key kehrt die Richtung um. Beispiel: ?status=open&status=blocked&sort=-created_at.

Filter-Keys

titledata__title

departmentdata__department

locationdata__location

employment_typedata__employment_type

senioritydata__seniority

remotedata__remote

status

publicdata__public

hiring_manager_iddata__hiring_manager_id

tagsdata__tags

statusstatus

is_archivedis_archived

owned_byowned_by

created_bycreated_by

Sortier-Keys

created_atcreated_at

updated_atupdated_at

titledata__title

opened_atdata__opened_at

target_close_datedata__target_close_date

Standard: created_at

Endpunkte

Jeder Endpunkt unten zeigt seine HTTP-Methode, den Pfad und den dafür benötigten PAT-Scope. Code-Beispiele decken curl, JavaScript, TypeScript, Python, Rust, Java und WebSocket ab.

GET/xapi2/data/jobjob:list

Objekte auflisten

Liefert eine paginierte Liste sichtbarer Objekte. Standard-Seitengröße 20; mit ?limit= änderbar (typabhängig begrenzt). ?after=<id> für Keyset-Paginierung bei nach created_at sortierten Listen, ?offset= für Offset-Paginierung.

curl -H "Authorization: Bearer pat_…" \
     "https://www.ki-bewerber-management.de/xapi2/data/job?limit=20"

GET/xapi2/data/job/{id}job:read

Einzelnes Objekt lesen

Liefert das Objekt anhand der ID. 404, falls es nicht existiert oder du keinen Lese-Zugriff hast (beide Fälle sind bewusst zusammengelegt).

curl -H "Authorization: Bearer pat_…" \
     https://www.ki-bewerber-management.de/xapi2/data/job/OBJECT_ID

POST/xapi2/data/jobjob:create

Erstellen

Erstellt ein neues Objekt. Der Body ist ein flaches JSON-Dict mit Feldwerten. Server-seitige Felder (id, Zeitstempel, Ownership) werden automatisch gefüllt; nur die unten als anlegbar gelisteten Felder werden aus dem Body übernommen.

curl -H "Authorization: Bearer pat_…" \
     -H "Content-Type: application/json" \
     -X POST https://www.ki-bewerber-management.de/xapi2/data/job \
     -d '{"name": "…"}'

PATCH/xapi2/data/job/{id}job:update

Aktualisieren

Teilweise Aktualisierung. Nur Felder im Body werden verändert; alles andere bleibt erhalten. Gleiche Erlaubnisliste wie bei Create, abzüglich der nach dem Anlegen unveränderlichen Felder.

curl -H "Authorization: Bearer pat_…" \
     -H "Content-Type: application/json" \
     -X PATCH https://www.ki-bewerber-management.de/xapi2/data/job/OBJECT_ID \
     -d '{"name": "…"}'

DELETE/xapi2/data/job/{id}job:delete

Löschen

Entfernt das Objekt. Es verschwindet sofort aus allen Standard-Listen und wird von read / list nicht mehr zurückgegeben.

curl -H "Authorization: Bearer pat_…" \
     -X DELETE https://www.ki-bewerber-management.de/xapi2/data/job/OBJECT_ID

In der CLI

Dieselben Endpunkte sind auch über die KI BMS CLI verfügbar. Für Skripte, CI und Bulk-Imports ist sie meist die schnellere Wahl.

atscli job list --limit 5
atscli job get <id>
atscli job create --title "Hello"
atscli job upsert --unique title --csv items.csv
atscli job schema   # Felder & Limits

Volle Befehlsreferenz, Profile, CSV-Import, Auto-Retry, NDJSON-Streaming → /docs/cli