Spark Hire Users API
Company users (evaluators) and their integration API keys.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/spark-hire-users-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Spark Hire Users API
description: The Spark Hire API embeds video interviewing and talent assessment into an applicant tracking system or custom hiring application.
version: '1.0'
contact:
name: Spark Hire
url: https://www.sparkhire.com
servers:
- url: https://api.sparkhire.com/v1.0
description: Spark Hire API
security:
- basicAuth: []
tags:
- name: Users
description: Company users (evaluators) and their integration API keys.
paths:
/users:
get:
operationId: listUsers
tags:
- Users
summary: List users
parameters:
- $ref: '#/components/parameters/Range'
- $ref: '#/components/parameters/OrderBy'
responses:
'200':
description: A list of users.
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/User'
'401':
$ref: '#/components/responses/Unauthorized'
post:
operationId: createUser
tags:
- Users
summary: Create a user
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/UserInput'
responses:
'201':
description: The created user.
content:
application/json:
schema:
$ref: '#/components/schemas/User'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
/users/{uuid}:
parameters:
- $ref: '#/components/parameters/Uuid'
get:
operationId: getUser
tags:
- Users
summary: Get a user
responses:
'200':
description: A user.
content:
application/json:
schema:
$ref: '#/components/schemas/User'
'404':
$ref: '#/components/responses/NotFound'
put:
operationId: updateUser
tags:
- Users
summary: Update a user
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/UserInput'
responses:
'200':
description: The updated user.
content:
application/json:
schema:
$ref: '#/components/schemas/User'
'404':
$ref: '#/components/responses/NotFound'
delete:
operationId: deleteUser
tags:
- Users
summary: Delete a user
responses:
'204':
description: The user was deleted.
'404':
$ref: '#/components/responses/NotFound'
/users/{uuid}/integration_key:
parameters:
- $ref: '#/components/parameters/Uuid'
get:
operationId: getIntegrationKey
tags:
- Users
summary: Get a user's integration API key
responses:
'200':
description: The integration key.
content:
application/json:
schema:
$ref: '#/components/schemas/IntegrationKey'
'404':
$ref: '#/components/responses/NotFound'
post:
operationId: createIntegrationKey
tags:
- Users
summary: Create a user's integration API key
responses:
'201':
description: The created integration key.
content:
application/json:
schema:
$ref: '#/components/schemas/IntegrationKey'
put:
operationId: updateIntegrationKey
tags:
- Users
summary: Rotate a user's integration API key
responses:
'200':
description: The rotated integration key.
content:
application/json:
schema:
$ref: '#/components/schemas/IntegrationKey'
delete:
operationId: deleteIntegrationKey
tags:
- Users
summary: Revoke a user's integration API key
responses:
'204':
description: The integration key was revoked.
components:
schemas:
UserInput:
type: object
properties:
first_name:
type: string
last_name:
type: string
email:
type: string
format: email
permission_level:
type: string
description: The user's role/permission level within the company.
User:
allOf:
- $ref: '#/components/schemas/UserInput'
- type: object
properties:
uuid:
type: string
format: uuid
created_at:
type: string
format: date-time
updated_at:
type: string
format: date-time
Error:
type: object
properties:
error:
type: string
message:
type: string
IntegrationKey:
type: object
properties:
uuid:
type: string
format: uuid
api_key:
type: string
description: The user's integration API key value.
created_at:
type: string
format: date-time
parameters:
Uuid:
name: uuid
in: path
required: true
description: The UUID of the resource.
schema:
type: string
format: uuid
Range:
name: range
in: query
required: false
description: Pagination range, e.g. 1-20 or 10-30.
schema:
type: string
example: 1-20
OrderBy:
name: orderby
in: query
required: false
description: Sort order, e.g. title_asc or updated_desc.
schema:
type: string
example: updated_desc
responses:
Unauthorized:
description: Missing or invalid API key.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
NotFound:
description: The resource was not found.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
BadRequest:
description: The request was malformed.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
securitySchemes:
basicAuth:
type: http
scheme: basic
description: HTTP Basic authentication. The username is your Spark Hire API key; the password is ignored. Keys are scoped to a user and respect that user's permission level.