Yardstick ATS

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Manage hiring in Yardstick's ATS: jobs, candidates, applications, interviews, and scorecards.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Yardstick ATS": {
      "url": "https://api.yardstick.team/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (258)

• yardstick_offers_list read-only

  List offers visible to you.

  Parameters:

  • limit — integer
  • state — string
  • cursor — string
  • current — boolean
  • unsigned — boolean
  • person_id — string
  • request_id — string
  • valid_after — string
  • valid_before — string
  • application_id — string
  • include_archived — boolean

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_offers_read read-only

  Read an offer. Members see status; its creator and admins see full details.

  Parameters:

  • offer_id (required) — string
  • request_id — string
  • include_archived — boolean

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_offers_timeline read-only

  Read the offer history.

  Parameters:

  • offer_id (required) — string
  • request_id — string
  • include_archived — boolean

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_offers_create

  Create an offer draft.

  Parameters:

  • idempotency_key (required) — string
  • application_id (required) — string
  • packet_id — string
  • request_id — string
  • terms_json — object
  • content_ast
  • valid_until
  • snapshot_html
  • snapshot_text
  • template_version_id — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_offers_update destructive

  Update a draft using its current version.

  Parameters:

  • idempotency_key (required) — string
  • offer_id (required) — string
  • expected_draft_revision (required) — integer
  • request_id — string
  • terms_json — object
  • content_ast
  • valid_until
  • snapshot_html
  • snapshot_text

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_offers_submit_for_approval

  Request approval of this draft.

  Parameters:

  • idempotency_key (required) — string
  • offer_id (required) — string
  • expected_draft_revision (required) — integer
  • expected_approval_digest (required) — string
  • expected_policy_revision_id (required) — string
  • request_id — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_offers_approval_review read-only

  Read the approval step assigned to you.

  Parameters:

  • offer_id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_offers_send_status read-only

  Read offer delivery status and recovery guidance.

  Parameters:

  • offer_id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_offers_status read-only

  Read signing, company signature, finalization and lifecycle status.

  Parameters:

  • offer_id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_offers_signed_copy read-only

  Get a five-minute download link for the signed company copy. Requires creator or admin access.

  Parameters:

  • offer_id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_offers_open_revision

  Open a replacement draft. Sending requires a separate preview and confirmation.

  Parameters:

  • idempotency_key (required) — string
  • offer_id (required) — string
  • request_id — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_offers_cancel_revision destructive

  Cancel a replacement draft.

  Parameters:

  • idempotency_key (required) — string
  • offer_id (required) — string
  • request_id — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_offers_verification_policy_read read-only

  Read candidate email verification settings. Admin only.

  Parameters:

  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_offers_verification_policy_update destructive

  Set candidate email verification requirements. Admin only.

  Parameters:

  • idempotency_key (required) — string
  • required (required) — boolean
  • request_id — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_offers_lifecycle_policy_read read-only

  Read offer reminder settings. Admin only.

  Parameters:

  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_offers_lifecycle_policy_update destructive

  Set reminder intervals in seconds before expiry. Admin only.

  Parameters:

  • idempotency_key (required) — string
  • offsets_seconds (required) — array
  • expected_revision (required) — integer
  • request_id — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_offers_countersignature_read read-only

  Read company signature settings for this offer.

  Parameters:

  • offer_id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_offers_countersignature_update destructive

  Configure the company signer. This does not sign the offer.

  Parameters:

  • idempotency_key (required) — string
  • offer_id (required) — string
  • mode (required) — string
  • user_id (required)
  • generation (required) — integer
  • confirmed — boolean
  • request_id — string
  • refresh_recipient — boolean

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_offers_library_documents_list read-only

  List offer documents with their fill-ins, packets and published version. Admins only.

  Parameters:

  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_offers_library_documents_create

  Create an offer document. Admins only.

  Parameters:

  • idempotency_key (required) — string
  • name (required) — string
  • kind (required) — string
  • request_id — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_offers_library_documents_read read-only

  Read an offer document, its draft and its versions. Admins only.

  Parameters:

  • template_id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_offers_library_documents_update_draft destructive

  Save an offer document draft and its fill-ins. Admins only.

  Parameters:

  • idempotency_key (required) — string
  • template_id (required) — string
  • content_ast (required) — object
  • fill_ins — array
  • request_id — string
  • expected_revision — integer

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_offers_library_documents_publish

  Publish the current draft as a new version. Admins only.

  Parameters:

  • idempotency_key (required) — string
  • template_id (required) — string
  • request_id — string
  • expected_revision — integer

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_offers_library_documents_copy

  Copy an offer document into a new draft. Admins only.

  Parameters:

  • idempotency_key (required) — string
  • template_id (required) — string
  • name — string
  • request_id — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_offers_library_documents_archive

  Archive an offer document. Admins only.

  Parameters:

  • idempotency_key (required) — string
  • template_id (required) — string
  • request_id — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_offers_library_packets_list read-only

  List offer packets and their documents. Admins only.

  Parameters:

  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_offers_library_packets_create

  Create an offer packet. Admins only.

  Parameters:

  • idempotency_key (required) — string
  • name (required) — string
  • template_ids (required) — array
  • audience — string
  • defaults — object
  • request_id — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_offers_library_packets_update destructive

  Change an offer packet. Admins only.

  Parameters:

  • idempotency_key (required) — string
  • packet_id (required) — string
  • name — string
  • audience — string
  • defaults — object
  • request_id — string
  • template_ids — array

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_offers_library_packets_archive

  Archive an offer packet. Admins only.

  Parameters:

  • idempotency_key (required) — string
  • packet_id (required) — string
  • request_id — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_offers_library_packets_reorder

  Set the order of offer packets. Admins only.

  Parameters:

  • idempotency_key (required) — string
  • packet_ids (required) — array
  • request_id — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_offers_documents_list read-only

  List the documents in an offer and what each still needs before sending.

  Parameters:

  • offer_id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_offers_documents_add

  Add a published offer document to a draft offer.

  Parameters:

  • idempotency_key (required) — string
  • offer_id (required) — string
  • template_id (required) — string
  • request_id — string
  • expected_draft_revision — integer

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_offers_documents_remove destructive

  Remove a document from a draft offer.

  Parameters:

  • idempotency_key (required) — string
  • offer_id (required) — string
  • document_id (required) — string
  • request_id — string
  • expected_draft_revision — integer

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_offers_documents_reorder

  Set the order of the documents in a draft offer. List every document once.

  Parameters:

  • idempotency_key (required) — string
  • offer_id (required) — string
  • document_ids (required) — array
  • request_id — string
  • expected_draft_revision — integer

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_offers_documents_edit destructive

  Edit one document for this offer only. The library document does not change. `expected_draft_revision` is required.

  Parameters:

  • idempotency_key (required) — string
  • offer_id (required) — string
  • document_id (required) — string
  • content_ast (required) — object
  • expected_draft_revision (required) — integer
  • request_id — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_offers_answers_update destructive

  Fill in the answers the offer documents ask for. `expected_draft_revision` is required.

  Parameters:

  • idempotency_key (required) — string
  • offer_id (required) — string
  • answers (required) — object
  • expected_draft_revision (required) — integer
  • request_id — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_offers_documents_change_packet destructive

  Replace the offer's documents with a different packet. If answers or edits would be lost, nothing changes and the call returns a 409 `change_packet_confirm_required` error with the number of answers and edits. To go ahead, repeat the call with `confirm_drops` set to true.

  Parameters:

  • idempotency_key (required) — string
  • offer_id (required) — string
  • packet_id (required) — string
  • request_id — string
  • confirm_drops — boolean
  • expected_draft_revision — integer

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_offers_signed_files_list read-only

  List the signed files of an offer. Requires creator or admin access.

  Parameters:

  • offer_id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_offers_signed_files_download read-only

  Download one signed file of an offer as a PDF. file_id is required: this tool returns one file per call, up to 3 MB. Get the IDs from `yardstick_offers_signed_files_list`. For a larger file, or to save every file, use the CLI `yardstick offers signed-files download`. Requires creator or admin access.

  Parameters:

  • offer_id (required) — string
  • file_id — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_offers_approval_preview

  Review an approval decision without recording it.

  Parameters:

  • idempotency_key (required) — string
  • offer_id (required) — string
  • decision (required) — string
  • comment (required) — string
  • request_id — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_offers_send_preview

  Review the exact offer and recipient without sending.

  Parameters:

  • idempotency_key (required) — string
  • offer_id (required) — string
  • expected_draft_revision (required) — integer
  • recipient — string
  • request_id — string
  • expected_snapshot_sha256 — string
  • recipient_override_reason — string
  • expected_send_payload_digest — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_offers_rescind_preview

  Review withdrawal and optional candidate email without changing the offer.

  Parameters:

  • idempotency_key (required) — string
  • offer_id (required) — string
  • request_id — string
  • email_candidate — boolean

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_offers_approval_bind

  Record only the approval decision explicitly reviewed in preview.

  Parameters:

  • idempotency_key (required) — string
  • offer_id (required) — string
  • decision (required) — string
  • comment (required) — string
  • binding (required) — object
  • request_id — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_offers_send_bind

  Send only the exact offer explicitly reviewed in preview.

  Parameters:

  • idempotency_key (required) — string
  • offer_id (required) — string
  • expected_draft_revision (required) — integer
  • binding (required) — object
  • recipient — string
  • request_id — string
  • expected_snapshot_sha256 — string
  • recipient_override_reason — string
  • expected_send_payload_digest — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_offers_rescind_bind destructive

  Withdraw only the offer explicitly reviewed in preview.

  Parameters:

  • idempotency_key (required) — string
  • offer_id (required) — string
  • binding (required) — object
  • request_id — string
  • email_candidate — boolean

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_identity read-only

  Return the current Yardstick API principal context.

  Parameters:

  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_tasks_list read-only

  List Yardstick tasks visible to the current principal.

  Parameters:

  • limit — integer
  • request_id — string
  • starting_after — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_tasks_respond destructive

  Answer an assigned application or scorecard review. Recruiter questions require a note; send_to_recruiter shares a scorecard note with the recruiter.

  Parameters:

  • task_id (required) — string
  • decision (required) — string
  • note — string
  • request_id — string
  • idempotency_key — string
  • send_to_recruiter — boolean

  Hints: read-only no · destructive yes · idempotent no · open-world no

