Public REST/JSON reference

Interview Question Bank Generator API

Generates structured interview question banks, rubrics, and role-specific interview plans for repeatable hiring loops. Use this API to create question banks from role requirements, retrieve interview questions and rubrics, generate candidate-specific interview plans, and keep interview loops consistent across teams. Part of the Logic Igniter HR & Workforce Suite.

Access boundary

These examples describe public API calls only. Use the service output to review, score, summarize, analyze, or recommend; do not treat the API reference as permission for an assistant to write, send, publish, charge, schedule, notify, delete, or modify records.

Base URL

https://api.logicigniter.com

Auth

Authorization: Bearer YOUR_API_KEY

Version

OpenAPI 3.0.3 · 1.0.0

Spec

/api-specs/interviewbank.json

Operations rendered

Response models rendered

GET/api/v1/interviewbank/banks

List question banks

Return generated question banks for the workspace.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`page_size`	query	integer
`page_token`	query	string

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/interviewbank/banks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200QuestionBanks

Successful response

400Error

Invalid request payload or query parameter.

401Error

Missing, expired, or invalid bearer token.

402Error

Active HR & Workforce Suite subscription required.

404Error

Requested resource was not found for this workspace.

500Error

Unexpected service error.

POST/api/v1/interviewbank/banks

Generate question bank

Generate a structured question bank for a role and competency set.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request body (required)

Schema: GenerateQuestionBankRequest

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X POST "https://api.logicigniter.com/api/v1/interviewbank/banks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{}'

Responses

201QuestionBank

Successful response

400Error

Invalid request payload or query parameter.

401Error

Missing, expired, or invalid bearer token.

402Error

Active HR & Workforce Suite subscription required.

404Error

Requested resource was not found for this workspace.

500Error

Unexpected service error.

GET/api/v1/interviewbank/banks/{id}

Get question bank

Return bank metadata, competencies, and included questions.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`id`required	path	string

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/interviewbank/banks/:id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200QuestionBank

Successful response

400Error

Invalid request payload or query parameter.

401Error

Missing, expired, or invalid bearer token.

402Error

Active HR & Workforce Suite subscription required.

404Error

Requested resource was not found for this workspace.

500Error

Unexpected service error.

GET/api/v1/interviewbank/banks/{id}/questions

List bank questions

Return interview questions grouped by competency and difficulty.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type
`id`required	path	string
`page_size`	query	integer
`page_token`	query	string

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/interviewbank/banks/:id/questions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200InterviewQuestions

Successful response

400Error

Invalid request payload or query parameter.

401Error

Missing, expired, or invalid bearer token.

402Error

Active HR & Workforce Suite subscription required.

404Error

Requested resource was not found for this workspace.

500Error

Unexpected service error.

GET/api/v1/interviewbank/questions/{id}

Get question detail

Return one interview question with rubric and strong-answer signals.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`id`required	path	string

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/interviewbank/questions/:id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200InterviewQuestion

Successful response

400Error

Invalid request payload or query parameter.

401Error

Missing, expired, or invalid bearer token.

402Error

Active HR & Workforce Suite subscription required.

404Error

Requested resource was not found for this workspace.

500Error

Unexpected service error.

POST/api/v1/interviewbank/plans

Generate interview plan

Create a structured interview plan for a role or candidate stage.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request body (required)

Schema: GenerateInterviewPlanRequest

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X POST "https://api.logicigniter.com/api/v1/interviewbank/plans" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{}'

Responses

201InterviewPlan

Successful response

400Error

Invalid request payload or query parameter.

401Error

Missing, expired, or invalid bearer token.

402Error

Active HR & Workforce Suite subscription required.

404Error

Requested resource was not found for this workspace.

500Error

Unexpected service error.

GET/api/v1/interviewbank/plans/{id}

Get interview plan

Return interviewer assignments, questions, and scoring rubric for a plan.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`id`required	path	string

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/interviewbank/plans/:id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200InterviewPlan

Successful response

400Error

Invalid request payload or query parameter.

401Error

Missing, expired, or invalid bearer token.

402Error

Active HR & Workforce Suite subscription required.

404Error

Requested resource was not found for this workspace.

500Error

Unexpected service error.

Data models

Error

Field	Type	Notes
`code`required	string	Example: "invalid_request"
`message`required	string	Example: "The request body is missing a required field."
`request_id`	string	Example: "req_01HX7K9Z8W"

QuestionBank

Field	Type	Notes
`bank_id`required	string	Example: "bank_sales_mgr"
`role_title`required	string	Example: "Sales Manager"
`competency_count`required	integer	Example: 5
`question_count`required	integer	Example: 18
`status`required	string	Example: "ready"

QuestionBanks

Field	Type	Notes
`items`required	array<QuestionBank>
`next_page_token`	string	Example: "eyJvZmZzZXQiOjI1fQ=="

GenerateQuestionBankRequest

Field	Type	Notes
`role_title`required	string	Example: "Sales Manager"
`seniority`required	string	Example: "manager"
`competencies`required	array<string>	Example: ["pipeline management","coaching","forecasting accuracy"]
`interview_format`required	string	Example: "structured_panel"

InterviewPlan

GenerateInterviewPlanRequest

Field	Type	Notes
`role_title`required	string	Example: "Sales Manager"
`seniority`required	string	Example: "manager"
`competencies`required	array<string>	Example: ["pipeline management","coaching","forecasting accuracy"]
`interview_format`required	string	Example: "structured_panel"

InterviewQuestions

Field	Type	Notes
`items`required	array<object>
`next_page_token`	string	Example: null