Skip to main content

Commands Reference

Global Flags

FlagDescription
--api-key <key>Override authentication
--jsonOutput raw JSON (for scripting)
--helpShow help
--versionShow version

nexspace login-device

Start OAuth device-code login flow.
nexspace login-device

nexspace logout

Remove stored credentials.
nexspace logout

nexspace whoami

Print the current user and organization.
nexspace whoami

Facilities

nexspace facilities list

List all accessible facilities.
nexspace facilities list
nexspace facilities list --json

Staff

Search for staff members.
FlagDescription
--query <text>Free-text search
--specialty <code>Filter by specialty
--facility-id <id>Filter by facility
--limit <n>Max results (default: 20)
nexspace staff search --query "Jane"
nexspace staff search --specialty RN --facility-id 12

nexspace staff get <staffId>

Get full staff profile.
nexspace staff get 789

Shifts

nexspace shifts list

List shifts with optional filters.
FlagDescription
--facility-id <id>Filter by facility
--status <status>open, filled, cancelled
--from <date>Start date (YYYY-MM-DD)
--to <date>End date (YYYY-MM-DD)
nexspace shifts list --facility-id 12 --status open
nexspace shifts list --from 2026-05-10 --to 2026-05-17

nexspace shifts fill

Assign a staff member to a shift.
FlagDescription
--shift-id <id>Target shift
--staff-id <id>Staff to assign
nexspace shifts fill --shift-id 456 --staff-id 789

API Keys

nexspace api-keys list

List all API keys for the current org.
nexspace api-keys list

nexspace api-keys create

Create a new API key.
FlagDescription
--name <name>Key display name
--scopes <scopes>Comma-separated scopes
--rate-limit <n>Requests per minute
nexspace api-keys create --name "CI Pipeline" --scopes "shifts:read,staff:read"

nexspace api-keys revoke <keyId>

Revoke an API key immediately.
nexspace api-keys revoke 42

MCP

nexspace mcp tools

List all available MCP tools.
nexspace mcp tools

nexspace mcp call <toolName>

Invoke an MCP tool.
FlagDescription
--args <json>Tool arguments as JSON
nexspace mcp call listFacilities
nexspace mcp call findCredentialedStaff --args '{"facilityId":12,"specialty":"RN"}'