• yardstick_tasks_deep_link

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

  Parameters:

  • task_id (required) — string
  • request_id — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_people_list read-only

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

  Parameters:

  • email — string
  • limit — integer
  • request_id — string
  • starting_after — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_people_read read-only

  Read one person by public id.

  Parameters:

  • person_id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_people_documents_list read-only

  List the documents attached to a person (resumes and other files). Archived documents are excluded unless include_archived is true. Takes a per_ display id and returns pdoc_ display ids.

  Parameters:

  • person_id (required) — string
  • request_id — string
  • include_archived — boolean

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_people_documents_download_url read-only

  Mint a signed download URL for one person document. Read-only. The URL expires in 5 minutes and is a bearer link: do not log or share it. Takes per_ and pdoc_ display ids.

  Parameters:

  • person_id (required) — string
  • document_id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_people_create

  Create a person through the public Yardstick API.

  Parameters:

  • name — string
  • email — string
  • notes — string
  • phone — string
  • request_id — string
  • resume_url — string
  • linkedin_url — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• yardstick_people_update destructive

  Update one person with schema-bound public API fields.

  Parameters:

  • person_id (required) — string
  • name — string
  • email — string
  • notes
  • phone
  • request_id — string
  • resume_url
  • linkedin_url
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_talent_search read-only

  Search all authorized recruiting records by literal keywords across names, notes, activities and current parsed résumés. All words must match; PhD punctuation is normalized.

  Parameters:

  • surface (required) — string
  • search (required) — string
  • limit — integer
  • job_id — string
  • offset — integer

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_prospects_list read-only

  List active Talent CRM prospects visible to the current principal.

  Parameters:

  • limit — integer
  • request_id — string
  • owner_user_id — string
  • starting_after — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_prospects_read read-only

  Read one Talent CRM prospect by public id.

  Parameters:

  • prospect_id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_prospects_create

  Create Talent CRM prospect relationship state for an existing person.

  Parameters:

  • person_id (required) — string
  • request_id — string
  • source_label
  • owner_user_id
  • idempotency_key — string
  • last_reviewed_at — ['string', 'null']
  • last_contacted_at — ['string', 'null']

  Hints: read-only no · destructive no · idempotent no · open-world no

