API de contratación

Un proyecto empresarial entra. Una aplicación aprobada sale explicada.

La API pública existe para evaluar candidato + proyecto, recibir AI Apply con consentimiento y dar control sobre la entrega. No ofrece cuentas, perfiles, feeds ni recomendaciones para candidatos.

Endpoint basehttps://workersignal-ai.com

Superficie pública mínima

Siete operaciones cubren preview, brief, envío, recibo y MCP. Leer un brief no envía evidencia; inspeccionar contexto y persistir requieren aprobaciones separadas.

Workspace empresarial privado

Proyectos, criterios, enlaces, listas de candidatos e informes requieren una organización y scopes de contratación.

Plataforma de candidato retirada

Estas familias permanecen como stubs 410 para migración. No aceptan login, perfiles, señales genéricas, publicación, búsqueda, jobs, cursos ni ventas.

Endpoints AI Apply

POST/api/hiring/evaluate

Compara una aplicación aprobada con un proyecto y devuelve un informe explicable en memoria.

Autorización: Pública
Uso: Prototipos empresariales y preview no persistente

Límites

• The project, application, and report are not persisted.
• Proof of work, application answers, and compatibility evaluation must all be explicitly approved.
• Before context inspection, the candidate separately authorizes the exact context categories recorded in consent.context_access.
• AI Apply v2 accepts structured proof from Codex or Claude with those authorized context categories, problem, actions, decisions, tools, capabilities, and outcomes.
• The report explains requirements, evidence basis, verification, gaps, risks, and recruiter questions.
• WorkerSignal supports a human decision and does not replace the ATS.

Request

{
  "project": {
    "title": "AWS platform migration",
    "summary": "Migrate an internal platform with staged rollback.",
    "objectives": ["Design the target architecture"],
    "problems": ["Tightly coupled services"],
    "technologies": ["AWS", "PostgreSQL"],
    "expected_outcomes": ["A staged migration plan"],
    "criteria": [{
      "id": "similar-work",
      "category": "proof_of_work",
      "label": "Similar architecture evidence",
      "priority": "required",
      "weight": 10,
      "evidence_terms": ["aws", "architecture", "migration"]
    }]
  },
  "application": {
    "schema_version": "ai-apply-v2",
    "candidate": { "reference": "Candidate A" },
    "proof_of_work": [{
      "id": "evidence-1",
      "title": "Staged AWS migration",
      "summary": "Designed an AWS migration with rollback checkpoints.",
      "project_context": "A cloud platform migration with strict continuity constraints.",
      "problem": "Tightly coupled services made a direct migration too risky.",
      "actions": ["Mapped dependencies and designed staged checkpoints."],
      "decisions": ["Required a tested rollback gate before moving traffic."],
      "source": "codex",
      "context_sources": ["workspace_activity", "decision_history", "outcome_summary"],
      "tools": ["AWS", "PostgreSQL"],
      "capabilities": ["Architecture"],
      "outcomes": ["Reduced migration risk"],
      "evidence_level": "candidate_approved",
      "candidate_approved": true
    }],
    "answers": {},
    "consent": {
      "context_access": {
        "granted": true,
        "sources": ["workspace_activity", "decision_history", "outcome_summary"],
        "approved_at": "2026-07-13T11:55:00.000Z"
      },
      "granted": true,
      "scope": ["proof_of_work", "application_answers", "compatibility_evaluation"],
      "destination": {
        "project_id": null,
        "project_title": "AWS platform migration",
        "company_name": null
      },
      "exact_payload_reviewed": true,
      "approved_at": "2026-07-13T12:00:00.000Z"
    }
  }
}

Response

{
  "report": {
    "compatibility_score": 94,
    "confidence": "low",
    "recommendation": "review",
    "requirements": [{
      "criterion_id": "similar-work",
      "status": "met",
      "evidence_basis": "approved_proof_of_work",
      "verification": "candidate_approved"
    }],
    "demonstrated_capabilities": ["Architecture"],
    "missing_information": [],
    "risks_to_validate": ["Supporting proof was approved by the candidate, not externally verified."],
    "recruiter_questions": [],
    "evidence_trace": [{
      "id": "evidence-1",
      "problem": "Tightly coupled services made a direct migration too risky.",
      "actions": ["Mapped dependencies and designed staged checkpoints."],
      "decisions": ["Required a tested rollback gate before moving traffic."],
      "context_sources": ["workspace_activity", "decision_history", "outcome_summary"]
    }],
    "methodology": { "version": "requirements-v5" }
  },
  "persisted": false
}

