Skip to content
Documentation
English
Explore guides

For administrators

Meeting templates

List, create, show, update, and delete meeting question templates, and manage their questions.

Contents

Before you start

Send Accept: application/json and Authorization: Bearer YOUR_TOKEN to https://{subdomain}.talentohq.com. See API for authentication.

Path and query identifiers are UUID strings.

Successful responses use 200. Validation failures use 422. Missing or invalid tokens, and records that cannot be found, use 401.

Requires settings access. A meeting template is a reusable set of questions. Set show_in_meeting to use it in 1:1s. Set show_in_job_step and job_step_template_ids to use it in hiring interviews. Questions on these templates are free-text prompts.

List all meeting templates

GET /api/v3/meeting_templates

Results are paginated. Pass page to move through pages of 50 records.

Response 200 

[
  {
    "id": "1ae2fd31-da27-434e-92f2-b8f4480b57a8",
    "name": "First interview — company",
    "description": "Company-fit questions",
    "show_in_meeting": false,
    "show_in_job_step": true,
    "job_step_templates": [
      {
        "id": "2c2d2fd9-fe83-480a-adb8-351efc6a9808",
        "name": "First interview"
      }
    ],
    "questions": [
      {
        "id": "3ed57043-3894-43e9-a03b-69883506a3d6",
        "name": "Why this role?",
        "tags": ["motivation"]
      }
    ]
  }
]

Create a meeting template

POST /api/v3/meeting_templates

Request

{
  "name": "First interview — company",
  "description": "Company-fit questions",
  "show_in_meeting": false,
  "show_in_job_step": true,
  "job_step_template_ids": ["2c2d2fd9-fe83-480a-adb8-351efc6a9808"],
  "questions": [
    {
      "name": "Why this role?",
      "tags": ["motivation"]
    }
  ]
}

Response 200 

{
  "id": "1ae2fd31-da27-434e-92f2-b8f4480b57a8",
  "name": "First interview — company",
  "description": "Company-fit questions",
  "show_in_meeting": false,
  "show_in_job_step": true,
  "job_step_templates": [
    {
      "id": "2c2d2fd9-fe83-480a-adb8-351efc6a9808",
      "name": "First interview"
    }
  ],
  "questions": [
    {
      "id": "3ed57043-3894-43e9-a03b-69883506a3d6",
      "name": "Why this role?",
      "tags": ["motivation"]
    }
  ]
}

Show a meeting template

GET /api/v3/meeting_templates/{meeting_template_id}

Response 200 

{
  "id": "1ae2fd31-da27-434e-92f2-b8f4480b57a8",
  "name": "First interview — company",
  "description": "Company-fit questions",
  "show_in_meeting": false,
  "show_in_job_step": true,
  "job_step_templates": [
    {
      "id": "2c2d2fd9-fe83-480a-adb8-351efc6a9808",
      "name": "First interview"
    }
  ],
  "questions": [
    {
      "id": "3ed57043-3894-43e9-a03b-69883506a3d6",
      "name": "Why this role?",
      "tags": ["motivation"]
    }
  ]
}

Update a meeting template

PUT /api/v3/meeting_templates/{meeting_template_id}

Request

{
  "name": "First interview — company",
  "description": "Updated description",
  "show_in_meeting": true,
  "show_in_job_step": true,
  "job_step_template_ids": ["2c2d2fd9-fe83-480a-adb8-351efc6a9808"]
}

Response 200 

{
  "id": "1ae2fd31-da27-434e-92f2-b8f4480b57a8",
  "name": "First interview — company",
  "description": "Updated description",
  "show_in_meeting": true,
  "show_in_job_step": true,
  "job_step_templates": [
    {
      "id": "2c2d2fd9-fe83-480a-adb8-351efc6a9808",
      "name": "First interview"
    }
  ],
  "questions": [
    {
      "id": "3ed57043-3894-43e9-a03b-69883506a3d6",
      "name": "Why this role?",
      "tags": ["motivation"]
    }
  ]
}

Delete a meeting template

DELETE /api/v3/meeting_templates/{meeting_template_id}

The template must have no questions. Delete its questions first.

Response 200 

{}

Questions

Questions belong to a meeting template. They are free-text prompts with optional tags.

List questions

GET /api/v3/meeting_templates/{meeting_template_id}/questions

Response 200 

[
  {
    "id": "3ed57043-3894-43e9-a03b-69883506a3d6",
    "name": "Why this role?",
    "tags": ["motivation"]
  }
]

Create a question

POST /api/v3/meeting_templates/{meeting_template_id}/questions

Request

{
  "name": "Why this role?",
  "tags": ["motivation"]
}

Response 200 

{
  "id": "3ed57043-3894-43e9-a03b-69883506a3d6",
  "name": "Why this role?",
  "tags": ["motivation"]
}

Show a question

GET /api/v3/meeting_templates/{meeting_template_id}/questions/{question_id}

Response 200 

{
  "id": "3ed57043-3894-43e9-a03b-69883506a3d6",
  "name": "Why this role?",
  "tags": ["motivation"]
}

Update a question

PUT /api/v3/meeting_templates/{meeting_template_id}/questions/{question_id}

Request

{
  "name": "Why do you want this role?",
  "tags": ["motivation"]
}

Response 200 

{
  "id": "3ed57043-3894-43e9-a03b-69883506a3d6",
  "name": "Why do you want this role?",
  "tags": ["motivation"]
}

Delete a question

DELETE /api/v3/meeting_templates/{meeting_template_id}/questions/{question_id}

A question that has already been asked in a 1:1 or interview cannot be deleted.

Response 200 

{}