Praxicraft Assess API for Technical Hiring

Official CLI for the Assess Public API. Invite candidates, manage assessments and pipelines, work with webhooks and interviews, and automate hiring workflows from your terminal. Binary: praxicraft-assess. Source and releases: praxicraft-assess-cli. You need an organisation API key (ct_live_… or ct_test_…) from Assess → Developer → API Keys.

Install

curl -fsSL https://praxicraft.com/install.sh | sh

That URL redirects to the installer on GitHub. The script detects your OS/CPU, downloads the latest Release binary, and installs praxicraft-assess to /usr/local/bin (or ~/.local/bin if you don’t have write access). Optional install directory:

curl -fsSL https://praxicraft.com/install.sh | PRAXICRAFT_INSTALL_DIR="$HOME/bin" sh

Manual (GitHub Releases)

Download an archive from Releases, extract it, and put praxicraft-assess on your PATH. Builds: darwin_amd64, darwin_arm64, linux_amd64, linux_arm64, windows_amd64, windows_arm64.

From source

git clone https://github.com/praxicraft-platform/praxicraft-assess-cli.git
cd praxicraft-assess-cli
go install ./cmd/praxicraft-assess

Requires Go 1.22+.

Configure

praxicraft-assess configure

Or set environment variables:

export PRAXICRAFT_API_KEY="ct_test_xxxxxxxxxxxxxxxx"
# optional
export PRAXICRAFT_API_BASE_URL="https://assess.praxicraft.com"

Profiles are stored in ~/.config/praxicraft/config.toml. Use --profile to switch between them.

praxicraft-assess whoami

Quickstart

praxicraft-assess org get
praxicraft-assess assessments list --output table
praxicraft-assess invites create senior-backend-screen --email [email protected] --name "Jane Doe"
praxicraft-assess invites result <invite-token>

Run praxicraft-assess with no arguments to open an interactive shell. JSON bodies for create/update:

praxicraft-assess assessments create --body '{"title":"Backend screen"}'
praxicraft-assess assessments create --body-file ./assessment.json

Commands

Group	What you can do
`org`	Profile, stats, team, audit log, squads
`assessments`	List, create, update, duplicate, cases, results
`invites`	Create, bulk create, list, remind, cancel, result
`results`	List by assessment, get by invite token
`cases`	Platform and organisation cases
`pipelines`	Enroll, bulk enroll, hold, reject, enrollments
`webhooks`	Endpoints, test pings, deliveries, retries
`interviews`	Rooms, templates, analysis, share, cancel
`integrations`	Connected ATS providers

Run praxicraft-assess <command> --help for flags on any command.

Useful flags

Flag	Description
`--api-key`	API key (overrides env / config)
`--base-url`	API host (default `https://assess.praxicraft.com`)
`--profile`	Named config profile
`--output`	`json`, `table`, or `yaml`
`--query`	JMESPath filter on JSON output
`--yes`	Skip confirmation prompts
`--non-interactive`	Disable prompts (CI-friendly)

Examples

More recipes (SDKs, curl, n8n, Zapier) live in praxicraft-assess-examples.

Authentication · SDKs · API Reference · Verify webhooks

Official clients

CLI

Install

Manual (GitHub Releases)

From source

Configure

Quickstart

Commands

Useful flags

Examples

Next

​Install

​Manual (GitHub Releases)

​From source

​Configure

​Quickstart

​Commands

​Useful flags

​Examples

​Next

Install

Manual (GitHub Releases)

From source

Configure

Quickstart

Commands

Useful flags

Examples

Next