GET/api/hiring/apply/{token}

Devuelve solo el brief, criterios y preguntas del proyecto emitido por la empresa.

Autorización: Enlace AI Apply
Uso: Codex, Claude y clientes AI Apply autorizados

Límites

• Reading the brief sends no candidate evidence and creates no application.
• The brief declares the AI Apply schema, accepted Codex/Claude origins, structured proof fields, allowed context categories, and the requirement to authorize them before inspection.
• WorkerSignal stores only the SHA-256 hash of the wsa_ token.
• Expired, revoked, exhausted, or closed links fail explicitly.

POST/api/hiring/apply/{token}

Guarda la aplicación aprobada y crea el informe privado para la empresa emisora.

Autorización: Enlace AI Apply
Uso: AI Apply después de aprobación exacta

Límites

• AI Apply v2 structured proof, prior context-access authorization, exact destination consent, payload review, all three submission scopes, and both approval times are mandatory.
• The candidate receives one wsr_ receipt and a retention deadline, never the score.
• The compatibility report is isolated to the company that issued the link.

GET/api/hiring/receipt

Exporta entrega, consentimiento, proyecto y vencimiento sin score empresarial.

Autorización: Recibo privado
Uso: Candidato o agente autorizado

Límites

• Send Authorization: Bearer wsr_<receipt-token>; never put the receipt in a URL.
• Scores, recommendations, recruiter notes, and employer reports are excluded.

DELETE/api/hiring/receipt

Borra la entrega y su evaluación empresarial asociada de la base activa.

Autorización: Recibo privado
Uso: Candidato o agente autorizado

Límites

• Deletion invalidates the receipt immediately and does not restore capacity on the consumed link.
• Infrastructure backups remain subject to the documented rotation period.

GET/api/mcp

Descubre cinco tools de AI Apply, el prompt de proyecto y las reglas de privacidad.

Autorización: Pública
Uso: Claude, Codex y clientes MCP

Response

{
  "name": "workersignal-ai",
  "tools": [
    { "name": "read_ai_apply_brief" },
    { "name": "submit_approved_ai_apply" },
    { "name": "export_ai_apply_submission" },
    { "name": "delete_ai_apply_submission" },
    { "name": "get_ai_apply_privacy_rules" }
  ],
  "authentication": {
    "candidate_account_required": false,
    "application_capability": "A company-issued wsa_ link selects the project."
  }
}

POST/api/mcp

Lee briefs, envía aplicaciones aprobadas y opera exportación o borrado por recibo.

Autorización: Pública
Uso: Clientes MCP remotos

Límites

• MCP does not provide candidate accounts, profile management, generic signals, feed, search, jobs, courses, or sales tools.
• The AI Apply URL selects the company project; the receipt selects one candidate submission.

Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "read_ai_apply_brief",
    "arguments": {
      "apply_url": "https://workersignal-ai.com/api/hiring/apply/wsa_..."
    }
  }
}

Contrato de confianza

• La empresa define objetivos, problemas, tecnologías, resultados y criterios ponderados.
• El candidato autoriza las categorías mínimas antes de que su agente inspeccione contexto relevante.
• El envío requiere una segunda aprobación del proof of work, respuestas, destino y evaluación exactos.
• El informe separa evidencia demostrada, datos declarados, faltantes, riesgos y preguntas.
• La decisión de entrevistar y contratar siempre es humana.

Workspace empresarial privado

/api/hiring/projects/**/api/hiring/applications/**/api/cron/hiring-retention/api/internal/** and /api/resend/**

Plataforma de candidato retirada

/api/connectors/**/api/signals and /api/signals/recent/api/integrations/status/api/profile/status and /api/profile-assets/**/api/privacy/settings/api/match, /api/jobs/**, /api/opportunities/**, and /api/learning/**/api/feed/** and /api/profiles/**/inquiries

Configurar MCP Abrir workspace