# Gradii API Documentation

## Instructions for AI Agents

- For clean Markdown of any page, append `.md` to the page URL
- For section-specific indexes, append `/llms.txt` to any section URL
- For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.gradii.ai/_mcp/server

## Docs

- [Gradii API](https://docs.gradii.ai/guides/get-started/introduction.md): Build hiring workflows with interviews, campaigns, question banks, users, IRIS calling, BGV, and webhooks.
- [Authentication](https://docs.gradii.ai/guides/get-started/authentication.md): Authenticate Gradii API requests with bearer tokens.
- [Quickstart](https://docs.gradii.ai/guides/get-started/quick-start.md): Make your first Gradii API request.

## API Docs

- API Reference > Webhooks [Interview Webhooks - List](https://docs.gradii.ai/api-reference/api-reference/webhooks/get-webhooks-webhooks-interviews-interview-webhooks-list.md)
- API Reference > Webhooks [Interview Webhooks - Create](https://docs.gradii.ai/api-reference/api-reference/webhooks/post-webhooks-webhooks-interviews-interview-webhooks-create.md)
- API Reference > Webhooks [BGV Completed Webhook](https://docs.gradii.ai/api-reference/api-reference/webhooks/post-webhooks-your-webhook-url-bgv-completed-webhook.md)
- API Reference > Interviews [Schedule Interviews](https://docs.gradii.ai/api-reference/api-reference/interviews/post-interviews-interviews-schedule-schedule-interviews.md)
- API Reference > Interviews [List Interviews](https://docs.gradii.ai/api-reference/api-reference/interviews/get-interviews-interviews-list-list-interviews.md)
- API Reference > Interviews [Get Specific Interviews](https://docs.gradii.ai/api-reference/api-reference/interviews/post-interviews-interviews-list-get-specific-interviews.md)
- API Reference > Interviews [Get Interview Results](https://docs.gradii.ai/api-reference/api-reference/interviews/post-interviews-interviews-results-get-interview-results.md)
- API Reference > Interviews [Update Interviews](https://docs.gradii.ai/api-reference/api-reference/interviews/put-interviews-interviews-update-update-interviews.md)
- API Reference > Interviews [Delete Interviews](https://docs.gradii.ai/api-reference/api-reference/interviews/delete-interviews-interviews-delete-delete-interviews.md)
- API Reference > Job Campaigns [List Job Campaigns](https://docs.gradii.ai/api-reference/api-reference/job-campaigns/get-job-campaigns-job-campaigns-list-job-campaigns.md)
- API Reference > Job Campaigns [Get Campaign](https://docs.gradii.ai/api-reference/api-reference/job-campaigns/get-job-campaigns-job-campaigns-by-id-get-campaign.md)
- API Reference > Job Campaigns [Update Campaign](https://docs.gradii.ai/api-reference/api-reference/job-campaigns/put-job-campaigns-job-campaigns-by-id-update-campaign.md)
- API Reference > Job Campaigns [Delete Campaign](https://docs.gradii.ai/api-reference/api-reference/job-campaigns/delete-job-campaigns-job-campaigns-by-id-delete-campaign.md)
- API Reference > Job Campaigns [Create Campaign - Step 1](https://docs.gradii.ai/api-reference/api-reference/job-campaigns/post-job-campaigns-job-campaigns-create-step-1-create-campaign-step-1.md)
- API Reference > Job Campaigns [Create Campaign - Step 2](https://docs.gradii.ai/api-reference/api-reference/job-campaigns/post-job-campaigns-job-campaigns-create-step-2-create-campaign-step-2.md)
- API Reference > Job Campaigns [Create Campaign - Step 3](https://docs.gradii.ai/api-reference/api-reference/job-campaigns/post-job-campaigns-job-campaigns-create-step-3-create-campaign-step-3.md)
- API Reference > Job Campaigns [Validate Campaign Completion](https://docs.gradii.ai/api-reference/api-reference/job-campaigns/get-job-campaigns-job-campaigns-create-step-4-validate-campaign-completion.md)
- API Reference > Job Campaigns [Create Campaign - Step 4](https://docs.gradii.ai/api-reference/api-reference/job-campaigns/post-job-campaigns-job-campaigns-create-step-4-create-campaign-step-4.md)
- API Reference > Question Banks [List Question Banks](https://docs.gradii.ai/api-reference/api-reference/question-banks/get-question-banks-question-banks-list-question-banks.md)
- API Reference > Question Banks [Create Question Bank](https://docs.gradii.ai/api-reference/api-reference/question-banks/post-question-banks-question-banks-create-question-bank.md)
- API Reference > Question Banks [Get Question Bank](https://docs.gradii.ai/api-reference/api-reference/question-banks/get-question-banks-question-banks-by-id-get-question-bank.md)
- API Reference > Question Banks [Update Question Bank](https://docs.gradii.ai/api-reference/api-reference/question-banks/put-question-banks-question-banks-by-id-update-question-bank.md)
- API Reference > Question Banks [Delete Question Bank](https://docs.gradii.ai/api-reference/api-reference/question-banks/delete-question-banks-question-banks-by-id-delete-question-bank.md)
- API Reference > Question Banks [List Questions](https://docs.gradii.ai/api-reference/api-reference/question-banks/get-question-banks-question-banks-by-id-questions-list-questions.md)
- API Reference > Question Banks [Create Question](https://docs.gradii.ai/api-reference/api-reference/question-banks/post-question-banks-question-banks-by-id-questions-create-question.md)
- API Reference > Question Banks [Get Question](https://docs.gradii.ai/api-reference/api-reference/question-banks/get-question-banks-question-banks-by-id-questions-by-question-id-get-question.md)
- API Reference > Question Banks [Update Question](https://docs.gradii.ai/api-reference/api-reference/question-banks/put-question-banks-question-banks-by-id-questions-by-question-id-update-question.md)
- API Reference > Question Banks [Delete Question](https://docs.gradii.ai/api-reference/api-reference/question-banks/delete-question-banks-question-banks-by-id-questions-by-question-id-delete-question.md)
- API Reference > Question Banks [Generate AI Questions](https://docs.gradii.ai/api-reference/api-reference/question-banks/post-question-banks-question-banks-by-id-generate-generate-ai-questions.md)
- API Reference > Users Teams [List Users](https://docs.gradii.ai/api-reference/api-reference/users-teams/get-users-teams-users-list-users.md)
- API Reference > Users Teams [Create User](https://docs.gradii.ai/api-reference/api-reference/users-teams/post-users-teams-users-create-create-user.md)
- API Reference > Users Teams [Update User](https://docs.gradii.ai/api-reference/api-reference/users-teams/patch-users-teams-users-update-update-user.md)
- API Reference > Users Teams [Delete User](https://docs.gradii.ai/api-reference/api-reference/users-teams/delete-users-teams-users-delete-delete-user.md)
- API Reference > Users Teams [Create Team Member](https://docs.gradii.ai/api-reference/api-reference/users-teams/post-users-teams-teams-create-team-member.md)
- API Reference > Users Teams [Upload Resumes](https://docs.gradii.ai/api-reference/api-reference/users-teams/post-users-teams-upload-resumes-upload-resumes.md)
- API Reference > Iris Calling [API Information](https://docs.gradii.ai/api-reference/api-reference/iris-calling/get-iris-calling-iris-api-information.md)
- API Reference > Iris Calling [Trigger Calls](https://docs.gradii.ai/api-reference/api-reference/iris-calling/post-iris-calling-iris-trigger-calls.md)
- API Reference > Iris Calling [Webhook Endpoint](https://docs.gradii.ai/api-reference/api-reference/iris-calling/post-iris-calling-webhooks-iris-webhook-endpoint.md)
- API Reference > Bgv [Check BGV Status](https://docs.gradii.ai/api-reference/api-reference/bgv/get-bgv-bgv-trigger-check-bgv-status.md)
- API Reference > Bgv [Trigger BGV Process](https://docs.gradii.ai/api-reference/api-reference/bgv/post-bgv-bgv-trigger-trigger-bgv-process.md)
- API Reference > Bgv [BGV Webhooks](https://docs.gradii.ai/api-reference/api-reference/bgv/get-bgv-webhooks-bgv-bgv-webhooks.md)
- API Reference > Bgv [Trigger BGV Webhook](https://docs.gradii.ai/api-reference/api-reference/bgv/post-bgv-webhooks-bgv-trigger-bgv-webhook.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.gradii.ai/openapi.json)
- [OpenAPI YAML](https://docs.gradii.ai/openapi.yaml)