• yardstick_prospects_convert_preview

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

  Parameters:

  • prospect_id (required) — string
  • job_posting_id (required) — string
  • note
  • request_id — string
  • source_label
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_prospects_convert_bind destructive

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

  Parameters:

  • prospect_id (required) — string
  • job_posting_id (required) — string
  • binding (required) — object
  • note
  • request_id — string
  • source_label
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_prospects_outreach_preview read-only

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

  Parameters:

  • prospect_id (required) — string
  • body
  • subject
  • request_id — string
  • job_posting_id
  • idempotency_key — string
  • outreach_intent_key
  • personalization_instruction

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_prospects_outreach_create_draft

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

  Parameters:

  • prospect_id (required) — string
  • body
  • subject
  • request_id — string
  • job_posting_id
  • idempotency_key — string
  • outreach_intent_key
  • personalization_instruction

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_prospect_imports_dry_run

  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.

  Parameters:

  • rows (required) — array
  • metadata — object
  • request_id — string
  • source_label
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_prospect_imports_read read-only

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

  Parameters:

  • import_id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_prospect_imports_apply

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

  Parameters:

  • import_id (required) — string
  • preview_hash (required) — string
  • decisions — array
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_ats_imports_dry_run

  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.

  Parameters:

  • jobs — array
  • metadata — object
  • candidates — array
  • request_id — string
  • session_id — string
  • source_kind — string
  • applications — array
  • source_label
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_ats_imports_read read-only

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

  Parameters:

  • import_id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_ats_imports_apply

  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.

  Parameters:

  • import_id (required) — string
  • preview_hash (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_source_links_list read-only

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

  Parameters:

  • limit — integer
  • request_id — string
  • job_posting_id — string
  • starting_after — string
  • include_disabled — boolean

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_source_links_read read-only

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

  Parameters:

  • source_link_id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_source_links_create

  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.

  Parameters:

  • job_posting_id (required) — string
  • source_label (required) — string
  • expires_at
  • request_id — string
  • description
  • referrer_name
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• yardstick_source_links_disable destructive

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

  Parameters:

  • source_link_id (required) — string
  • reason
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent no · open-world no

• yardstick_prospects_update destructive

  Update bounded Talent CRM prospect relationship fields.

  Parameters:

  • prospect_id (required) — string
  • request_id — string
  • source_label
  • owner_user_id
  • archived_reason
  • idempotency_key — string
  • last_reviewed_at — ['string', 'null']
  • last_contacted_at — ['string', 'null']
  • next_follow_up_at — ['string', 'null']
  • next_follow_up_note
  • relationship_status — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_prospect_activities_list read-only

  List bounded activity records for one Talent CRM prospect.

  Parameters:

  • prospect_id (required) — string
  • limit — integer
  • request_id — string
  • starting_after — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_prospect_activities_create

  Create a bounded internal prospect activity note or touchpoint.

  Parameters:

  • prospect_id (required) — string
  • body
  • metadata — object
  • request_id — string
  • occurred_at — string
  • source_label
  • activity_type — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• yardstick_talent_pools_list read-only

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

  Parameters:

  • limit — integer
  • request_id — string
  • starting_after — string
  • include_archived — boolean

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_talent_pools_read read-only

  Read one Talent CRM pool by public id.

  Parameters:

  • pool_id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_talent_pools_create

  Create a Talent CRM pool.

  Parameters:

  • name (required) — string
  • request_id — string
  • description
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• yardstick_talent_pools_update destructive

  Update bounded Talent CRM pool fields.

  Parameters:

  • pool_id (required) — string
  • name — string
  • archived — boolean
  • request_id — string
  • description
  • archived_reason
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_talent_pool_members_list read-only

  List active prospect memberships for one Talent CRM pool.

  Parameters:

  • pool_id (required) — string
  • limit — integer
  • request_id — string
  • starting_after — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_talent_pool_members_add

  Add an existing prospect to a Talent CRM pool.

  Parameters:

  • pool_id (required) — string
  • prospect_id (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_talent_pool_members_remove destructive

  Remove an active prospect membership from a Talent CRM pool.

  Parameters:

  • pool_id (required) — string
  • prospect_id (required) — string
  • request_id — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_applications_list read-only

  List application person + Job attachments visible to the current principal. Filter by --job-id to find candidates for a role, and by --hiring-manager-decision (advanced, held or waiting) for where the hiring manager's decision stands.

  Parameters:

  • limit — integer
  • job_id — string
  • request_id — string
  • starting_after — string
  • hiring_manager_decision — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_applications_read read-only

  Read one application person + Job attachment by public id.

  Parameters:

  • application_id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_applications_create

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

  Parameters:

  • person_id (required) — string
  • job_posting_id (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• yardstick_applications_update destructive

  Update one application with schema-bound public API fields.

  Parameters:

  • application_id (required) — string
  • stage — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_applications_decide destructive

  Decide on an application without a review task. Only the job's hiring manager may decide; anyone else gets application not found. Reason codes must be system codes or your organization's. Reject disqualifies the candidate.

  Parameters:

  • application_id (required) — string
  • decision (required) — string
  • note — string
  • request_id — string
  • idempotency_key — string
  • reason_code_ids — array

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_applications_hiring_step_decision read-only

  Read where the hiring manager's decision stands on the candidate's latest step that waits on one: advanced, held, waiting, or none.

  Parameters:

  • application_id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_applications_decide_hiring_step

  Advance or hold a candidate on a step that waits on the hiring manager, or change that decision. The hiring manager or a recruiter on the job may decide. Leave out interview_id to decide the latest such step. A note can go to the recruiter with send_to_recruiter.

  Parameters:

  • application_id (required) — string
  • decision (required) — string
  • note — string
  • request_id — string
  • interview_id — string
  • idempotency_key — string
  • send_to_recruiter — boolean

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_applications_admit_candidate destructive

  Move one reviewed application to Candidates. Does not schedule interviews or send email.

  Parameters:

  • application_id (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_applications_undo_candidate_admission destructive

  Correct one accidental candidate admission using its current admission ID. No time limit; refused once candidate activity starts. Preserves history and excludes the corrected episode from admission reporting.

  Parameters:

  • application_id (required) — string
  • expected_admission_id (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_applications_transition_direct destructive

  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).

  Parameters:

  • application_id (required) — string
  • status (required) — string
  • reason — string
  • request_id — string
  • idempotency_key — string
  • pipeline_stage_id — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_applications_transition_preview

  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).

  Parameters:

  • application_id (required) — string
  • status (required) — string
  • reason — string
  • request_id — string
  • idempotency_key — string
  • pipeline_stage_id — string
  • employment_start_date — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_applications_transition_bind destructive

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

  Parameters:

  • application_id (required) — string
  • status (required) — string
  • binding (required) — object
  • reason — string
  • request_id — string
  • idempotency_key — string
  • employment_start_date — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_applications_archive_preview

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

  Parameters:

  • application_id (required) — string
  • reason — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_applications_archive_bind destructive

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

  Parameters:

  • application_id (required) — string
  • binding (required) — object
  • reason — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_applications_status_email_poc_preview

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

  Parameters:

  • application_id (required) — string
  • current_status (required) — string
  • target_status (required) — string
  • email_type (required) — string
  • decision (required) — string
  • mode — string
  • request_id — string
  • idempotency_key — string
  • personalization_instruction
  • requested_sender_identity_id

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_applications_status_email_poc_bind destructive

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

  Parameters:

  • application_id (required) — string
  • current_status (required) — string
  • target_status (required) — string
  • email_type (required) — string
  • decision (required) — string
  • binding (required) — object
  • mode — string
  • request_id — string
  • idempotency_key — string
  • personalization_instruction
  • requested_sender_identity_id

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_decision_brief_read read-only

  Read the decision brief for an application.

  Parameters:

  • application_id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_decision_brief_regenerate destructive

  Regenerate a decision brief for an application with idempotency metadata.

  Parameters:

  • application_id (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent no · open-world no

• yardstick_applications_email_decision_preview

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

  Parameters:

  • application_id (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_applications_email_decision_apply destructive

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

  Parameters:

  • application_id (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_email_drafts_list read-only

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

  Parameters:

  • limit — integer
  • status — string
  • email_type — string
  • request_id — string
  • starting_after — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_email_drafts_read read-only

  Read a redacted candidate email draft.

  Parameters:

  • id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_email_drafts_preview read-only

  Read rendered preview content for a candidate email draft.

  Parameters:

  • id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_email_drafts_history read-only

  Read candidate email draft history and provenance.

  Parameters:

  • id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_email_drafts_update destructive

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

  Parameters:

  • id (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_email_drafts_send destructive

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

  Parameters:

  • id (required) — string
  • request_id — string
  • idempotency_key — string
  • reclaim_not_delivered — boolean

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_email_drafts_discard destructive

  Discard a pending candidate email draft without provider mutation.

  Parameters:

  • id (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_email_automation_settings_read read-only

  Read candidate email automation settings.

  Parameters:

  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_email_automation_settings_update destructive

  Update candidate email automation settings.

  Parameters:

  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_email_sender_settings_read read-only

  Read redacted email sender settings with sanitized queue diagnostics.

  Parameters:

  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_email_sender_connections_list read-only

  List redacted sender provider connection state.

  Parameters:

  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_email_sender_defaults_list read-only

  List candidate email sender defaults.

  Parameters:

  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_integrations_workspace_health_read read-only

  Read sanitized Workspace integration health diagnostics.

  Parameters:

  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_email_sender_defaults_set destructive

  Set the default sender policy for a candidate email type.

  Parameters:

  • email_type (required) — string
  • default_sender_type (required) — string
  • request_id — string
  • idempotency_key — string
  • org_shared_sender_identity_id

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_email_templates_list read-only

  List Candidate and Internal emails with automation usage counts.

  Parameters:

  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_email_templates_read read-only

  Read an email by built-in type or custom template key.

  Parameters:

  • email_type (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_email_templates_preview

  Preview an email for sample variables.

  Parameters:

  • email_type (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_email_templates_validate

  Validate email subject, HTML, and text bodies.

  Parameters:

  • email_type (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_email_templates_publish destructive

  Update, create, duplicate, reset or delete an email. Set operation; custom emails use email_type as their template key.

  Parameters:

  • email_type (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent no · open-world no

• yardstick_email_templates_create

  create an email. Use email_type for a built-in type or custom template key.

  Parameters:

  • email_type (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• yardstick_email_templates_duplicate

  duplicate an email. Use email_type for a built-in type or custom template key.

  Parameters:

  • email_type (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• yardstick_email_templates_reset destructive

  reset an email. Use email_type for a built-in type or custom template key.

  Parameters:

  • email_type (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent no · open-world no

• yardstick_email_templates_delete destructive

  delete an email. Use email_type for a built-in type or custom template key.

  Parameters:

  • email_type (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent no · open-world no

• yardstick_email_template_versions_list read-only

  List immutable email versions.

  Parameters:

  • email_type (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_email_templates_rollback destructive

  Restore an email to an immutable version.

  Parameters:

  • email_type (required) — string
  • version_id (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_email_templates_preview_customization

  Preview AI sample customization for an email without publishing.

  Parameters:

  • email_type (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_final_recommendation_record destructive

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

  Parameters:

  • application_id (required) — string
  • interviewer_user_id (required) — string
  • rating (required) — integer
  • notes — string
  • request_id — string
  • session_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_application_interview_sessions_list read-only

  List interview sessions for an application.

  Parameters:

  • application_id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_application_interview_sessions_ensure

  Ensure an application interview session for an explicit round id.

  Parameters:

  • application_id (required) — string
  • round_id (required) — string
  • request_id — string
  • round_title — string
  • idempotency_key — string
  • interview_plan_id — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_opportunities_list read-only

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

  Parameters:

  • limit — integer
  • request_id — string
  • starting_after — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_opportunities_read read-only

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

  Parameters:

  • opportunity_id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_opportunities_next_action

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

  Parameters:

  • opportunity_id (required) — string
  • request_id — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_opportunities_deep_link

  Create a public deep link for an opportunity workflow view.

  Parameters:

  • opportunity_id (required) — string
  • request_id — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_reporting_search read-only

  Search redacted recruiting reporting summaries through the public reporting API.

  Parameters:

  • query_family (required) — string
  • window_start (required) — string
  • window_end (required) — string
  • limit — integer
  • job_id — string
  • stages — string
  • statuses — string
  • request_id — string
  • role_label — string
  • score_band — string
  • stale_days — integer
  • source_label — string
  • job_posting_id — string
  • starting_after — string
  • minimum_sample_size — integer

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_departments_list read-only

  List Departments visible to the current principal.

  Parameters:

  • limit — integer
  • request_id — string
  • starting_after — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_departments_read read-only

  Read one Department by public id.

  Parameters:

  • department_id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_departments_create

  Create a Department through the public Yardstick API.

  Parameters:

  • name (required) — string
  • slug — string
  • request_id — string
  • description
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• yardstick_departments_update destructive

  Update one Department with schema-bound public API fields.

  Parameters:

  • department_id (required) — string
  • name — string
  • slug — string
  • request_id — string
  • description
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_departments_members_list read-only

  List Department members for an authorized Department.

  Parameters:

  • department_id (required) — string
  • limit — integer
  • request_id — string
  • starting_after — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_departments_members_add

  Add an existing person to a Department.

  Parameters:

  • department_id (required) — string
  • person_id (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_departments_members_set_lead destructive

  Set one Department member as lead.

  Parameters:

  • department_id (required) — string
  • person_id (required) — string
  • role — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_departments_members_remove destructive

  Remove a Department member, optionally with a replacement lead.

  Parameters:

  • department_id (required) — string
  • person_id (required) — string
  • request_id — string
  • idempotency_key — string
  • replacement_lead_person_id

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_departments_invitations_list read-only

  List redacted Department invitation views.

  Parameters:

  • department_id (required) — string
  • limit — integer
  • request_id — string
  • starting_after — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_departments_invitations_create

  Create a Department-scoped invitation without returning token material.

  Parameters:

  • department_id (required) — string
  • email (required) — string
  • role (required) — string
  • name — string
  • full_name — string
  • request_id — string
  • idempotency_key — string
  • expires_in_hours — integer

  Hints: read-only no · destructive no · idempotent no · open-world no

• yardstick_access_grants_list read-only

  List explicit access grants visible to the current principal.

  Parameters:

  • limit — integer
  • request_id — string
  • starting_after — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_access_grants_read read-only

  Read one explicit access grant by public id.

  Parameters:

  • access_grant_id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_access_grants_create

  Create a reasoned, revocable, audited access grant.

  Parameters:

  • subject_person_id (required) — string
  • scope (required) — string
  • target_id (required) — string
  • artifact_classes (required) — array
  • reason (required) — string
  • revocable — boolean
  • expires_at — string
  • request_id — string
  • effective_at — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• yardstick_access_grants_revoke destructive

  Revoke an explicit access grant with optional reason text.

  Parameters:

  • access_grant_id (required) — string
  • reason — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent no · open-world no

• yardstick_jobs_list read-only

  List internal Job containers visible to the current principal.

  Parameters:

  • limit — integer
  • request_id — string
  • starting_after — string
  • include_archived — boolean

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_jobs_create

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

  Parameters:

  • title (required) — string
  • status — string
  • location — string
  • department — string
  • request_id — string
  • description — string
  • department_id
  • location_type — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• yardstick_jobs_read read-only

  Read one internal Job container by public id.

  Parameters:

  • job_id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_jobs_prospect_matches read-only

  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.

  Parameters:

  • job_id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_jobs_update destructive

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

  Parameters:

  • job_id (required) — string
  • title — string
  • status — string
  • location
  • department
  • request_id — string
  • description
  • department_id
  • location_type
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_jobs_close destructive

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

  Parameters:

  • job_id (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_jobs_archive destructive

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

  Parameters:

  • job_id (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_jobs_attach_artifact

  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.

  Parameters:

  • job_id (required) — string
  • artifact_type (required) — string
  • artifact_id (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_jobs_detach_artifact destructive

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

  Parameters:

  • job_id (required) — string
  • artifact_type (required) — string
  • artifact_id (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_pipelines_list read-only

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

  Parameters:

  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_pipelines_read read-only

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

  Parameters:

  • pipeline_id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_pipelines_create

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

  Parameters:

  • name (required) — string
  • slug (required) — string
  • stages — array
  • request_id — string
  • description
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• yardstick_pipelines_clone

  Clone a pipeline and its stages. Set copy_rules to copy its workflow rules too (requires automation_rules:write). Returns rules_copied.

  Parameters:

  • pipeline_id (required) — string
  • name (required) — string
  • slug (required) — string
  • copy_rules — boolean
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• yardstick_pipelines_update destructive

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

  Parameters:

  • pipeline_id (required) — string
  • name — string
  • is_active — boolean
  • request_id — string
  • description
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_pipelines_stages_create

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

  Parameters:

  • pipeline_id (required) — string
  • name (required) — string
  • slug (required) — string
  • stage_kind (required) — string
  • position — integer
  • request_id — string
  • is_terminal — boolean
  • approval_scope
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• yardstick_pipelines_stages_update destructive

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

  Parameters:

  • pipeline_id (required) — string
  • stage_id (required) — string
  • name — string
  • slug — string
  • is_active — boolean
  • request_id — string
  • stage_kind — string
  • is_terminal — boolean
  • approval_scope
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_pipelines_reorder_stages destructive

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

  Parameters:

  • pipeline_id (required) — string
  • stage_ids (required) — array
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_pipelines_stages_delete_preview

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

  Parameters:

  • pipeline_id (required) — string
  • stage_id (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_pipelines_stages_delete_bind destructive

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

  Parameters:

  • pipeline_id (required) — string
  • stage_id (required) — string
  • binding (required) — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_pipelines_assign_to_job destructive

  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.

  Parameters:

  • job_id (required) — string
  • pipeline_id (required)
  • request_id — string
  • stage_mapping — object
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_pipelines_assign_to_job_preview read-only

  Preview the job's stages in use, candidate counts and suggested same-name mapping before changing its pipeline. Makes no changes.

  Parameters:

  • job_id (required) — string
  • pipeline_id (required)
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_automation_rules_copy

  Copy one hiring process rule to job_ids, or one pipeline rule to pipeline_ids. Matches steps by name or kind and position, stages by name or mapped status. Unmatched copies start off and require Pick a step or Pick a stage. Copies are independent user rules.

  Parameters:

  • rule_id (required) — string
  • job_ids — array
  • request_id — string
  • pipeline_ids — array
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• yardstick_automation_rules_list read-only

  List all job and pipeline rules. Filter by job_id (null for pipeline rules), department_id, pipeline_id, trigger, email or is_active. Job and department filters include inherited pipeline rules; pipeline filters also include hiring-step rules on jobs using that pipeline.

  Parameters:

  • email — string
  • job_id — string
  • trigger — string
  • is_active — boolean
  • request_id — string
  • pipeline_id — string
  • department_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_automation_rules_bulk destructive

  Switch rules on, off or delete them. First use mode=preview with rule_ids or filter. Show the affected rules and skipped rules to the user and get explicit confirmation BEFORE applying. Then use mode=apply with only the exact rule_ids returned by preview; never reapply the filter. Pick a step rules are skipped when switching on. Warn that shared pipeline rules change for every job on that pipeline, including jobs outside the filter.

  Parameters:

  • action (required) — string
  • mode (required) — string
  • filter — object
  • rule_ids — array
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_automation_runs_retry destructive

  Try a workflow run again after fixing missing setup. Only clean refusals and active rules qualify; unknown outcomes are refused.

  Parameters:

  • run_id (required) — string
  • request_id — string

  Hints: read-only no · destructive yes · idempotent no · open-world no

• yardstick_automation_runs_list read-only

  List workflow automation runs including public_state, reason, next_action, due_at and interview_session_id. Filter by application-id or rule-id. Read-only; runs are system-written.

  Parameters:

  • rule_id — string
  • request_id — string
  • application_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_automation_rules_read read-only

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

  Parameters:

  • rule_id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_automation_rules_create

  Create a named workflow automation rule with stage or step triggers, job scope, delivery mode, timing and a typed action. Authoring executes no action.

  Parameters:

  • trigger (required) — string
  • action (required)
  • name — string
  • job_id
  • timing
  • position — integer
  • condition — object
  • is_active — boolean
  • job_scope — string
  • request_id — string
  • starter_key
  • delivery_mode — string
  • idempotency_key — string
  • job_posting_ids — array
  • needs_step_pick — boolean
  • pipeline_stage_id
  • pipeline_template_id

  Hints: read-only no · destructive no · idempotent no · open-world no

• yardstick_automation_rules_update destructive

  Edit a workflow automation rule's name, stage or step trigger, action, condition, job scope, delivery mode, timing or active state.

  Parameters:

  • rule_id (required) — string
  • name — string
  • action
  • job_id
  • timing
  • trigger — string
  • position
  • condition — object
  • is_active — boolean
  • job_scope — string
  • request_id — string
  • starter_key
  • delivery_mode — string
  • idempotency_key — string
  • job_posting_ids — array
  • needs_step_pick — boolean
  • pipeline_stage_id
  • pipeline_template_id

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_automation_rules_delete destructive

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

  Parameters:

  • rule_id (required) — string
  • request_id — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_automation_rules_preview_rule read-only

  Preview a saved workflow rule for a real application: recipients, sender, rendered email, scheduling links and missing prerequisites. Executes no action.

  Parameters:

  • rule_id (required) — string
  • application_id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_automation_rules_preview_draft read-only

  Preview a rule before saving it, for a real application: the same result as preview-rule. Pass the rule as you would to create (CLI: --body-json '{"rule":{...}}'); add rule_id to preview unsaved edits to that rule. Saves nothing and executes no action.

  Parameters:

  • application_id (required) — string
  • rule (required) — object — The rule as you would pass it to create.
  • rule_id — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_automation_rules_preview read-only

  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.

  Parameters:

  • application_id (required) — string
  • trigger (required) — string
  • pipeline_stage_id (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_automation_starters_list read-only

  List your organization’s saved automation starters.

  Parameters:

  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_automation_starters_create

  Create a named organization starter from portable rule definitions.

  Parameters:

  • name (required) — string
  • rules (required) — array
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• yardstick_automation_starters_rename destructive

  Rename an organization starter without changing existing job copies.

  Parameters:

  • starter_id (required) — string
  • name (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_automation_starters_delete destructive

  Delete an organization starter while keeping existing job copies.

  Parameters:

  • starter_id (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_automation_starters_save_job

  Save a job’s automation rules as a named organization starter.

  Parameters:

  • job_id (required) — string
  • name (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• yardstick_automation_starters_preview read-only

  Preview copying a starter or job’s rules, including step and stage matches and unmatched rules.

  Parameters:

  • job_id (required) — string
  • source (required) — object
  • matches — object
  • request_id — string
  • source_digest — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_automation_starters_apply

  Copy reviewed rules into a job using chosen matches; keep unmatched rules off and existing rules intact.

  Parameters:

  • job_id (required) — string
  • source (required) — object
  • matches — object
  • request_id — string
  • source_digest — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• yardstick_built_in_agents_list read-only

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

  Parameters:

  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_built_in_agents_read read-only

  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.

  Parameters:

  • built_in_agent_id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_built_in_agents_runs read-only

  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.

  Parameters:

  • request_id — string
  • built_in_agent_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_built_in_agents_enable_preview

  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.

  Parameters:

  • built_in_agent_id (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_built_in_agents_enable_bind destructive

  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.

  Parameters:

  • built_in_agent_id (required) — string
  • binding (required) — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_built_in_agents_configure_preview

  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.

  Parameters:

  • built_in_agent_id (required) — string
  • config (required) — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_built_in_agents_configure_bind destructive

  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.

  Parameters:

  • built_in_agent_id (required) — string
  • config (required) — object
  • binding (required) — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_job_postings_list read-only

  List job postings visible to the current principal.

  Parameters:

  • limit — integer
  • request_id — string
  • starting_after — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_job_postings_read read-only

  Read one job posting by public id.

  Parameters:

  • job_posting_id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_job_postings_validate

  Validate a draft job posting without mutating it.

  Parameters:

  • job_posting_id (required) — string
  • request_id — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_job_postings_create

  Create a draft job posting through the public Yardstick API.

  Parameters:

  • title (required) — string
  • interview_plan_id (required) — string — 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`.
  • slug (required) — string
  • location — string
  • department — string
  • request_id — string
  • salary_max — integer
  • salary_min — integer
  • description — string
  • requirements — string
  • location_type — string
  • salary_display — boolean
  • idempotency_key — string
  • salary_currency — string
  • custom_questions — array
  • location_country — string — Assigned ISO 3166-1 alpha-2 country code.

  Hints: read-only no · destructive no · idempotent no · open-world no

• yardstick_job_postings_update destructive

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

  Parameters:

  • job_posting_id (required) — string
  • slug — string
  • title — string
  • location
  • department
  • request_id — string
  • salary_max
  • salary_min
  • description
  • requirements
  • location_type — string
  • salary_display — boolean
  • idempotency_key — string
  • salary_currency — string
  • custom_questions — array
  • location_country — Assigned ISO 3166-1 alpha-2 country code.
  • interview_plan_id — string — 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`.

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_job_postings_publish_preview

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

  Parameters:

  • job_posting_id (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_job_postings_publish_bind destructive

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

  Parameters:

  • job_posting_id (required) — string
  • binding (required) — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_job_postings_archive_preview

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

  Parameters:

  • job_posting_id (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_job_postings_archive_bind destructive

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

  Parameters:

  • job_posting_id (required) — string
  • binding (required) — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_interview_plans_list read-only

  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.

  Parameters:

  • limit — integer
  • job_id — string
  • request_id — string
  • starting_after — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_interview_plans_read read-only

  Read one interview plan by public id.

  Parameters:

  • interview_plan_id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_interview_plans_archive destructive

  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.

  Parameters:

  • interview_plan_id (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_interview_plans_unarchive

  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.

  Parameters:

  • interview_plan_id (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_interview_plans_set_hiring_manager_decides

  Turn on or off whether a plan step waits on the hiring manager's decision before the candidate moves on. Only workflow managers on an open job can change it.

  Parameters:

  • interview_plan_id (required) — string
  • step_id (required) — string
  • hiring_manager_decides (required) — boolean
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_interview_plan_drafts_generate_outcomes destructive

  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).

  Parameters:

  • action (required) — string
  • input (required) — object
  • resource — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent no · open-world no

• yardstick_interview_plan_drafts_confirm_outcomes destructive

  Confirm draft interview-plan outcomes before generating later stages.

  Parameters:

  • action (required) — string
  • resource (required) — object
  • input (required) — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_interview_plan_drafts_generate_competencies destructive

  Generate draft interview-plan competencies from confirmed outcomes.

  Parameters:

  • action (required) — string
  • resource (required) — object
  • input (required) — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent no · open-world no

• yardstick_interview_plan_drafts_generate_skills destructive

  Generate draft interview-plan skills from confirmed competencies.

  Parameters:

  • action (required) — string
  • resource (required) — object
  • input (required) — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent no · open-world no

• yardstick_interview_plan_drafts_generate_rounds destructive

  Generate draft interview-plan rounds from confirmed skills.

  Parameters:

  • action (required) — string
  • resource (required) — object
  • input (required) — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent no · open-world no

• yardstick_interview_plan_drafts_generate_anchors destructive

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

  Parameters:

  • action (required) — string
  • resource (required) — object
  • input (required) — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent no · open-world no

• yardstick_interview_plan_drafts_generate_questions_directions destructive

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

  Parameters:

  • action (required) — string
  • resource (required) — object
  • input (required) — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent no · open-world no

• yardstick_interview_plan_drafts_list read-only

  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.

  Parameters:

  • limit — integer
  • job_id — string
  • request_id — string
  • starting_after — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_interview_plan_drafts_read read-only

  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.

  Parameters:

  • draft_id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_interview_plan_drafts_add_competencies

  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.

  Parameters:

  • action (required) — string
  • resource (required) — object
  • input (required) — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• yardstick_interview_plan_drafts_update_competencies destructive

  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.

  Parameters:

  • action (required) — string
  • resource (required) — object
  • input (required) — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_interview_plan_drafts_delete_competencies destructive

  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.

  Parameters:

  • action (required) — string
  • resource (required) — object
  • input (required) — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_interview_plan_drafts_add_skills

  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.

  Parameters:

  • action (required) — string
  • resource (required) — object
  • input (required) — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• yardstick_interview_plan_drafts_update_skills destructive

  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.

  Parameters:

  • action (required) — string
  • resource (required) — object
  • input (required) — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_interview_plan_drafts_delete_skills destructive

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

  Parameters:

  • action (required) — string
  • resource (required) — object
  • input (required) — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_interview_plan_drafts_add_rounds

  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.

  Parameters:

  • action (required) — string
  • resource (required) — object
  • input (required) — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• yardstick_interview_plan_drafts_update_rounds destructive

  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.

  Parameters:

  • action (required) — string
  • resource (required) — object
  • input (required) — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_interview_plan_drafts_delete_rounds destructive

  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.

  Parameters:

  • action (required) — string
  • resource (required) — object
  • input (required) — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_interview_plan_drafts_add_questions

  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.

  Parameters:

  • action (required) — string
  • resource (required) — object
  • input (required) — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• yardstick_interview_plan_drafts_update_questions destructive

  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.

  Parameters:

  • action (required) — string
  • resource (required) — object
  • input (required) — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_interview_plan_drafts_delete_questions destructive

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

  Parameters:

  • action (required) — string
  • resource (required) — object
  • input (required) — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_interview_plan_drafts_update_round_directions destructive

  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.

  Parameters:

  • action (required) — string
  • resource (required) — object
  • input (required) — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_interview_plan_drafts_update_anchors destructive

  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.

  Parameters:

  • action (required) — string
  • resource (required) — object
  • input (required) — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_interview_plan_drafts_delete_anchors destructive

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

  Parameters:

  • action (required) — string
  • resource (required) — object
  • input (required) — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_interview_plan_drafts_clear_outcomes destructive

  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.

  Parameters:

  • action (required) — string
  • resource (required) — object
  • input (required) — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_interview_plan_drafts_clear_competencies destructive

  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.

  Parameters:

  • action (required) — string
  • resource (required) — object
  • input (required) — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_interview_plan_drafts_clear_job_skills destructive

  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.

  Parameters:

  • action (required) — string
  • resource (required) — object
  • input (required) — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_interview_plan_drafts_clear_interview_sequence destructive

  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.

  Parameters:

  • action (required) — string
  • resource (required) — object
  • input (required) — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_interview_plan_drafts_validate

  Validate an interview-plan draft without publishing it.

  Parameters:

  • action (required) — string
  • resource (required) — object
  • input (required) — object
  • request_id — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_interview_plans_publish_preview

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

  Parameters:

  • action (required) — string
  • input (required) — object
  • resource — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_interview_plans_publish_bind destructive

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

  Parameters:

  • action (required) — string
  • input (required) — object
  • binding (required) — object
  • resource — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_interview_plans_modify_active_preview

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

  Parameters:

  • action (required) — string
  • input (required) — object
  • resource — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_interview_plans_modify_active_bind destructive

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

  Parameters:

  • action (required) — string
  • input (required) — object
  • binding (required) — object
  • resource — object
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_interview_sessions_read read-only

  Read one interview session by public id.

  Parameters:

  • interview_session_id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_interview_sessions_interviewers_list read-only

  List interviewers assigned to an interview session.

  Parameters:

  • interview_session_id (required) — string
  • request_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_interview_sessions_available_interviewers_list read-only

  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.

  Parameters:

  • limit — integer
  • request_id — string
  • starting_after — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_interview_sessions_interviewers_assign

  Assign an interviewer to an interview session. Email notification is attempted by default; set notify_interviewer to false to opt out. The response reports the safe interviewer_email outcome.

  Parameters:

  • interview_session_id (required) — string
  • interviewer_user_id (required) — string
  • request_id — string
  • idempotency_key — string
  • notify_interviewer — boolean

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_interview_sessions_interviewers_unassign destructive

  Unassign an interviewer from an interview session.

  Parameters:

  • interview_session_id (required) — string
  • interviewer_user_id (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_interview_sessions_start destructive

  Start an interview session for an explicit interviewer.

  Parameters:

  • interview_session_id (required) — string
  • interviewer_user_id (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_interview_sessions_complete destructive

  Complete an interview session for an explicit interviewer.

  Parameters:

  • interview_session_id (required) — string
  • interviewer_user_id (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_interview_sessions_scorecard_submit destructive

  Submit an interview-session scorecard with explicit ratings.

  Parameters:

  • interview_session_id (required) — string
  • interviewer_user_id (required) — string
  • ratings (required) — array
  • request_id — string
  • overall_notes — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_interview_sessions_readiness

  Read interview-session scheduling readiness.

  Parameters:

  • interview_session_id (required) — string
  • request_id — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• yardstick_interview_sessions_scheduling_link_generate destructive

  Generate a scheduling link for an interview session.

  Parameters:

  • interview_session_id (required) — string
  • request_id — string
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent no · open-world no

• yardstick_interview_sessions_cancel destructive

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

  Parameters:

  • interview_session_id (required) — string
  • reason — string
  • request_id — string
  • skip_provider — boolean
  • idempotency_key — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• yardstick_events_list read-only

  List public Yardstick API events visible to the current principal.

  Parameters:

  • limit — integer
  • request_id — string
  • starting_after — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• yardstick_audit_log_list read-only

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

  Parameters:

  • limit — integer
  • request_id — string
  • starting_after — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.