conecto. Get started
Hiring

List skills tests

hiring_list_assessments · Reads only · Markdown

The business's skills tests: title, questions, time limit, and how many were sent and completed.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

An example

Which skills tests do we have, and how many candidates finished each?

Your agent callshiring_list_assessmentsFree*

The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.

With these arguments
{}
What comes back
{
  "assessments": [
    {
      "assessment": "workshop-basics",
      "title": "Workshop basics",
      "intro": null,
      "time_limit_minutes": 20,
      "shuffle": false,
      "question_count": 2,
      "max_score": 6,
      "sent": 1,
      "completed": 0,
      "updated_at": "2026-10-14T08:00:00+00:00"
    }
  ]
}

Use it when

To find a test's slug, or see how it is used.

What it does

This account's tests: title, questions, time limit, how many were sent and completed.

What comes back

assessments: each with its slug, title, question count, time limit, and how many were sent and completed (with full: true, the questions and answer keys). Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
fullbooleanInclude the questions and answer keys. Default: false.

The call

Over MCP, call hiring_list_assessments on https://api.conecto.chat/mcp/hiring. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/hiring_list_assessments \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

More Hiring tools

All 25 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md