Yardstick ATS MCP — MCP Radar

yardstick_access_grants_create

Grant someone access to a record (confirm in Yardstick)

Create a reasoned, revocable, audited access grant.

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['subject_person_id', 'scope', 'target_id', 'artifact_classes', 'reason'], 'properties': {'scope': {'enum': ['job', 'department', 'application', 'report'], 'type': 'string'}, 'reason': {'type': 'string', 'maxLength': 2000, 'minLength': 1}, 'revocable': {'type': 'boolean'}, 'target_id': {'type': 'string', 'minLength': 1}, 'expires_at': {'type': 'string', 'format': 'date-time'}, 'request_id': {'type': 'string', 'minLength': 1}, 'effective_at': {'type': 'string', 'format': 'date-time'}, 'idempotency_key': {'type': 'string', 'minLength': 1}, 'artifact_classes': {'type': 'array', 'items': {'enum': ['application', 'interview_plan', 'scorecard', 'decision_brief', 'report'], 'type': 'string'}, 'maxItems': 20, 'minItems': 1}, 'subject_person_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_access_grants_list

List access grants

List explicit access grants visible to the current principal.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'starting_after': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_access_grants_read

Read an access grant

Read one explicit access grant by public id.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['access_grant_id'], 'properties': {'request_id': {'type': 'string', 'minLength': 1}, 'access_grant_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_access_grants_revoke

Revoke an access grant (confirm in Yardstick)

Revoke an explicit access grant with optional reason text.

可能执行破坏性操作

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['access_grant_id'], 'properties': {'reason': {'type': 'string', 'maxLength': 2000}, 'request_id': {'type': 'string', 'minLength': 1}, 'access_grant_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_application_interview_sessions_ensure

Make sure an interview exists for a round

Ensure an application interview session for an explicit round id.

幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['application_id', 'round_id'], 'properties': {'round_id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'round_title': {'type': 'string', 'minLength': 1}, 'application_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}, 'interview_plan_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_application_interview_sessions_list

List interviews for an application

List interview sessions for an application.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['application_id'], 'properties': {'request_id': {'type': 'string', 'minLength': 1}, 'application_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_applications_archive_bind

Confirm and archive an application

Bind an already-previewed application archive with explicit approval metadata and matching idempotency key.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['application_id', 'binding'], 'properties': {'reason': {'type': 'string', 'maxLength': 2000}, 'binding': {'type': 'object', 'required': ['preview_hash', 'approved_action_key', 'approved_input_hash', 'approved_idempotency_key', 'resource_version_precondition'], 'properties': {'preview_hash': {'type': 'string', 'minLength': 1}, 'approved_action_key': {'type': 'string', 'minLength': 1}, 'approved_input_hash': {'type': 'string', 'minLength': 1}, 'approved_idempotency_key': {'type': 'string', 'minLength': 1}, 'resource_version_precondition': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'application_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_applications_archive_preview

Preview archiving an application (nothing changed yet)

Preview application archive approval requirements only; bind fields are rejected.

幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['application_id'], 'properties': {'reason': {'type': 'string', 'maxLength': 2000}, 'request_id': {'type': 'string', 'minLength': 1}, 'application_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_applications_create

Add an application

Create a recruiter or agent-sourced application for an existing person and job posting.

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['person_id', 'job_posting_id'], 'properties': {'person_id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'job_posting_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_applications_email_decision_apply

Apply a status change and its candidate email

Apply an application status-change email decision with idempotency metadata.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['application_id'], 'properties': {'request_id': {'type': 'string', 'minLength': 1}, 'application_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': {}}

yardstick_applications_email_decision_preview

Preview the candidate email for a status change (nothing sent)

Preview the candidate email decision for an application status change without mutating the application or drafts.

幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['application_id'], 'properties': {'request_id': {'type': 'string', 'minLength': 1}, 'application_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': {}}

yardstick_applications_list

List applications

List application person + Job attachments visible to the current principal.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'starting_after': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_applications_read

Read an application

Read one application person + Job attachment by public id.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['application_id'], 'properties': {'request_id': {'type': 'string', 'minLength': 1}, 'application_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_applications_status_email_poc_bind

Confirm the Offer status change and send its candidate email

Bind the fixed applications-owned status/email approval POC with explicit approval metadata and a matching idempotency key.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['application_id', 'current_status', 'target_status', 'email_type', 'decision', 'binding'], 'properties': {'mode': {'enum': ['test', 'live'], 'type': 'string'}, 'binding': {'type': 'object', 'required': ['preview_hash', 'approved_action_key', 'approved_input_hash', 'approved_idempotency_key', 'resource_version_precondition'], 'properties': {'preview_hash': {'type': 'string', 'minLength': 1}, 'approved_action_key': {'type': 'string', 'minLength': 1}, 'approved_input_hash': {'type': 'string', 'minLength': 1}, 'approved_idempotency_key': {'type': 'string', 'minLength': 1}, 'resource_version_precondition': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'decision': {'type': 'string', 'const': 'review_edit'}, 'email_type': {'type': 'string', 'const': 'offer'}, 'request_id': {'type': 'string', 'minLength': 1}, 'target_status': {'type': 'string', 'const': 'Offer'}, 'application_id': {'type': 'string', 'minLength': 1}, 'current_status': {'type': 'string', 'const': 'Interviewing'}, 'idempotency_key': {'type': 'string', 'minLength': 1}, 'personalization_instruction': {'anyOf': [{'type': 'string', 'maxLength': 2000}, {'type': 'null'}]}, 'requested_sender_identity_id': {'anyOf': [{'type': 'string', 'format': 'uuid'}, {'type': 'null'}]}}, 'additionalProperties': False}

yardstick_applications_status_email_poc_preview

Preview the Offer status change and its candidate email (nothing changed yet)

Preview the fixed applications-owned Interviewing to Offer status/email approval POC without mutating status or email state.

幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['application_id', 'current_status', 'target_status', 'email_type', 'decision'], 'properties': {'mode': {'enum': ['test', 'live'], 'type': 'string'}, 'decision': {'type': 'string', 'const': 'review_edit'}, 'email_type': {'type': 'string', 'const': 'offer'}, 'request_id': {'type': 'string', 'minLength': 1}, 'target_status': {'type': 'string', 'const': 'Offer'}, 'application_id': {'type': 'string', 'minLength': 1}, 'current_status': {'type': 'string', 'const': 'Interviewing'}, 'idempotency_key': {'type': 'string', 'minLength': 1}, 'personalization_instruction': {'anyOf': [{'type': 'string', 'maxLength': 2000}, {'type': 'null'}]}, 'requested_sender_identity_id': {'anyOf': [{'type': 'string', 'format': 'uuid'}, {'type': 'null'}]}}, 'additionalProperties': False}

yardstick_applications_transition_bind

Confirm and apply an application status change

Bind an already-previewed application transition with explicit approval metadata and matching idempotency key.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['application_id', 'status', 'binding'], 'properties': {'reason': {'type': 'string', 'maxLength': 2000}, 'status': {'enum': ['Offer', 'Hired', 'Offer Rejected', 'Disqualified', 'Withdrawn'], 'type': 'string'}, 'binding': {'type': 'object', 'required': ['preview_hash', 'approved_action_key', 'approved_input_hash', 'approved_idempotency_key', 'resource_version_precondition'], 'properties': {'preview_hash': {'type': 'string', 'minLength': 1}, 'approved_action_key': {'type': 'string', 'minLength': 1}, 'approved_input_hash': {'type': 'string', 'minLength': 1}, 'approved_idempotency_key': {'type': 'string', 'minLength': 1}, 'resource_version_precondition': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'application_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}, 'employment_start_date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}}, 'additionalProperties': False}

yardstick_applications_transition_direct

Move an application to another status

Directly write a non-terminal application transition; approval-only statuses are rejected. Optionally target a configured stage by id with pipeline_stage_id (the resolved stage is reported back).

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['application_id', 'status'], 'properties': {'reason': {'type': 'string', 'maxLength': 2000}, 'status': {'enum': ['Screening', 'Interviewing', 'On Hold'], 'type': 'string'}, 'request_id': {'type': 'string', 'minLength': 1}, 'application_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}, 'pipeline_stage_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_applications_transition_preview

Preview an application status change (nothing changed yet)

Preview approval-required application transitions only; bind fields and direct-write targets are rejected. Optionally target a configured stage by id with pipeline_stage_id (status must match the stage's mapped status).

幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['application_id', 'status'], 'properties': {'reason': {'type': 'string', 'maxLength': 2000}, 'status': {'enum': ['Offer', 'Hired', 'Offer Rejected', 'Disqualified', 'Withdrawn'], 'type': 'string'}, 'request_id': {'type': 'string', 'minLength': 1}, 'application_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}, 'pipeline_stage_id': {'type': 'string', 'minLength': 1}, 'employment_start_date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}}, 'additionalProperties': False}

yardstick_applications_update

Update an application

Update one application with schema-bound public API fields.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['application_id'], 'properties': {'stage': {'type': 'string', 'maxLength': 200}, 'request_id': {'type': 'string', 'minLength': 1}, 'application_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_ats_imports_apply

Confirm and apply an ATS import

Apply an approved ATS import preview with a preview_hash matching the stored dry-run. Creates people/jobs/interview_plans(stub)/job_postings/applications with idempotent replay; never sends outreach, merges people, or deletes records.

幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['import_id', 'preview_hash'], 'properties': {'import_id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'preview_hash': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_ats_imports_dry_run

Preview an ATS import (no records written)

Preview a structured-row ATS import of candidates, jobs, and applications (source_kind: csv). JSON rows only; no raw CSV/archive file reads, no application conversion side effects, and low-confidence stage/fuzzy matches require explicit apply decisions.

幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'jobs': {'type': 'array', 'items': {'type': 'object', 'properties': {'title': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}, 'status': {'anyOf': [{'type': 'string', 'maxLength': 50}, {'type': 'null'}]}, 'location': {'anyOf': [{'type': 'string', 'maxLength': 300}, {'type': 'null'}]}, 'department': {'anyOf': [{'type': 'string', 'maxLength': 300}, {'type': 'null'}]}, 'location_type': {'anyOf': [{'type': 'string', 'maxLength': 100}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 1000}, 'metadata': {'type': 'object', 'additionalProperties': {}}, 'candidates': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}, 'email': {'anyOf': [{'type': 'string', 'format': 'email', 'maxLength': 320}, {'type': 'null'}]}, 'notes': {'anyOf': [{'type': 'string', 'maxLength': 10000}, {'type': 'null'}]}, 'phone': {'anyOf': [{'type': 'string', 'maxLength': 50}, {'type': 'null'}]}, 'linkedin_url': {'anyOf': [{'type': 'string', 'format': 'uri', 'maxLength': 2048}, {'type': 'null'}]}, 'current_title': {'anyOf': [{'type': 'string', 'maxLength': 300}, {'type': 'null'}]}, 'current_company': {'anyOf': [{'type': 'string', 'maxLength': 300}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 1000}, 'request_id': {'type': 'string', 'minLength': 1}, 'session_id': {'type': 'string', 'minLength': 1}, 'source_kind': {'enum': ['csv', 'greenhouse'], 'type': 'string'}, 'applications': {'type': 'array', 'items': {'type': 'object', 'properties': {'stage': {'anyOf': [{'type': 'string', 'maxLength': 300}, {'type': 'null'}]}, 'job_title': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}, 'candidate_name': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}, 'candidate_email': {'anyOf': [{'type': 'string', 'format': 'email', 'maxLength': 320}, {'type': 'null'}]}, 'employment_start_date': {'anyOf': [{'type': 'string', 'maxLength': 50}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 1000}, 'source_label': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_ats_imports_read

Read an ATS import batch

Read one ATS import dry-run/apply batch and its rows by public id.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['import_id'], 'properties': {'import_id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_audit_log_list

List audit log entries

List public Yardstick audit log entries visible to the current principal.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'starting_after': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_automation_rules_create

Create a stage automation rule

Create a stage automation rule (trigger + typed action from the 3-type palette: send_scheduling_link / create_task / send_email). Inert — fires no side effect.

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['pipeline_stage_id', 'trigger', 'action'], 'properties': {'action': {'anyOf': [{'type': 'object', 'required': ['type'], 'properties': {'type': {'type': 'string', 'const': 'send_scheduling_link'}, 'interview_id': {'type': 'string', 'minLength': 1}, 'interview_session_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, {'type': 'object', 'required': ['type', 'task_type', 'task_title', 'assigned_user_email'], 'properties': {'type': {'type': 'string', 'const': 'create_task'}, 'context': {'type': 'object', 'additionalProperties': {}}, 'due_date': {'type': 'string', 'maxLength': 64, 'minLength': 1}, 'task_type': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'task_title': {'type': 'string', 'maxLength': 500, 'minLength': 1}, 'assigned_user_email': {'type': 'string', 'maxLength': 320, 'minLength': 1}}, 'additionalProperties': False}, {'type': 'object', 'required': ['type', 'email_type'], 'properties': {'type': {'type': 'string', 'const': 'send_email'}, 'email_type': {'enum': ['acknowledgment', 'advancement', 'interview_confirmation', 'rejection', 'offer_declined', 'offer', 'hired', 'withdrawn', 'on_hold'], 'type': 'string'}}, 'additionalProperties': False}]}, 'trigger': {'enum': ['stage_enter', 'stage_exit'], 'type': 'string'}, 'position': {'type': 'integer', 'minimum': 0}, 'condition': {'type': 'object', 'additionalProperties': {}}, 'is_active': {'type': 'boolean'}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}, 'pipeline_stage_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_automation_rules_delete

Delete a stage automation rule

Delete a stage automation rule. Plain delete (no approval preview→bind): rules are inert config, so deleting unfired config moves no candidates.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['rule_id'], 'properties': {'rule_id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_automation_rules_list

List stage automation rules

List the organization's stage automation rules. Rules are inert config — authoring fires no side effect; the executor child runs rules later.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'request_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_automation_rules_preview

Preview which automations a stage change would fire (runs nothing)

Dry-run preview: resolve the active rules + their resolved action params for a sample application entering/leaving a stage. INERT — mints no scheduling link, creates no task, sends no email; executes nothing.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['application_id', 'trigger', 'pipeline_stage_id'], 'properties': {'trigger': {'enum': ['stage_enter', 'stage_exit'], 'type': 'string'}, 'request_id': {'type': 'string', 'minLength': 1}, 'application_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}, 'pipeline_stage_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_automation_rules_read

Read a stage automation rule

Read one stage automation rule by public id (its trigger, typed action, target stage, and is_active state).

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['rule_id'], 'properties': {'rule_id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_automation_rules_update

Edit a stage automation rule

Edit a stage automation rule's trigger, typed action, condition, position, or is_active state.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['rule_id'], 'properties': {'action': {'anyOf': [{'type': 'object', 'required': ['type'], 'properties': {'type': {'type': 'string', 'const': 'send_scheduling_link'}, 'interview_id': {'type': 'string', 'minLength': 1}, 'interview_session_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, {'type': 'object', 'required': ['type', 'task_type', 'task_title', 'assigned_user_email'], 'properties': {'type': {'type': 'string', 'const': 'create_task'}, 'context': {'type': 'object', 'additionalProperties': {}}, 'due_date': {'type': 'string', 'maxLength': 64, 'minLength': 1}, 'task_type': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'task_title': {'type': 'string', 'maxLength': 500, 'minLength': 1}, 'assigned_user_email': {'type': 'string', 'maxLength': 320, 'minLength': 1}}, 'additionalProperties': False}, {'type': 'object', 'required': ['type', 'email_type'], 'properties': {'type': {'type': 'string', 'const': 'send_email'}, 'email_type': {'enum': ['acknowledgment', 'advancement', 'interview_confirmation', 'rejection', 'offer_declined', 'offer', 'hired', 'withdrawn', 'on_hold'], 'type': 'string'}}, 'additionalProperties': False}]}, 'rule_id': {'type': 'string', 'minLength': 1}, 'trigger': {'enum': ['stage_enter', 'stage_exit'], 'type': 'string'}, 'position': {'anyOf': [{'type': 'integer', 'minimum': 0}, {'type': 'null'}]}, 'condition': {'type': 'object', 'additionalProperties': {}}, 'is_active': {'type': 'boolean'}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_automation_runs_list

List stage automation runs

List the organization's stage automation runs (what fired for which candidate, success/failure). Filterable by application-id and rule-id. Read-only; runs are system-written by the executor and include skipped (deferred) send_email rows so run state is fully observable.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'rule_id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'application_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_built_in_agents_configure_bind

Confirm and save built-in-agent settings

Bind an approved built-in-agent configure preview (same config plus approval metadata and a matching idempotency key). Writes only the built-in agent's declared settings keys and records one audit row.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['built_in_agent_id', 'config', 'binding'], 'properties': {'config': {'type': 'object', 'additionalProperties': {}}, 'binding': {'type': 'object', 'required': ['preview_hash', 'approved_action_key', 'approved_input_hash', 'approved_idempotency_key', 'resource_version_precondition'], 'properties': {'preview_hash': {'type': 'string', 'minLength': 1}, 'approved_action_key': {'type': 'string', 'minLength': 1}, 'approved_input_hash': {'type': 'string', 'minLength': 1}, 'approved_idempotency_key': {'type': 'string', 'minLength': 1}, 'resource_version_precondition': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}, 'built_in_agent_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_built_in_agents_configure_preview

Preview built-in-agent settings changes (nothing changed yet)

Preview configuring a built-in agent (config is validated against the built-in agent's declared schema; enabled is a first-class key, so { enabled: false } is the off switch). Side-effect free; pass config via --body-json.

幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['built_in_agent_id', 'config'], 'properties': {'config': {'type': 'object', 'additionalProperties': {}}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}, 'built_in_agent_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_built_in_agents_enable_bind

Confirm and turn on a built-in agent

Bind an approved built-in-agent enable preview with explicit approval metadata and a matching idempotency key. Writes the built-in agent's declared settings home and records one audit row.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['built_in_agent_id', 'binding'], 'properties': {'binding': {'type': 'object', 'required': ['preview_hash', 'approved_action_key', 'approved_input_hash', 'approved_idempotency_key', 'resource_version_precondition'], 'properties': {'preview_hash': {'type': 'string', 'minLength': 1}, 'approved_action_key': {'type': 'string', 'minLength': 1}, 'approved_input_hash': {'type': 'string', 'minLength': 1}, 'approved_idempotency_key': {'type': 'string', 'minLength': 1}, 'resource_version_precondition': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}, 'built_in_agent_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_built_in_agents_enable_preview

Preview turning on a built-in agent (nothing changed yet)

Preview enabling a built-in agent; returns the approval-required envelope stating exactly what starts happening (and what is never sent without you) plus binding fields. Side-effect free.

幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['built_in_agent_id'], 'properties': {'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}, 'built_in_agent_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_built_in_agents_list

List built-in agents

List the built-in-agent catalog with each built-in agent's current status, explicit defaults or disabled state, and latest work summary.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'request_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_built_in_agents_read

Read a built-in agent

Read one built-in agent by catalog id (for example scorecard-chaser, nightly-screening, or interview-kit-prep): what it does, what it never does without you, current status, and latest work summary.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['built_in_agent_id'], 'properties': {'request_id': {'type': 'string', 'minLength': 1}, 'built_in_agent_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_built_in_agents_runs

List built-in-agent run history

List the organization's built-in-agent run history as a flat work report. Nightly screening reports scheduled-work counts and held, released, or invalidated review outputs; interview-kit preparation reports the scheduled week and count-only results. It never includes candidate, draft, recipient, kit, or provider details. delivery_unknown is not delivered and is not retried. Filterable by built-in-agent id. Read-only and mode-scoped.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'request_id': {'type': 'string', 'minLength': 1}, 'built_in_agent_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_decision_brief_read

Read a hiring decision brief

Read the decision brief for an application.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['application_id'], 'properties': {'request_id': {'type': 'string', 'minLength': 1}, 'application_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_decision_brief_regenerate

Regenerate a hiring decision brief

Regenerate a decision brief for an application with idempotency metadata.

可能执行破坏性操作

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['application_id'], 'properties': {'request_id': {'type': 'string', 'minLength': 1}, 'application_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_departments_create

Create a department (confirm in Yardstick)

Create a Department through the public Yardstick API.

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['name'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'slug': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'description': {'anyOf': [{'type': 'string', 'maxLength': 2000}, {'type': 'null'}]}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_departments_invitations_create

Invite someone to a department (confirm in Yardstick)

Create a Department-scoped invitation without returning token material.

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['department_id', 'email', 'role'], 'properties': {'name': {'type': 'string', 'maxLength': 200}, 'role': {'enum': ['department_lead', 'recruiter'], 'type': 'string'}, 'email': {'type': 'string', 'format': 'email', 'maxLength': 320}, 'full_name': {'type': 'string', 'maxLength': 200}, 'request_id': {'type': 'string', 'minLength': 1}, 'department_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}, 'expires_in_hours': {'type': 'integer', 'maximum': 720, 'minimum': 1}}, 'additionalProperties': False}

yardstick_departments_invitations_list

List department invitations

List redacted Department invitation views.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['department_id'], 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'department_id': {'type': 'string', 'minLength': 1}, 'starting_after': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_departments_list

List departments

List Departments visible to the current principal.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'starting_after': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_departments_members_add

Add a department member (confirm in Yardstick)

Add an existing person to a Department.

幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['department_id', 'person_id'], 'properties': {'person_id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'department_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_departments_members_list

List department members

List Department members for an authorized Department.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['department_id'], 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'department_id': {'type': 'string', 'minLength': 1}, 'starting_after': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_departments_members_remove

Remove a department member (confirm in Yardstick)

Remove a Department member, optionally with a replacement lead.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['department_id', 'person_id'], 'properties': {'person_id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'department_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}, 'replacement_lead_person_id': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}]}}, 'additionalProperties': False}

yardstick_departments_members_set_lead

Set the department lead (confirm in Yardstick)

Set one Department member as lead.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['department_id', 'person_id'], 'properties': {'role': {'type': 'string', 'const': 'lead', 'default': 'lead'}, 'person_id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'department_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_departments_read

Read a department

Read one Department by public id.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['department_id'], 'properties': {'request_id': {'type': 'string', 'minLength': 1}, 'department_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_departments_update

Update a department (confirm in Yardstick)

Update one Department with schema-bound public API fields.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['department_id'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'slug': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'description': {'anyOf': [{'type': 'string', 'maxLength': 2000}, {'type': 'null'}]}, 'department_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_email_automation_settings_read

Read email automation settings

Read candidate email automation settings.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'request_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_email_automation_settings_update

Update email automation settings

Update candidate email automation settings.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': {}}

yardstick_email_drafts_discard

Discard a candidate email draft

Discard a pending candidate email draft without provider mutation.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_email_drafts_history

Read candidate email draft history

Read candidate email draft history and provenance.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_email_drafts_list

List candidate email drafts

List candidate email drafts with optional status and email-type filters.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'status': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'email_type': {'enum': ['acknowledgment', 'advancement', 'interview_confirmation', 'rejection', 'offer_declined', 'offer', 'hired', 'withdrawn', 'on_hold', 'scorecard_nudge', 'scorecard_escalation', 'decision_brief', 'prospect_outreach', 'candidate_follow_up'], 'type': 'string'}, 'request_id': {'type': 'string', 'minLength': 1}, 'starting_after': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_email_drafts_preview

Preview a candidate email draft

Read rendered preview content for a candidate email draft.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_email_drafts_read

Read a candidate email draft

Read a redacted candidate email draft.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_email_drafts_send

Send a candidate email

Send a pending candidate email draft with replay protection, or reclaim a never-delivered draft and send it.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}, 'reclaim_not_delivered': {'type': 'boolean'}}, 'additionalProperties': False}

yardstick_email_drafts_update

Edit a candidate email draft

Save mutable candidate email draft fields or set/clear a validated sender override.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': {}}

yardstick_email_sender_connections_list

List email sender connections

List redacted sender provider connection state.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'request_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_email_sender_defaults_list

List default email senders

List candidate email sender defaults.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'request_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_email_sender_defaults_set

Set the default sender for an email type

Set the default sender policy for a candidate email type.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['email_type', 'default_sender_type'], 'properties': {'email_type': {'enum': ['acknowledgment', 'advancement', 'interview_confirmation', 'rejection', 'offer_declined', 'offer', 'hired', 'withdrawn', 'on_hold', 'scorecard_nudge', 'scorecard_escalation', 'decision_brief', 'prospect_outreach', 'candidate_follow_up'], 'type': 'string'}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}, 'default_sender_type': {'enum': ['org_shared', 'owner', 'job_hiring_manager'], 'type': 'string'}, 'org_shared_sender_identity_id': {'anyOf': [{'type': 'string', 'format': 'uuid'}, {'type': 'null'}]}}, 'additionalProperties': False}

yardstick_email_sender_settings_read

Read email sender settings

Read redacted email sender settings with sanitized queue diagnostics.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'request_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_email_templates_list

List candidate email templates

List candidate email template policies without raw prompts.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'request_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_email_templates_preview

Preview a candidate email template with sample data

Preview a candidate email template for sample variables.

幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['email_type'], 'properties': {'email_type': {'enum': ['acknowledgment', 'advancement', 'interview_confirmation', 'rejection', 'offer_declined', 'offer', 'hired', 'withdrawn', 'on_hold', 'candidate_follow_up'], 'type': 'string'}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': {}}

yardstick_email_templates_preview_customization

Preview AI customization for an email template (nothing published)

Preview AI sample customization for a candidate email template without publishing.

幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['email_type'], 'properties': {'email_type': {'enum': ['acknowledgment', 'advancement', 'interview_confirmation', 'rejection', 'offer_declined', 'offer', 'hired', 'withdrawn', 'on_hold', 'candidate_follow_up'], 'type': 'string'}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': {}}

yardstick_email_templates_publish

Publish a candidate email template version

Publish a validated candidate email template version.

可能执行破坏性操作

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['email_type'], 'properties': {'email_type': {'enum': ['acknowledgment', 'advancement', 'interview_confirmation', 'rejection', 'offer_declined', 'offer', 'hired', 'withdrawn', 'on_hold', 'candidate_follow_up'], 'type': 'string'}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': {}}

yardstick_email_templates_read

Read a candidate email template

Read candidate email template detail without raw prompts.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['email_type'], 'properties': {'email_type': {'enum': ['acknowledgment', 'advancement', 'interview_confirmation', 'rejection', 'offer_declined', 'offer', 'hired', 'withdrawn', 'on_hold', 'candidate_follow_up'], 'type': 'string'}, 'request_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_email_templates_rollback

Roll a candidate email template back to an earlier version

Rollback a candidate email template to an immutable version.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['email_type', 'version_id'], 'properties': {'email_type': {'enum': ['acknowledgment', 'advancement', 'interview_confirmation', 'rejection', 'offer_declined', 'offer', 'hired', 'withdrawn', 'on_hold', 'candidate_follow_up'], 'type': 'string'}, 'request_id': {'type': 'string', 'minLength': 1}, 'version_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_email_templates_validate

Check a candidate email template for problems

Validate candidate email template subject, HTML, and text bodies.

幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['email_type'], 'properties': {'email_type': {'enum': ['acknowledgment', 'advancement', 'interview_confirmation', 'rejection', 'offer_declined', 'offer', 'hired', 'withdrawn', 'on_hold', 'candidate_follow_up'], 'type': 'string'}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': {}}

yardstick_email_template_versions_list

List email template versions

List immutable candidate email template versions.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['email_type'], 'properties': {'email_type': {'enum': ['acknowledgment', 'advancement', 'interview_confirmation', 'rejection', 'offer_declined', 'offer', 'hired', 'withdrawn', 'on_hold', 'candidate_follow_up'], 'type': 'string'}, 'request_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_events_list

List API events

List public Yardstick API events visible to the current principal.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'starting_after': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_final_recommendation_record

Record a final hiring recommendation

Record direct final-recommendation evidence; this does not mutate application status.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['application_id', 'interviewer_user_id', 'rating'], 'properties': {'notes': {'type': 'string', 'maxLength': 8000}, 'rating': {'type': 'integer', 'maximum': 4, 'minimum': 0}, 'request_id': {'type': 'string', 'minLength': 1}, 'session_id': {'type': 'string', 'minLength': 1}, 'application_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}, 'interviewer_user_id': {'type': 'string'}}, 'additionalProperties': False}

yardstick_identity

Read the current API identity

Return the current Yardstick API principal context.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'request_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_integrations_workspace_health_read

Check workspace integration health

Read sanitized Workspace integration health diagnostics.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'request_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plan_drafts_add_competencies

Add competencies to an interview plan draft

Add competencies to a draft exactly as written — deterministic, no AI generation. Requires confirmed outcomes; the resulting stage must stay within 25 competencies. Optional source_stage {stage: competencies, version} returns 409 when stale.

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action', 'resource', 'input'], 'properties': {'input': {'type': 'object', 'required': ['items'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'maxLength': 128}, 'name': {'type': 'string', 'maxLength': 300}, 'title': {'type': 'string', 'maxLength': 300}, 'details': {'type': 'string', 'maxLength': 5000}, 'competency': {'type': 'string', 'maxLength': 300}, 'definition': {'type': 'string', 'maxLength': 5000}, 'description': {'type': 'string', 'maxLength': 5000}}, 'additionalProperties': False}, 'maxItems': 25, 'minItems': 1}, 'source_stage': {'type': 'object', 'required': ['stage'], 'properties': {'stage': {'type': 'string', 'const': 'competencies'}, 'version': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'action': {'type': 'string', 'const': 'interview_plan.add_competencies'}, 'resource': {'type': 'object', 'required': ['type', 'id'], 'properties': {'id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$'}, 'type': {'type': 'string', 'const': 'interview_plan_draft'}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plan_drafts_add_questions

Add questions to a draft interview round

Add questions to one draft round exactly as written — deterministic, no AI generation. Requires rounds; each round holds at most 50 questions. The first question edit on a round persists question_N ids for every question in that round. Optional source_stage {stage: questions_and_directions, version} returns 409 when stale.

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action', 'resource', 'input'], 'properties': {'input': {'type': 'object', 'required': ['round_id', 'questions'], 'properties': {'round_id': {'type': 'string', 'maxLength': 128, 'minLength': 1}, 'questions': {'type': 'array', 'items': {'type': 'object', 'required': ['text'], 'properties': {'id': {'type': 'string', 'maxLength': 128}, 'tags': {'type': 'array', 'items': {'type': 'string', 'maxLength': 128}, 'maxItems': 20}, 'text': {'type': 'string', 'maxLength': 5000, 'minLength': 1}, 'guidance': {'type': 'string', 'maxLength': 10000}, 'followUpQuestions': {'type': 'array', 'items': {'type': 'string', 'maxLength': 2000}, 'maxItems': 20}}, 'additionalProperties': False}, 'maxItems': 50, 'minItems': 1}, 'source_stage': {'type': 'object', 'required': ['stage'], 'properties': {'stage': {'type': 'string', 'const': 'questions_and_directions'}, 'version': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'action': {'type': 'string', 'const': 'interview_plan.add_questions'}, 'resource': {'type': 'object', 'required': ['type', 'id'], 'properties': {'id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$'}, 'type': {'type': 'string', 'const': 'interview_plan_draft'}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plan_drafts_add_rounds

Add interview rounds to an interview plan draft

Add interview rounds to a draft exactly as written — deterministic, no AI generation. Requires skills; the resulting sequence must stay within 20 rounds. Optional source_stage {stage: interview_sequence, version} returns 409 when stale.

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action', 'resource', 'input'], 'properties': {'input': {'type': 'object', 'required': ['items'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'maxLength': 128}, 'name': {'type': 'string', 'maxLength': 300}, 'round': {'type': 'string', 'maxLength': 300}, 'title': {'type': 'string', 'maxLength': 300}, 'purpose': {'type': 'string', 'maxLength': 5000}, 'duration': {'type': 'integer', 'maximum': 480, 'minimum': 0}, 'description': {'type': 'string', 'maxLength': 5000}, 'primaryFocus': {'type': 'string', 'maxLength': 500}, 'questionTypes': {'type': 'array', 'items': {'type': 'string', 'maxLength': 300}, 'maxItems': 50}, 'interviewerGuidance': {'type': 'string', 'maxLength': 5000}, 'recommendedQuestionCount': {'type': 'integer', 'maximum': 100, 'minimum': 0}}, 'additionalProperties': False}, 'maxItems': 20, 'minItems': 1}, 'source_stage': {'type': 'object', 'required': ['stage'], 'properties': {'stage': {'type': 'string', 'const': 'interview_sequence'}, 'version': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'action': {'type': 'string', 'const': 'interview_plan.add_rounds'}, 'resource': {'type': 'object', 'required': ['type', 'id'], 'properties': {'id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$'}, 'type': {'type': 'string', 'const': 'interview_plan_draft'}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plan_drafts_add_skills

Add job skills to an interview plan draft

Add job skills to a draft exactly as written — deterministic, no AI generation. Requires competencies; the resulting stage must stay within 50 skills. Optional source_stage {stage: skills, version} returns 409 when stale.

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action', 'resource', 'input'], 'properties': {'input': {'type': 'object', 'required': ['items'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'maxLength': 128}, 'name': {'type': 'string', 'maxLength': 300}, 'skill': {'type': 'string', 'maxLength': 300}, 'title': {'type': 'string', 'maxLength': 300}, 'details': {'type': 'string', 'maxLength': 5000}, 'category': {'type': 'string', 'maxLength': 128}, 'description': {'type': 'string', 'maxLength': 5000}, 'requirement': {'type': 'string', 'maxLength': 5000}}, 'additionalProperties': False}, 'maxItems': 50, 'minItems': 1}, 'source_stage': {'type': 'object', 'required': ['stage'], 'properties': {'stage': {'type': 'string', 'const': 'skills'}, 'version': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'action': {'type': 'string', 'const': 'interview_plan.add_skills'}, 'resource': {'type': 'object', 'required': ['type', 'id'], 'properties': {'id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$'}, 'type': {'type': 'string', 'const': 'interview_plan_draft'}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plan_drafts_clear_competencies

Clear all draft competencies, leaving the section empty

Clear every competency from a draft, leaving the stage deliberately empty — deterministic, no AI generation. Prunes the behavioral anchors of every cleared competency in the same write and reports the pruned ids. The emptied draft cannot be published as a new plan; bind the emptying onto an already-live plan with modify_active. Optional source_stage {stage: competencies, version} returns 409 when stale.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action', 'resource', 'input'], 'properties': {'input': {'type': 'object', 'properties': {'source_stage': {'type': 'object', 'required': ['stage'], 'properties': {'stage': {'type': 'string', 'const': 'competencies'}, 'version': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'action': {'type': 'string', 'const': 'interview_plan.clear_competencies'}, 'resource': {'type': 'object', 'required': ['type', 'id'], 'properties': {'id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$'}, 'type': {'type': 'string', 'const': 'interview_plan_draft'}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plan_drafts_clear_interview_sequence

Clear all draft interview rounds, leaving the section empty

Clear every interview round from a draft, leaving the stage deliberately empty — deterministic, no AI generation. Prunes the questions and directions of every cleared round in the same write and reports the pruned round ids. The emptied draft cannot be published as a new plan; bind the emptying onto an already-live plan with modify_active. Optional source_stage {stage: interview_sequence, version} returns 409 when stale.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action', 'resource', 'input'], 'properties': {'input': {'type': 'object', 'properties': {'source_stage': {'type': 'object', 'required': ['stage'], 'properties': {'stage': {'type': 'string', 'const': 'interview_sequence'}, 'version': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'action': {'type': 'string', 'const': 'interview_plan.clear_interview_sequence'}, 'resource': {'type': 'object', 'required': ['type', 'id'], 'properties': {'id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$'}, 'type': {'type': 'string', 'const': 'interview_plan_draft'}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plan_drafts_clear_job_skills

Clear all draft job skills, leaving the section empty

Clear every job skill from a draft, leaving the stage deliberately empty — deterministic, no AI generation. The item delete refuses to remove the last skill, so this is the only way to record that the section was addressed and left empty. The emptied draft cannot be published as a new plan; bind the emptying onto an already-live plan with modify_active. Optional source_stage {stage: skills, version} returns 409 when stale.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action', 'resource', 'input'], 'properties': {'input': {'type': 'object', 'properties': {'source_stage': {'type': 'object', 'required': ['stage'], 'properties': {'stage': {'type': 'string', 'const': 'skills'}, 'version': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'action': {'type': 'string', 'const': 'interview_plan.clear_job_skills'}, 'resource': {'type': 'object', 'required': ['type', 'id'], 'properties': {'id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$'}, 'type': {'type': 'string', 'const': 'interview_plan_draft'}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plan_drafts_clear_outcomes

Clear all draft outcomes, leaving the section empty

Clear every outcome from a draft, leaving the stage deliberately empty — deterministic, no AI generation. Outcomes have no item-level delete, and confirm_outcomes requires at least one outcome, so this is the only way to record that the section was addressed and left empty. The emptied draft cannot be published as a new plan; bind the emptying onto an already-live plan with modify_active. Optional source_stage {stage: outcomes, version} returns 409 when stale.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action', 'resource', 'input'], 'properties': {'input': {'type': 'object', 'properties': {'source_stage': {'type': 'object', 'required': ['stage'], 'properties': {'stage': {'type': 'string', 'const': 'outcomes'}, 'version': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'action': {'type': 'string', 'const': 'interview_plan.clear_outcomes'}, 'resource': {'type': 'object', 'required': ['type', 'id'], 'properties': {'id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$'}, 'type': {'type': 'string', 'const': 'interview_plan_draft'}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plan_drafts_confirm_outcomes

Confirm draft hiring outcomes

Confirm draft interview-plan outcomes before generating later stages.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action', 'resource', 'input'], 'properties': {'input': {'type': 'object', 'required': ['accepted_outcomes'], 'properties': {'source_stage': {'type': 'object', 'required': ['stage'], 'properties': {'stage': {'enum': ['role_context', 'outcomes', 'competencies', 'skills'], 'type': 'string'}, 'version': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'revision_notes': {'type': 'string', 'maxLength': 10000}, 'accepted_outcomes': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'maxLength': 128}, 'tag': {'type': 'string', 'maxLength': 128}, 'text': {'type': 'string', 'maxLength': 500, 'minLength': 1}, 'title': {'type': 'string', 'maxLength': 500, 'minLength': 1}, 'priority': {'type': 'string', 'maxLength': 128}, 'description': {'type': 'string', 'maxLength': 5000}}, 'additionalProperties': False}, 'maxItems': 25, 'minItems': 1}}, 'additionalProperties': False}, 'action': {'type': 'string', 'const': 'interview_plan.confirm_outcomes'}, 'resource': {'type': 'object', 'required': ['type', 'id'], 'properties': {'id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$'}, 'type': {'type': 'string', 'const': 'interview_plan_draft'}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plan_drafts_delete_anchors

Delete draft scorecard anchors

Delete behavioral-anchor entries for draft items by item id. Optional source_stage {stage: questions_and_directions, version} returns 409 when stale.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action', 'resource', 'input'], 'properties': {'input': {'type': 'object', 'required': ['item_ids'], 'properties': {'item_ids': {'type': 'array', 'items': {'type': 'string', 'maxLength': 128, 'minLength': 1}, 'maxItems': 100, 'minItems': 1}, 'source_stage': {'type': 'object', 'required': ['stage'], 'properties': {'stage': {'type': 'string', 'const': 'questions_and_directions'}, 'version': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'action': {'type': 'string', 'const': 'interview_plan.delete_anchors'}, 'resource': {'type': 'object', 'required': ['type', 'id'], 'properties': {'id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$'}, 'type': {'type': 'string', 'const': 'interview_plan_draft'}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plan_drafts_delete_competencies

Delete draft competencies

Delete draft competencies by id. Prunes each deleted competency's behavioral anchors in the same write and reports the pruned ids; the stage must keep at least one competency. Optional source_stage {stage: competencies, version} returns 409 when stale.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action', 'resource', 'input'], 'properties': {'input': {'type': 'object', 'required': ['ids'], 'properties': {'ids': {'type': 'array', 'items': {'type': 'string', 'maxLength': 128, 'minLength': 1}, 'maxItems': 25, 'minItems': 1}, 'source_stage': {'type': 'object', 'required': ['stage'], 'properties': {'stage': {'type': 'string', 'const': 'competencies'}, 'version': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'action': {'type': 'string', 'const': 'interview_plan.delete_competencies'}, 'resource': {'type': 'object', 'required': ['type', 'id'], 'properties': {'id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$'}, 'type': {'type': 'string', 'const': 'interview_plan_draft'}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plan_drafts_delete_questions

Delete questions from a draft interview round

Delete questions from one draft round by question id. Optional source_stage {stage: questions_and_directions, version} returns 409 when stale.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action', 'resource', 'input'], 'properties': {'input': {'type': 'object', 'required': ['round_id', 'ids'], 'properties': {'ids': {'type': 'array', 'items': {'type': 'string', 'maxLength': 128, 'minLength': 1}, 'maxItems': 50, 'minItems': 1}, 'round_id': {'type': 'string', 'maxLength': 128, 'minLength': 1}, 'source_stage': {'type': 'object', 'required': ['stage'], 'properties': {'stage': {'type': 'string', 'const': 'questions_and_directions'}, 'version': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'action': {'type': 'string', 'const': 'interview_plan.delete_questions'}, 'resource': {'type': 'object', 'required': ['type', 'id'], 'properties': {'id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$'}, 'type': {'type': 'string', 'const': 'interview_plan_draft'}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plan_drafts_delete_rounds

Delete draft interview rounds

Delete draft interview rounds by id. Prunes each deleted round's questions and directions in the same write and reports the pruned ids; the sequence must keep at least one round. Optional source_stage {stage: interview_sequence, version} returns 409 when stale.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action', 'resource', 'input'], 'properties': {'input': {'type': 'object', 'required': ['ids'], 'properties': {'ids': {'type': 'array', 'items': {'type': 'string', 'maxLength': 128, 'minLength': 1}, 'maxItems': 20, 'minItems': 1}, 'source_stage': {'type': 'object', 'required': ['stage'], 'properties': {'stage': {'type': 'string', 'const': 'interview_sequence'}, 'version': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'action': {'type': 'string', 'const': 'interview_plan.delete_rounds'}, 'resource': {'type': 'object', 'required': ['type', 'id'], 'properties': {'id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$'}, 'type': {'type': 'string', 'const': 'interview_plan_draft'}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plan_drafts_delete_skills

Delete draft job skills

Delete draft job skills by id; the stage must keep at least one skill. Optional source_stage {stage: skills, version} returns 409 when stale.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action', 'resource', 'input'], 'properties': {'input': {'type': 'object', 'required': ['ids'], 'properties': {'ids': {'type': 'array', 'items': {'type': 'string', 'maxLength': 128, 'minLength': 1}, 'maxItems': 50, 'minItems': 1}, 'source_stage': {'type': 'object', 'required': ['stage'], 'properties': {'stage': {'type': 'string', 'const': 'skills'}, 'version': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'action': {'type': 'string', 'const': 'interview_plan.delete_skills'}, 'resource': {'type': 'object', 'required': ['type', 'id'], 'properties': {'id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$'}, 'type': {'type': 'string', 'const': 'interview_plan_draft'}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plan_drafts_generate_anchors

Generate draft scorecard anchors

Generate scorecard behavioral anchors (levels 1-4) for each draft competency, or one competency when competency_id is supplied.

可能执行破坏性操作

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action', 'resource', 'input'], 'properties': {'input': {'type': 'object', 'properties': {'instructions': {'type': 'string', 'maxLength': 10000}, 'source_stage': {'type': 'object', 'required': ['stage'], 'properties': {'stage': {'type': 'string', 'const': 'competencies'}, 'version': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'competency_id': {'type': 'string', 'maxLength': 128}}, 'additionalProperties': False}, 'action': {'type': 'string', 'const': 'interview_plan.generate_anchors'}, 'resource': {'type': 'object', 'required': ['type', 'id'], 'properties': {'id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$'}, 'type': {'type': 'string', 'const': 'interview_plan_draft'}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plan_drafts_generate_competencies

Generate draft competencies

Generate draft interview-plan competencies from confirmed outcomes.

可能执行破坏性操作

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action', 'resource', 'input'], 'properties': {'input': {'type': 'object', 'properties': {'outcome_ids': {'type': 'array', 'items': {'type': 'string', 'maxLength': 128}, 'maxItems': 50}, 'instructions': {'type': 'string', 'maxLength': 10000}, 'source_stage': {'type': 'object', 'required': ['stage'], 'properties': {'stage': {'type': 'string', 'const': 'outcomes'}, 'version': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'action': {'type': 'string', 'const': 'interview_plan.generate_competencies'}, 'resource': {'type': 'object', 'required': ['type', 'id'], 'properties': {'id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$'}, 'type': {'type': 'string', 'const': 'interview_plan_draft'}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plan_drafts_generate_outcomes

Generate draft hiring outcomes

Generate draft interview-plan outcomes from explicit role context, or pass accepted_outcomes to store caller-written outcomes verbatim with no AI generation (the deterministic draft bootstrap).

可能执行破坏性操作

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action', 'input'], 'properties': {'input': {'type': 'object', 'required': ['role_context'], 'properties': {'instructions': {'type': 'string', 'maxLength': 10000}, 'role_context': {'type': 'object', 'properties': {'title': {'type': 'string', 'maxLength': 300}, 'role_title': {'type': 'string', 'maxLength': 300}, 'additional_context': {'type': 'string', 'maxLength': 20000}, 'organization_context': {'type': 'string', 'maxLength': 10000}}, 'additionalProperties': False}, 'source_job_id': {'type': 'string'}, 'accepted_outcomes': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'maxLength': 128}, 'tag': {'type': 'string', 'maxLength': 128}, 'text': {'type': 'string', 'maxLength': 500, 'minLength': 1}, 'title': {'type': 'string', 'maxLength': 500, 'minLength': 1}, 'priority': {'type': 'string', 'maxLength': 128}, 'description': {'type': 'string', 'maxLength': 5000}}, 'additionalProperties': False}, 'maxItems': 25, 'minItems': 1}}, 'additionalProperties': False}, 'action': {'type': 'string', 'const': 'interview_plan.generate_outcomes'}, 'resource': {'type': 'object', 'required': ['type'], 'properties': {'id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$'}, 'type': {'type': 'string', 'const': 'interview_plan_draft'}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plan_drafts_generate_questions_directions

Generate draft questions and interviewer directions

Generate interview questions and interviewer/candidate directions for each draft round, or one round when round_id is supplied.

可能执行破坏性操作

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action', 'resource', 'input'], 'properties': {'input': {'type': 'object', 'properties': {'round_id': {'type': 'string', 'maxLength': 128}, 'instructions': {'type': 'string', 'maxLength': 10000}, 'source_stage': {'type': 'object', 'required': ['stage'], 'properties': {'stage': {'type': 'string', 'const': 'interview_sequence'}, 'version': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'action': {'type': 'string', 'const': 'interview_plan.generate_questions_directions'}, 'resource': {'type': 'object', 'required': ['type', 'id'], 'properties': {'id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$'}, 'type': {'type': 'string', 'const': 'interview_plan_draft'}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plan_drafts_generate_rounds

Generate draft interview rounds

Generate draft interview-plan rounds from confirmed skills.

可能执行破坏性操作

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action', 'resource', 'input'], 'properties': {'input': {'type': 'object', 'properties': {'instructions': {'type': 'string', 'maxLength': 10000}, 'source_stage': {'type': 'object', 'required': ['stage'], 'properties': {'stage': {'type': 'string', 'const': 'skills'}, 'version': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'accepted_rounds': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'maxLength': 128}, 'name': {'type': 'string', 'maxLength': 300}, 'round': {'type': 'string', 'maxLength': 300}, 'title': {'type': 'string', 'maxLength': 300}, 'purpose': {'type': 'string', 'maxLength': 5000}, 'duration': {'type': 'integer', 'maximum': 480, 'minimum': 0}, 'description': {'type': 'string', 'maxLength': 5000}, 'primaryFocus': {'type': 'string', 'maxLength': 500}, 'questionTypes': {'type': 'array', 'items': {'type': 'string', 'maxLength': 300}, 'maxItems': 50}, 'interviewerGuidance': {'type': 'string', 'maxLength': 5000}, 'recommendedQuestionCount': {'type': 'integer', 'maximum': 100, 'minimum': 0}}, 'additionalProperties': False}, 'maxItems': 20, 'minItems': 1}}, 'additionalProperties': False}, 'action': {'type': 'string', 'const': 'interview_plan.generate_rounds'}, 'resource': {'type': 'object', 'required': ['type', 'id'], 'properties': {'id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$'}, 'type': {'type': 'string', 'const': 'interview_plan_draft'}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plan_drafts_generate_skills

Generate draft job skills

Generate draft interview-plan skills from confirmed competencies.

可能执行破坏性操作

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action', 'resource', 'input'], 'properties': {'input': {'type': 'object', 'properties': {'instructions': {'type': 'string', 'maxLength': 10000}, 'source_stage': {'type': 'object', 'required': ['stage'], 'properties': {'stage': {'type': 'string', 'const': 'competencies'}, 'version': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'accepted_skills': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'maxLength': 128}, 'name': {'type': 'string', 'maxLength': 300}, 'skill': {'type': 'string', 'maxLength': 300}, 'title': {'type': 'string', 'maxLength': 300}, 'details': {'type': 'string', 'maxLength': 5000}, 'category': {'type': 'string', 'maxLength': 128}, 'description': {'type': 'string', 'maxLength': 5000}, 'requirement': {'type': 'string', 'maxLength': 5000}}, 'additionalProperties': False}, 'maxItems': 50, 'minItems': 1}}, 'additionalProperties': False}, 'action': {'type': 'string', 'const': 'interview_plan.generate_skills'}, 'resource': {'type': 'object', 'required': ['type', 'id'], 'properties': {'id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$'}, 'type': {'type': 'string', 'const': 'interview_plan_draft'}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plan_drafts_list

List interview plan drafts

List interview-plan drafts, newest first. Optional job_id narrows the list to one job and takes a job_ public display id. Use this to find an ipd_ draft id again after an interrupted builder session.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'job_id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'starting_after': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plan_drafts_read

Read an interview plan draft

Read one interview-plan draft in full: every stage checkpoint (outcomes, competencies, job skills, interview sequence, questions and directions), stage_versions for source_stage preconditions, status, and source metadata. Question ids are always present (question_N fallback), so edits can target them directly.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['draft_id'], 'properties': {'draft_id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plan_drafts_update_anchors

Set draft scorecard anchors

Upsert behavioral anchors for draft items, keyed by item id with levels 1-4 — deterministic, no AI generation. Requires competencies; anchors keyed to unknown item ids are rejected by id. Optional source_stage {stage: questions_and_directions, version} returns 409 when stale.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action', 'resource', 'input'], 'properties': {'input': {'type': 'object', 'required': ['anchors'], 'properties': {'anchors': {'type': 'object', 'propertyNames': {'maxLength': 128, 'minLength': 1}, 'additionalProperties': {'type': 'array', 'items': {'type': 'object', 'required': ['level', 'description'], 'properties': {'level': {'type': 'integer', 'maximum': 4, 'minimum': 1}, 'description': {'type': 'string', 'maxLength': 5000, 'minLength': 1}}, 'additionalProperties': False}, 'maxItems': 4, 'minItems': 1}}, 'source_stage': {'type': 'object', 'required': ['stage'], 'properties': {'stage': {'type': 'string', 'const': 'questions_and_directions'}, 'version': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'action': {'type': 'string', 'const': 'interview_plan.update_anchors'}, 'resource': {'type': 'object', 'required': ['type', 'id'], 'properties': {'id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$'}, 'type': {'type': 'string', 'const': 'interview_plan_draft'}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plan_drafts_update_competencies

Rewrite or reorder draft competencies

Replace draft competencies by id and/or reorder them with order (a complete permutation of resulting ids) — deterministic, no AI generation. Updating in place keeps the item id. Optional source_stage {stage: competencies, version} returns 409 when stale.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action', 'resource', 'input'], 'properties': {'input': {'type': 'object', 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'maxLength': 128}, 'name': {'type': 'string', 'maxLength': 300}, 'title': {'type': 'string', 'maxLength': 300}, 'details': {'type': 'string', 'maxLength': 5000}, 'competency': {'type': 'string', 'maxLength': 300}, 'definition': {'type': 'string', 'maxLength': 5000}, 'description': {'type': 'string', 'maxLength': 5000}}, 'additionalProperties': False}, 'maxItems': 25}, 'order': {'type': 'array', 'items': {'type': 'string', 'maxLength': 128, 'minLength': 1}, 'maxItems': 25, 'minItems': 1}, 'source_stage': {'type': 'object', 'required': ['stage'], 'properties': {'stage': {'type': 'string', 'const': 'competencies'}, 'version': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'action': {'type': 'string', 'const': 'interview_plan.update_competencies'}, 'resource': {'type': 'object', 'required': ['type', 'id'], 'properties': {'id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$'}, 'type': {'type': 'string', 'const': 'interview_plan_draft'}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plan_drafts_update_questions

Rewrite or reorder a draft round's questions

Replace one draft round's questions by id and/or reorder them with order (a complete permutation of that round's resulting question ids) — deterministic, no AI generation. Read the draft first: stored questions expose stable question_N ids. Optional source_stage {stage: questions_and_directions, version} returns 409 when stale.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action', 'resource', 'input'], 'properties': {'input': {'type': 'object', 'required': ['round_id'], 'properties': {'order': {'type': 'array', 'items': {'type': 'string', 'maxLength': 128, 'minLength': 1}, 'maxItems': 50, 'minItems': 1}, 'round_id': {'type': 'string', 'maxLength': 128, 'minLength': 1}, 'questions': {'type': 'array', 'items': {'type': 'object', 'required': ['text'], 'properties': {'id': {'type': 'string', 'maxLength': 128}, 'tags': {'type': 'array', 'items': {'type': 'string', 'maxLength': 128}, 'maxItems': 20}, 'text': {'type': 'string', 'maxLength': 5000, 'minLength': 1}, 'guidance': {'type': 'string', 'maxLength': 10000}, 'followUpQuestions': {'type': 'array', 'items': {'type': 'string', 'maxLength': 2000}, 'maxItems': 20}}, 'additionalProperties': False}, 'maxItems': 50}, 'source_stage': {'type': 'object', 'required': ['stage'], 'properties': {'stage': {'type': 'string', 'const': 'questions_and_directions'}, 'version': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'action': {'type': 'string', 'const': 'interview_plan.update_questions'}, 'resource': {'type': 'object', 'required': ['type', 'id'], 'properties': {'id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$'}, 'type': {'type': 'string', 'const': 'interview_plan_draft'}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plan_drafts_update_round_directions

Set a draft round's interviewer and candidate directions

Set one draft round's interviewer and/or candidate directions exactly as written — deterministic, no AI generation. Provide at least one of the two direction fields. Optional source_stage {stage: questions_and_directions, version} returns 409 when stale.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action', 'resource', 'input'], 'properties': {'input': {'type': 'object', 'required': ['round_id'], 'properties': {'round_id': {'type': 'string', 'maxLength': 128, 'minLength': 1}, 'source_stage': {'type': 'object', 'required': ['stage'], 'properties': {'stage': {'type': 'string', 'const': 'questions_and_directions'}, 'version': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'candidate_directions': {'type': 'string', 'maxLength': 20000}, 'interviewer_directions': {'type': 'string', 'maxLength': 20000}}, 'additionalProperties': False}, 'action': {'type': 'string', 'const': 'interview_plan.update_round_directions'}, 'resource': {'type': 'object', 'required': ['type', 'id'], 'properties': {'id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$'}, 'type': {'type': 'string', 'const': 'interview_plan_draft'}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plan_drafts_update_rounds

Rewrite or reorder draft interview rounds

Replace draft interview rounds by id and/or reorder them with order (a complete permutation of resulting ids) — deterministic, no AI generation. A round updated in place keeps its id, so its questions and directions are preserved (not pruned). Optional source_stage {stage: interview_sequence, version} returns 409 when stale.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action', 'resource', 'input'], 'properties': {'input': {'type': 'object', 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'maxLength': 128}, 'name': {'type': 'string', 'maxLength': 300}, 'round': {'type': 'string', 'maxLength': 300}, 'title': {'type': 'string', 'maxLength': 300}, 'purpose': {'type': 'string', 'maxLength': 5000}, 'duration': {'type': 'integer', 'maximum': 480, 'minimum': 0}, 'description': {'type': 'string', 'maxLength': 5000}, 'primaryFocus': {'type': 'string', 'maxLength': 500}, 'questionTypes': {'type': 'array', 'items': {'type': 'string', 'maxLength': 300}, 'maxItems': 50}, 'interviewerGuidance': {'type': 'string', 'maxLength': 5000}, 'recommendedQuestionCount': {'type': 'integer', 'maximum': 100, 'minimum': 0}}, 'additionalProperties': False}, 'maxItems': 20}, 'order': {'type': 'array', 'items': {'type': 'string', 'maxLength': 128, 'minLength': 1}, 'maxItems': 20, 'minItems': 1}, 'source_stage': {'type': 'object', 'required': ['stage'], 'properties': {'stage': {'type': 'string', 'const': 'interview_sequence'}, 'version': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'action': {'type': 'string', 'const': 'interview_plan.update_rounds'}, 'resource': {'type': 'object', 'required': ['type', 'id'], 'properties': {'id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$'}, 'type': {'type': 'string', 'const': 'interview_plan_draft'}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plan_drafts_update_skills

Rewrite or reorder draft job skills

Replace draft job skills by id and/or reorder them with order (a complete permutation of resulting ids) — deterministic, no AI generation. Optional source_stage {stage: skills, version} returns 409 when stale.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action', 'resource', 'input'], 'properties': {'input': {'type': 'object', 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'maxLength': 128}, 'name': {'type': 'string', 'maxLength': 300}, 'skill': {'type': 'string', 'maxLength': 300}, 'title': {'type': 'string', 'maxLength': 300}, 'details': {'type': 'string', 'maxLength': 5000}, 'category': {'type': 'string', 'maxLength': 128}, 'description': {'type': 'string', 'maxLength': 5000}, 'requirement': {'type': 'string', 'maxLength': 5000}}, 'additionalProperties': False}, 'maxItems': 50}, 'order': {'type': 'array', 'items': {'type': 'string', 'maxLength': 128, 'minLength': 1}, 'maxItems': 50, 'minItems': 1}, 'source_stage': {'type': 'object', 'required': ['stage'], 'properties': {'stage': {'type': 'string', 'const': 'skills'}, 'version': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'action': {'type': 'string', 'const': 'interview_plan.update_skills'}, 'resource': {'type': 'object', 'required': ['type', 'id'], 'properties': {'id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$'}, 'type': {'type': 'string', 'const': 'interview_plan_draft'}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plan_drafts_validate

Check an interview plan draft for problems

Validate an interview-plan draft without publishing it.

幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action', 'resource', 'input'], 'properties': {'input': {'type': 'object', 'properties': {'include_warnings': {'type': 'boolean'}}, 'additionalProperties': False}, 'action': {'type': 'string', 'const': 'interview_plan.validate_draft'}, 'resource': {'type': 'object', 'required': ['type', 'id'], 'properties': {'id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$'}, 'type': {'type': 'string', 'const': 'interview_plan_draft'}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plans_archive

Archive an interview plan

Archive one interview plan. Already-archived plans succeed without a write. A plan still attached to a job is refused — detach it from the job first.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['interview_plan_id'], 'properties': {'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}, 'interview_plan_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plans_list

List published interview plans

List published interview plans, newest first. Optional job_id narrows the list to one job and takes a job_ public display id. Use this to find an interview plan id when you only hold a job id.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'job_id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'starting_after': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plans_modify_active_bind

Confirm and edit a live interview plan

Bind an already-previewed interview-plan active modification with explicit approval metadata and matching idempotency key.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action', 'input', 'binding'], 'properties': {'input': {'type': 'object', 'required': ['draft_id', 'active_plan_id'], 'properties': {'draft_id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$'}, 'approval_id': {'type': 'string', 'maxLength': 128}, 'active_plan_id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$'}, 'expected_plan_version': {'type': 'integer', 'minimum': 0}, 'expected_draft_version': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'action': {'type': 'string', 'const': 'interview_plan.modify_active'}, 'binding': {'type': 'object', 'required': ['preview_hash', 'approved_action_key', 'approved_input_hash', 'approved_idempotency_key', 'resource_version_precondition'], 'properties': {'preview_hash': {'type': 'string', 'minLength': 1}, 'approved_action_key': {'type': 'string', 'minLength': 1}, 'approved_input_hash': {'type': 'string', 'minLength': 1}, 'approved_idempotency_key': {'type': 'string', 'minLength': 1}, 'resource_version_precondition': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'resource': {'type': 'object', 'required': ['type'], 'properties': {'id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$'}, 'type': {'type': 'string', 'const': 'interview_plan'}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plans_modify_active_preview

Preview editing a live interview plan (nothing changed yet)

Preview interview-plan active-modification approval requirements only; bind fields are rejected.

幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action', 'input'], 'properties': {'input': {'type': 'object', 'required': ['draft_id', 'active_plan_id'], 'properties': {'draft_id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$'}, 'approval_id': {'type': 'string', 'maxLength': 128}, 'active_plan_id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$'}, 'expected_plan_version': {'type': 'integer', 'minimum': 0}, 'expected_draft_version': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'action': {'type': 'string', 'const': 'interview_plan.modify_active'}, 'resource': {'type': 'object', 'required': ['type'], 'properties': {'id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$'}, 'type': {'type': 'string', 'const': 'interview_plan'}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plans_publish_bind

Confirm and publish an interview plan

Bind an already-previewed interview-plan publish with explicit approval metadata and matching idempotency key.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action', 'input', 'binding'], 'properties': {'input': {'type': 'object', 'required': ['draft_id'], 'properties': {'draft_id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$'}, 'approval_id': {'type': 'string', 'maxLength': 128}, 'expected_draft_version': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'action': {'type': 'string', 'const': 'interview_plan.publish'}, 'binding': {'type': 'object', 'required': ['preview_hash', 'approved_action_key', 'approved_input_hash', 'approved_idempotency_key', 'resource_version_precondition'], 'properties': {'preview_hash': {'type': 'string', 'minLength': 1}, 'approved_action_key': {'type': 'string', 'minLength': 1}, 'approved_input_hash': {'type': 'string', 'minLength': 1}, 'approved_idempotency_key': {'type': 'string', 'minLength': 1}, 'resource_version_precondition': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'resource': {'type': 'object', 'required': ['type'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'type': {'type': 'string', 'const': 'interview_plan'}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plans_publish_preview

Preview publishing an interview plan (nothing changed yet)

Preview interview-plan publish approval requirements only; bind fields are rejected.

幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action', 'input'], 'properties': {'input': {'type': 'object', 'required': ['draft_id'], 'properties': {'draft_id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$'}, 'approval_id': {'type': 'string', 'maxLength': 128}, 'expected_draft_version': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'action': {'type': 'string', 'const': 'interview_plan.publish'}, 'resource': {'type': 'object', 'required': ['type'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'type': {'type': 'string', 'const': 'interview_plan'}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plans_read

Read a published interview plan

Read one interview plan by public id.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['interview_plan_id'], 'properties': {'request_id': {'type': 'string', 'minLength': 1}, 'interview_plan_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_plans_unarchive

Restore an archived interview plan

Restore one archived interview plan. Plans that are already live succeed without a write. If the plan's job has since acquired another live plan, the restore is refused and names that plan.

幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['interview_plan_id'], 'properties': {'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}, 'interview_plan_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_sessions_available_interviewers_list

List members assignable as interviewers

List organization members who can be assigned as interviewers, newest membership first. Use this to pick a usr_ public display id before assigning an interviewer.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'starting_after': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_sessions_cancel

Cancel a scheduled interview

Cancel a scheduled interview session, releasing the provider booking and invalidating its scheduling links.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['interview_session_id'], 'properties': {'reason': {'type': 'string', 'maxLength': 500, 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'skip_provider': {'type': 'boolean'}, 'idempotency_key': {'type': 'string', 'minLength': 1}, 'interview_session_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_sessions_complete

Complete an interview

Complete an interview session for an explicit interviewer.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['interview_session_id', 'interviewer_user_id'], 'properties': {'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}, 'interviewer_user_id': {'type': 'string'}, 'interview_session_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_sessions_interviewers_assign

Assign an interviewer to an interview

Assign an interviewer to an interview session.

幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['interview_session_id', 'interviewer_user_id'], 'properties': {'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}, 'interviewer_user_id': {'type': 'string'}, 'interview_session_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_sessions_interviewers_list

List interviewers on an interview

List interviewers assigned to an interview session.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['interview_session_id'], 'properties': {'request_id': {'type': 'string', 'minLength': 1}, 'interview_session_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_sessions_interviewers_unassign

Remove an interviewer from an interview

Unassign an interviewer from an interview session.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['interview_session_id', 'interviewer_user_id'], 'properties': {'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}, 'interviewer_user_id': {'type': 'string'}, 'interview_session_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_sessions_read

Read an interview

Read one interview session by public id.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['interview_session_id'], 'properties': {'request_id': {'type': 'string', 'minLength': 1}, 'interview_session_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_sessions_readiness

Check interview scheduling readiness

Read interview-session scheduling readiness.

幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['interview_session_id'], 'properties': {'request_id': {'type': 'string', 'minLength': 1}, 'interview_session_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_sessions_scheduling_link_generate

Generate a candidate scheduling link

Generate a scheduling link for an interview session.

可能执行破坏性操作

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['interview_session_id'], 'properties': {'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}, 'interview_session_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_sessions_scorecard_submit

Submit an interview scorecard

Submit an interview-session scorecard with explicit ratings.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['interview_session_id', 'interviewer_user_id', 'ratings'], 'properties': {'ratings': {'type': 'array', 'items': {'type': 'object', 'required': ['item_type', 'item_id', 'item_title', 'rating'], 'properties': {'notes': {'type': 'string'}, 'rating': {'type': 'integer', 'maximum': 4, 'minimum': 0}, 'item_id': {'type': 'string', 'minLength': 1}, 'item_type': {'type': 'string', 'minLength': 1}, 'item_title': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'minItems': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'overall_notes': {'type': 'string', 'maxLength': 8000}, 'overall_rating': {'type': 'integer', 'maximum': 5, 'minimum': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}, 'interviewer_user_id': {'type': 'string'}, 'interview_session_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_interview_sessions_start

Start an interview

Start an interview session for an explicit interviewer.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['interview_session_id', 'interviewer_user_id'], 'properties': {'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}, 'interviewer_user_id': {'type': 'string'}, 'interview_session_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_job_postings_archive_bind

Confirm and archive a job posting

Bind an already-previewed job-posting archive with explicit approval metadata and matching idempotency key.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['job_posting_id', 'binding'], 'properties': {'binding': {'type': 'object', 'required': ['preview_hash', 'approved_action_key', 'approved_input_hash', 'approved_idempotency_key', 'resource_version_precondition'], 'properties': {'preview_hash': {'type': 'string', 'minLength': 1}, 'approved_action_key': {'type': 'string', 'minLength': 1}, 'approved_input_hash': {'type': 'string', 'minLength': 1}, 'approved_idempotency_key': {'type': 'string', 'minLength': 1}, 'resource_version_precondition': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'job_posting_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_job_postings_archive_preview

Preview archiving a job posting (nothing changed yet)

Preview job-posting archive approval requirements only; bind fields are rejected.

幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['job_posting_id'], 'properties': {'request_id': {'type': 'string', 'minLength': 1}, 'job_posting_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_job_postings_create

Create a draft job posting

Create a draft job posting through the public Yardstick API.

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['title', 'interview_plan_id', 'slug'], 'properties': {'slug': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'title': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'location': {'type': 'string', 'maxLength': 200}, 'department': {'type': 'string', 'maxLength': 200}, 'request_id': {'type': 'string', 'minLength': 1}, 'salary_max': {'type': 'integer', 'minimum': 0}, 'salary_min': {'type': 'integer', 'minimum': 0}, 'description': {'type': 'string', 'maxLength': 20000}, 'requirements': {'type': 'string', 'maxLength': 20000}, 'location_type': {'enum': ['remote', 'hybrid', 'onsite'], 'type': 'string'}, 'salary_display': {'type': 'boolean'}, 'idempotency_key': {'type': 'string', 'minLength': 1}, 'salary_currency': {'type': 'string', 'maxLength': 8, 'minLength': 3}, 'custom_questions': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'question', 'type', 'required'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'type': {'enum': ['text', 'textarea', 'single-select', 'yes-no'], 'type': 'string'}, 'options': {'type': 'array', 'items': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'maxItems': 50}, 'question': {'type': 'string', 'maxLength': 2000, 'minLength': 1}, 'required': {'type': 'boolean'}}, 'additionalProperties': False}, 'maxItems': 50}, 'location_country': {'type': 'string', 'description': 'Assigned ISO 3166-1 alpha-2 country code.'}, 'interview_plan_id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$', 'description': 'Published interview plan id (ipd_...) returned by `interview-plans publish` — not an interview-plan draft id. The plan must already be attached to a Job via `jobs attach-artifact`.'}}, 'additionalProperties': False}

yardstick_job_postings_list

List job postings

List job postings visible to the current principal.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'starting_after': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_job_postings_publish_bind

Confirm and publish a job posting

Bind an already-previewed job-posting publish with explicit approval metadata and matching idempotency key.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['job_posting_id', 'binding'], 'properties': {'binding': {'type': 'object', 'required': ['preview_hash', 'approved_action_key', 'approved_input_hash', 'approved_idempotency_key', 'resource_version_precondition'], 'properties': {'preview_hash': {'type': 'string', 'minLength': 1}, 'approved_action_key': {'type': 'string', 'minLength': 1}, 'approved_input_hash': {'type': 'string', 'minLength': 1}, 'approved_idempotency_key': {'type': 'string', 'minLength': 1}, 'resource_version_precondition': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'job_posting_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_job_postings_publish_preview

Preview publishing a job posting (nothing changed yet)

Preview job-posting publish approval requirements only; bind fields are rejected.

幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['job_posting_id'], 'properties': {'request_id': {'type': 'string', 'minLength': 1}, 'job_posting_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_job_postings_read

Read a job posting

Read one job posting by public id.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['job_posting_id'], 'properties': {'request_id': {'type': 'string', 'minLength': 1}, 'job_posting_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_job_postings_update

Update a job posting

Update a job posting with schema-bound public API fields.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['job_posting_id'], 'properties': {'slug': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'title': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'location': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'department': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'request_id': {'type': 'string', 'minLength': 1}, 'salary_max': {'anyOf': [{'type': 'integer', 'minimum': 0}, {'type': 'null'}]}, 'salary_min': {'anyOf': [{'type': 'integer', 'minimum': 0}, {'type': 'null'}]}, 'description': {'anyOf': [{'type': 'string', 'maxLength': 20000}, {'type': 'null'}]}, 'requirements': {'anyOf': [{'type': 'string', 'maxLength': 20000}, {'type': 'null'}]}, 'location_type': {'enum': ['remote', 'hybrid', 'onsite'], 'type': 'string'}, 'job_posting_id': {'type': 'string', 'minLength': 1}, 'salary_display': {'type': 'boolean'}, 'idempotency_key': {'type': 'string', 'minLength': 1}, 'salary_currency': {'type': 'string', 'maxLength': 8, 'minLength': 3}, 'custom_questions': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'question', 'type', 'required'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'type': {'enum': ['text', 'textarea', 'single-select', 'yes-no'], 'type': 'string'}, 'options': {'type': 'array', 'items': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'maxItems': 50}, 'question': {'type': 'string', 'maxLength': 2000, 'minLength': 1}, 'required': {'type': 'boolean'}}, 'additionalProperties': False}, 'maxItems': 50}, 'location_country': {'anyOf': [{'type': 'string', 'description': 'Assigned ISO 3166-1 alpha-2 country code.'}, {'type': 'null'}], 'description': 'Assigned ISO 3166-1 alpha-2 country code.'}, 'interview_plan_id': {'type': 'string', 'pattern': '^ipd_[0-9A-Za-z]{16,64}$', 'description': 'Published interview plan id (ipd_...) returned by `interview-plans publish` — not an interview-plan draft id. The plan must already be attached to a Job via `jobs attach-artifact`.'}}, 'additionalProperties': False}

yardstick_job_postings_validate

Check a draft job posting for problems

Validate a draft job posting without mutating it.

幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['job_posting_id'], 'properties': {'request_id': {'type': 'string', 'minLength': 1}, 'job_posting_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_jobs_archive

Archive a job

Archive one Job row only; linked job postings, applications, and interview plans are not mutated.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['job_id'], 'properties': {'job_id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_jobs_attach_artifact

Link an item to a job

Link an existing interview plan, job posting, or application to a Job. Idempotent when already linked to the same Job; conflicts when linked elsewhere. Requires jobs:write and the artifact's own write scope.

幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['job_id', 'artifact_type', 'artifact_id'], 'properties': {'job_id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'artifact_id': {'type': 'string', 'minLength': 1}, 'artifact_type': {'enum': ['interview_plan', 'job_posting', 'application'], 'type': 'string'}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_jobs_close

Close a job

Close one Job row only; linked job postings, applications, and interview plans are not mutated.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['job_id'], 'properties': {'job_id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_jobs_create

Create a job

Create an internal Job container without mutating job postings, applications, or interview plans.

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['title'], 'properties': {'title': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'status': {'enum': ['draft', 'open', 'paused'], 'type': 'string'}, 'location': {'type': 'string', 'maxLength': 200}, 'department': {'type': 'string', 'maxLength': 200}, 'request_id': {'type': 'string', 'minLength': 1}, 'description': {'type': 'string', 'maxLength': 20000}, 'department_id': {'anyOf': [{'type': 'string', 'pattern': '^dpt_[a-z0-9]+$'}, {'type': 'null'}]}, 'location_type': {'enum': ['remote', 'hybrid', 'onsite'], 'type': 'string'}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_jobs_detach_artifact

Unlink an item from a job

Clear the link between an artifact and a Job. Idempotent when already unlinked. Requires jobs:write and the artifact's own write scope.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['job_id', 'artifact_type', 'artifact_id'], 'properties': {'job_id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'artifact_id': {'type': 'string', 'minLength': 1}, 'artifact_type': {'enum': ['interview_plan', 'job_posting', 'application'], 'type': 'string'}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_jobs_list

List jobs

List internal Job containers visible to the current principal.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'starting_after': {'type': 'string', 'minLength': 1}, 'include_archived': {'type': 'boolean'}}, 'additionalProperties': False}

yardstick_jobs_prospect_matches

List prospect matches for a job

List deterministic Talent CRM prospect matches for one Job. Read-only; includes evidence, caveats, and blocked lifecycle states without outreach, conversion, import, or AI ranking.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['job_id'], 'properties': {'job_id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_jobs_read

Read a job

Read one internal Job container by public id.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['job_id'], 'properties': {'job_id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_jobs_update

Update a job

Update one internal Job container with schema-bound public API fields.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['job_id'], 'properties': {'title': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'job_id': {'type': 'string', 'minLength': 1}, 'status': {'enum': ['draft', 'open', 'paused'], 'type': 'string'}, 'location': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'department': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'request_id': {'type': 'string', 'minLength': 1}, 'description': {'anyOf': [{'type': 'string', 'maxLength': 20000}, {'type': 'null'}]}, 'department_id': {'anyOf': [{'type': 'string', 'pattern': '^dpt_[a-z0-9]+$'}, {'type': 'null'}]}, 'location_type': {'anyOf': [{'enum': ['remote', 'hybrid', 'onsite'], 'type': 'string'}, {'type': 'null'}]}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_opportunities_deep_link

Get a link that opens an opportunity in Yardstick

Create a public deep link for an opportunity workflow view.

幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['opportunity_id'], 'properties': {'request_id': {'type': 'string', 'minLength': 1}, 'opportunity_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_opportunities_list

List opportunities

List read-only opportunity workflow views visible to the current principal.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'starting_after': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_opportunities_next_action

Check the next action on an opportunity

Read the next action state for an opportunity without mutating it.

幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['opportunity_id'], 'properties': {'request_id': {'type': 'string', 'minLength': 1}, 'opportunity_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_opportunities_read

Read an opportunity

Read one read-only opportunity workflow view by public id.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['opportunity_id'], 'properties': {'request_id': {'type': 'string', 'minLength': 1}, 'opportunity_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_people_create

Add a person

Create a person through the public Yardstick API.

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'name': {'type': 'string', 'maxLength': 500}, 'email': {'type': 'string', 'format': 'email', 'maxLength': 320}, 'notes': {'type': 'string', 'maxLength': 10000}, 'phone': {'type': 'string', 'maxLength': 50}, 'request_id': {'type': 'string', 'minLength': 1}, 'resume_url': {'type': 'string', 'format': 'uri', 'maxLength': 2048}, 'linkedin_url': {'type': 'string', 'format': 'uri', 'maxLength': 2048}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_people_list

List people

List people visible to the current principal. Pass email to find the exact person behind a candidate_email_conflict.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'email': {'type': 'string', 'format': 'email', 'maxLength': 320}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'starting_after': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_people_read

Read a person

Read one person by public id.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['person_id'], 'properties': {'person_id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_people_update

Update a person

Update one person with schema-bound public API fields.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['person_id'], 'properties': {'name': {'type': 'string', 'maxLength': 500}, 'email': {'type': 'string', 'format': 'email', 'maxLength': 320}, 'notes': {'anyOf': [{'type': 'string', 'maxLength': 10000}, {'type': 'null'}]}, 'phone': {'anyOf': [{'type': 'string', 'maxLength': 50}, {'type': 'null'}]}, 'person_id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'resume_url': {'anyOf': [{'type': 'string', 'format': 'uri', 'maxLength': 2048}, {'type': 'null'}]}, 'linkedin_url': {'anyOf': [{'type': 'string', 'format': 'uri', 'maxLength': 2048}, {'type': 'null'}]}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_pipelines_assign_to_job

Assign a hiring pipeline to a job

Assign a pipeline to a job (jobs.pipeline_template_id) or clear it with pipeline_id: null. Pipeline validated by org; job resolved by org+mode.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['job_id', 'pipeline_id'], 'properties': {'job_id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'pipeline_id': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}]}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_pipelines_create

Create a hiring pipeline

Create a custom pipeline template with optional inline stages. Does not affect the org default pipeline or candidate tracking.

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['name', 'slug'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'slug': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9_]{0,62}$'}, 'stages': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'slug', 'stage_kind'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'slug': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9_]{0,62}$'}, 'stage_kind': {'enum': ['normal', 'offer', 'hired', 'rejected', 'terminal'], 'type': 'string'}, 'is_terminal': {'type': 'boolean'}, 'approval_scope': {'anyOf': [{'enum': ['applications:offer', 'applications:hire', 'applications:reject', 'applications:withdraw'], 'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 100}, 'request_id': {'type': 'string', 'minLength': 1}, 'description': {'anyOf': [{'type': 'string', 'maxLength': 2000}, {'type': 'null'}]}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_pipelines_list

List hiring pipelines

List the organization's pipeline templates with their ordered stages. Canonical default stages are flagged canonical_locked.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'request_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_pipelines_read

Read a hiring pipeline

Read one pipeline template and its ordered stages by public id.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['pipeline_id'], 'properties': {'request_id': {'type': 'string', 'minLength': 1}, 'pipeline_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_pipelines_reorder_stages

Reorder hiring pipeline stages

Reorder all stages of a pipeline by supplying the complete stage id order. Constraint-safe; allowed for canonical stages.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['pipeline_id', 'stage_ids'], 'properties': {'stage_ids': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 200, 'minItems': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'pipeline_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_pipelines_stages_create

Add a stage to a hiring pipeline

Append (or insert at a position) a stage to a pipeline with a kind and optional approval scope.

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['pipeline_id', 'name', 'slug', 'stage_kind'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'slug': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9_]{0,62}$'}, 'position': {'type': 'integer', 'minimum': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'stage_kind': {'enum': ['normal', 'offer', 'hired', 'rejected', 'terminal'], 'type': 'string'}, 'is_terminal': {'type': 'boolean'}, 'pipeline_id': {'type': 'string', 'minLength': 1}, 'approval_scope': {'anyOf': [{'enum': ['applications:offer', 'applications:hire', 'applications:reject', 'applications:withdraw'], 'type': 'string'}, {'type': 'null'}]}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_pipelines_stages_delete_bind

Confirm and delete a hiring pipeline stage

Bind an approved pipeline-stage delete with explicit approval metadata and a matching idempotency key. Refuses while candidates remain.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['pipeline_id', 'stage_id', 'binding'], 'properties': {'binding': {'type': 'object', 'required': ['preview_hash', 'approved_action_key', 'approved_input_hash', 'approved_idempotency_key', 'resource_version_precondition'], 'properties': {'preview_hash': {'type': 'string', 'minLength': 1}, 'approved_action_key': {'type': 'string', 'minLength': 1}, 'approved_input_hash': {'type': 'string', 'minLength': 1}, 'approved_idempotency_key': {'type': 'string', 'minLength': 1}, 'resource_version_precondition': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'stage_id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'pipeline_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_pipelines_stages_delete_preview

Preview deleting a hiring pipeline stage (nothing changed yet)

Preview deleting a pipeline stage; returns the candidate-count impact and binding fields. Canonical default stages are rejected.

幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['pipeline_id', 'stage_id'], 'properties': {'stage_id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'pipeline_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_pipelines_stages_update

Edit a hiring pipeline stage

Edit a pipeline stage. Canonical default stages allow display-name change only; slug/stage_kind/approval_scope/is_terminal are locked.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['pipeline_id', 'stage_id'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'slug': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9_]{0,62}$'}, 'stage_id': {'type': 'string', 'minLength': 1}, 'is_active': {'type': 'boolean'}, 'request_id': {'type': 'string', 'minLength': 1}, 'stage_kind': {'enum': ['normal', 'offer', 'hired', 'rejected', 'terminal'], 'type': 'string'}, 'is_terminal': {'type': 'boolean'}, 'pipeline_id': {'type': 'string', 'minLength': 1}, 'approval_scope': {'anyOf': [{'enum': ['applications:offer', 'applications:hire', 'applications:reject', 'applications:withdraw'], 'type': 'string'}, {'type': 'null'}]}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_pipelines_update

Update a hiring pipeline

Rename, re-describe, or toggle active for one pipeline template.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['pipeline_id'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'is_active': {'type': 'boolean'}, 'request_id': {'type': 'string', 'minLength': 1}, 'description': {'anyOf': [{'type': 'string', 'maxLength': 2000}, {'type': 'null'}]}, 'pipeline_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_prospect_activities_create

Log prospect activity

Create a bounded internal prospect activity note or touchpoint.

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['prospect_id'], 'properties': {'body': {'anyOf': [{'type': 'string', 'maxLength': 4000}, {'type': 'null'}]}, 'metadata': {'type': 'object', 'additionalProperties': {}}, 'request_id': {'type': 'string', 'minLength': 1}, 'occurred_at': {'type': 'string'}, 'prospect_id': {'type': 'string', 'minLength': 1}, 'source_label': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'activity_type': {'enum': ['note', 'call', 'meeting', 'source', 'status_change'], 'type': 'string'}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_prospect_activities_list

List prospect activity

List bounded activity records for one Talent CRM prospect.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['prospect_id'], 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'prospect_id': {'type': 'string', 'minLength': 1}, 'starting_after': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_prospect_imports_apply

Confirm and apply a prospect import

Apply an approved Prospect CRM import preview with preview_hash and explicit row decisions for advisory matches.

幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['import_id', 'preview_hash'], 'properties': {'decisions': {'type': 'array', 'items': {'type': 'object', 'required': ['row_index', 'input_hash', 'decision'], 'properties': {'decision': {'enum': ['create_new', 'link_existing', 'skip'], 'type': 'string'}, 'person_id': {'type': 'string', 'minLength': 1}, 'row_index': {'type': 'integer', 'maximum': 499, 'minimum': 0}, 'input_hash': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'maxItems': 500}, 'import_id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'preview_hash': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_prospect_imports_dry_run

Preview a prospect import (no records written)

Preview a structured-row Prospect CRM import. JSON rows only; no raw CSV/resume file reads, outreach, application conversion, source ranking, or silent person merge.

幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['rows'], 'properties': {'rows': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}, 'email': {'anyOf': [{'type': 'string', 'format': 'email', 'maxLength': 320}, {'type': 'null'}]}, 'notes': {'anyOf': [{'type': 'string', 'maxLength': 10000}, {'type': 'null'}]}, 'phone': {'anyOf': [{'type': 'string', 'maxLength': 50}, {'type': 'null'}]}, 'pool_ids': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 25}, 'pool_names': {'type': 'array', 'items': {'type': 'string', 'maxLength': 160, 'minLength': 1}, 'maxItems': 25}, 'resume_url': {'anyOf': [{'type': 'string', 'format': 'uri', 'maxLength': 2048}, {'type': 'null'}]}, 'external_id': {'type': 'string', 'maxLength': 200}, 'profile_url': {'anyOf': [{'type': 'string', 'format': 'uri', 'maxLength': 2048}, {'type': 'null'}]}, 'linkedin_url': {'anyOf': [{'type': 'string', 'format': 'uri', 'maxLength': 2048}, {'type': 'null'}]}, 'source_label': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'current_title': {'anyOf': [{'type': 'string', 'maxLength': 300}, {'type': 'null'}]}, 'owner_user_id': {'anyOf': [{'type': 'string', 'format': 'uuid'}, {'type': 'null'}]}, 'current_company': {'anyOf': [{'type': 'string', 'maxLength': 300}, {'type': 'null'}]}, 'last_contacted_at': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'maxItems': 500, 'minItems': 1}, 'metadata': {'type': 'object', 'additionalProperties': {}}, 'request_id': {'type': 'string', 'minLength': 1}, 'source_label': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_prospect_imports_read

Read a prospect import batch

Read one Prospect CRM import dry-run/apply batch by public id.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['import_id'], 'properties': {'import_id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_prospects_convert_bind

Confirm and convert a prospect into an application

Bind an approved prospect conversion preview with explicit approval metadata and matching idempotency key.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['prospect_id', 'job_posting_id', 'binding'], 'properties': {'note': {'anyOf': [{'type': 'string', 'maxLength': 2000}, {'type': 'null'}]}, 'binding': {'type': 'object', 'required': ['preview_hash', 'approved_action_key', 'approved_input_hash', 'approved_idempotency_key', 'resource_version_precondition'], 'properties': {'preview_hash': {'type': 'string', 'minLength': 1}, 'approved_action_key': {'type': 'string', 'minLength': 1}, 'approved_input_hash': {'type': 'string', 'minLength': 1}, 'approved_idempotency_key': {'type': 'string', 'minLength': 1}, 'resource_version_precondition': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'request_id': {'type': 'string', 'minLength': 1}, 'prospect_id': {'type': 'string', 'minLength': 1}, 'source_label': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'job_posting_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_prospects_convert_preview

Preview converting a prospect into an application (nothing changed yet)

Preview conversion of one Prospect into one canonical Application; bind fields are rejected and no outreach/import/merge occurs.

幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['prospect_id', 'job_posting_id'], 'properties': {'note': {'anyOf': [{'type': 'string', 'maxLength': 2000}, {'type': 'null'}]}, 'request_id': {'type': 'string', 'minLength': 1}, 'prospect_id': {'type': 'string', 'minLength': 1}, 'source_label': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'job_posting_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_prospects_create

Add a prospect

Create Talent CRM prospect relationship state for an existing person.

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['person_id'], 'properties': {'person_id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'source_label': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'owner_user_id': {'anyOf': [{'type': 'string', 'format': 'uuid'}, {'type': 'null'}]}, 'idempotency_key': {'type': 'string', 'minLength': 1}, 'last_reviewed_at': {'type': ['string', 'null']}, 'last_contacted_at': {'type': ['string', 'null']}}, 'additionalProperties': False}

yardstick_prospects_list

List prospects

List active Talent CRM prospects visible to the current principal.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'owner_user_id': {'type': 'string', 'minLength': 1}, 'starting_after': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_prospects_outreach_create_draft

Draft a prospect outreach email for review

Create a pending review prospect outreach email draft. Sending stays on email draft send and requires communications:send.

幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['prospect_id'], 'properties': {'body': {'anyOf': [{'type': 'string', 'maxLength': 8000, 'minLength': 1}, {'type': 'null'}]}, 'subject': {'anyOf': [{'type': 'string', 'maxLength': 240, 'minLength': 1}, {'type': 'null'}]}, 'request_id': {'type': 'string', 'minLength': 1}, 'prospect_id': {'type': 'string', 'minLength': 1}, 'job_posting_id': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}]}, 'idempotency_key': {'type': 'string', 'minLength': 1}, 'outreach_intent_key': {'anyOf': [{'type': 'string', 'maxLength': 120, 'minLength': 1}, {'type': 'null'}]}, 'personalization_instruction': {'anyOf': [{'type': 'string', 'maxLength': 2000}, {'type': 'null'}]}}, 'additionalProperties': False}

yardstick_prospects_outreach_preview

Preview prospect outreach copy (nothing saved or sent)

Preview a one-off prospect outreach draft without creating a draft, sending email, enrolling a sequence, or creating an application.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['prospect_id'], 'properties': {'body': {'anyOf': [{'type': 'string', 'maxLength': 8000, 'minLength': 1}, {'type': 'null'}]}, 'subject': {'anyOf': [{'type': 'string', 'maxLength': 240, 'minLength': 1}, {'type': 'null'}]}, 'request_id': {'type': 'string', 'minLength': 1}, 'prospect_id': {'type': 'string', 'minLength': 1}, 'job_posting_id': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}]}, 'idempotency_key': {'type': 'string', 'minLength': 1}, 'outreach_intent_key': {'anyOf': [{'type': 'string', 'maxLength': 120, 'minLength': 1}, {'type': 'null'}]}, 'personalization_instruction': {'anyOf': [{'type': 'string', 'maxLength': 2000}, {'type': 'null'}]}}, 'additionalProperties': False}

yardstick_prospects_read

Read a prospect

Read one Talent CRM prospect by public id.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['prospect_id'], 'properties': {'request_id': {'type': 'string', 'minLength': 1}, 'prospect_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_prospects_update

Update a prospect

Update bounded Talent CRM prospect relationship fields.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['prospect_id'], 'properties': {'request_id': {'type': 'string', 'minLength': 1}, 'prospect_id': {'type': 'string', 'minLength': 1}, 'source_label': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'owner_user_id': {'anyOf': [{'type': 'string', 'format': 'uuid'}, {'type': 'null'}]}, 'archived_reason': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}, 'idempotency_key': {'type': 'string', 'minLength': 1}, 'last_reviewed_at': {'type': ['string', 'null']}, 'last_contacted_at': {'type': ['string', 'null']}, 'next_follow_up_at': {'type': ['string', 'null']}, 'next_follow_up_note': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}, 'relationship_status': {'enum': ['active', 'archived'], 'type': 'string'}}, 'additionalProperties': False}

yardstick_reporting_search

Search recruiting reports

Search redacted recruiting reporting summaries through the public reporting API.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query_family', 'window_start', 'window_end'], 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'job_id': {'type': 'string', 'maxLength': 128, 'minLength': 1}, 'stages': {'type': 'string', 'maxLength': 1000, 'minLength': 1}, 'statuses': {'type': 'string', 'maxLength': 1000, 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'role_label': {'type': 'string', 'maxLength': 500, 'minLength': 1}, 'score_band': {'type': 'string', 'maxLength': 100, 'minLength': 1}, 'stale_days': {'type': 'integer', 'minimum': 0}, 'window_end': {'type': 'string', 'maxLength': 128, 'minLength': 1}, 'query_family': {'enum': ['role_health_attention', 'funnel_snapshot_by_role', 'stale_opportunity_queue', 'missing_feedback_queue', 'candidate_pool_strength', 'source_signals', 'prospect_ops_summary'], 'type': 'string'}, 'source_label': {'type': 'string', 'maxLength': 500, 'minLength': 1}, 'window_start': {'type': 'string', 'maxLength': 128, 'minLength': 1}, 'job_posting_id': {'type': 'string', 'maxLength': 128, 'minLength': 1}, 'starting_after': {'type': 'string', 'minLength': 1}, 'minimum_sample_size': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}

yardstick_source_links_create

Create a source or referral link

Create an opaque source/referral link for a published job posting. Raw source_token is returned only in the create response; reads return token_hint, and active token-bearing links also return public_url.

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['job_posting_id', 'source_label'], 'properties': {'expires_at': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'request_id': {'type': 'string', 'minLength': 1}, 'description': {'anyOf': [{'type': 'string', 'maxLength': 2000}, {'type': 'null'}]}, 'source_label': {'type': 'string', 'maxLength': 200}, 'referrer_name': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}, 'job_posting_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_source_links_disable

Disable a source or referral link

Disable a source/referral link so its public URL no longer stamps attribution.

可能执行破坏性操作

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['source_link_id'], 'properties': {'reason': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}, 'request_id': {'type': 'string', 'minLength': 1}, 'source_link_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_source_links_list

List source and referral links

List source/referral attribution links without raw token material or source quality ranking.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'job_posting_id': {'type': 'string', 'minLength': 1}, 'starting_after': {'type': 'string', 'minLength': 1}, 'include_disabled': {'type': 'boolean'}}, 'additionalProperties': False}

yardstick_source_links_read

Read a source or referral link

Read one source/referral attribution link by public id without raw token material.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['source_link_id'], 'properties': {'request_id': {'type': 'string', 'minLength': 1}, 'source_link_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_talent_pool_members_add

Add a prospect to a talent pool

Add an existing prospect to a Talent CRM pool.

幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['pool_id', 'prospect_id'], 'properties': {'pool_id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'prospect_id': {'type': 'string', 'minLength': 1}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_talent_pool_members_list

List talent pool members

List active prospect memberships for one Talent CRM pool.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['pool_id'], 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'pool_id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'starting_after': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_talent_pool_members_remove

Remove a prospect from a talent pool

Remove an active prospect membership from a Talent CRM pool.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['pool_id', 'prospect_id'], 'properties': {'pool_id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'prospect_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_talent_pools_create

Create a talent pool

Create a Talent CRM pool.

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['name'], 'properties': {'name': {'type': 'string', 'maxLength': 160, 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'description': {'anyOf': [{'type': 'string', 'maxLength': 1000}, {'type': 'null'}]}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_talent_pools_list

List talent pools

List Talent CRM pools visible to the current principal. Archived pools are excluded unless include_archived is true.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'starting_after': {'type': 'string', 'minLength': 1}, 'include_archived': {'type': 'boolean'}}, 'additionalProperties': False}

yardstick_talent_pools_read

Read a talent pool

Read one Talent CRM pool by public id.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['pool_id'], 'properties': {'pool_id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_talent_pools_update

Update a talent pool

Update bounded Talent CRM pool fields.

可能执行破坏性操作幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['pool_id'], 'properties': {'name': {'type': 'string', 'maxLength': 160, 'minLength': 1}, 'pool_id': {'type': 'string', 'minLength': 1}, 'archived': {'type': 'boolean'}, 'request_id': {'type': 'string', 'minLength': 1}, 'description': {'anyOf': [{'type': 'string', 'maxLength': 1000}, {'type': 'null'}]}, 'archived_reason': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}, 'idempotency_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_tasks_deep_link

Get a link that opens a task in Yardstick

Create a public task deep link for a caller-supplied task id.

幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['task_id'], 'properties': {'task_id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

yardstick_tasks_list

List tasks

List Yardstick tasks visible to the current principal.

只读幂等

输入模式

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'starting_after': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}

Yardstick ATS

此 MCP 可以做什么

工具

近期工具变更

类似的 MCP 服务器

AdButler

Duvo MCP

Lovie Company Formation

freedom-mcp

独行录 / opcmenu

Meta Council

synter-ads

synter-ads