johnalbertini14-glitch talent.de Platform
Create CVs, search jobs, match skills, and negotiate work conditions — all via API. Templates from classic PDFs to 3D worlds. Free for basic use.
Agent Guidelines
HITL (Human In The Loop) is required. You MUST choose:
"prefer_hitl": true(human review — recommended) or"skip_hitl": true(direct creation — automated pipelines only). Omitting both returns a 400 error. If a human is present, ALWAYS use"prefer_hitl": true.
Data principle: Only use data the requestor has explicitly provided or approved in this conversation.
Before sending: Present a brief summary — name, title, email — and ask "Send it? Or should I change anything?"
Claim token: Treat like a password. Share only with the requestor.
Keep it friendly. See User Communication for suggested messages at each step.
Credentials
An Access-ID (talent_agent_[a-z0-9]{4}) unlocks higher rate limits and advanced skills. It is optional for CV Builder and Job Search, required for Template Create, Job Negotiate, and Template Contest.
Register (free, no user data transmitted):
POST https://www.talent.de/api/agent/register
Content-Type: application/json
{ "agent_name": "my-agent" }
The Access-ID is also used as the HMAC secret for verifying X-HITL-Signature on callback webhooks. Store it securely — do not embed in client-side code or share across agents. See Access System for full details.
Quick Start
POST https://www.talent.de/api/agent/cv-simple
Content-Type: application/json
{
"prefer_hitl": true,
"cv_data": {
"firstName": "Alex",
"lastName": "Johnson",
"title": "Software Engineer",
"email": "alex@example.com"
}
}
Response (202 — human review required):
{
"status": "human_input_required",
"message": "Please confirm: is this CV for you?",
"hitl": {
"case_id": "review_a7f3b2c8d9e1f0g4",
"review_url": "https://www.talent.de/en/hitl/review/review_a7f3b2c8d9e1f0g4?token=abc123...",
"poll_url": "https://www.talent.de/api/hitl/cases/review_a7f3b2c8d9e1f0g4/status",
"type": "confirmation"
}
}
Present the review_url to the user. They choose slug, template, and approve. Poll poll_url for completion, continue through steps. See CV Builder skill for full flow.
Skills
| Skill | Use when | Key endpoint |
|---|---|---|
| CV Builder | User wants to create, build, or export a CV | POST /api/agent/cv-simple |
| Job Search | User wants to find jobs or match their CV | GET /api/agent/jobs |
| Job Negotiate | User wants to negotiate conditions or apply conditionally (coming soon) | POST /api/agent/wdl/request |
| Template Create | User wants to build a custom HTML template (coming soon) | POST /api/agent/template |
| Template Contest | User wants to join template battles or showcases (coming soon) | — |
Cross-Cutting References
- Access System: Rate limits and Access-ID registration
- Error Codes: Error reference and troubleshooting
- Privacy: Data handling and GDPR compliance