Retrieve an interview draft

import requests

url = "https://eu.app.clarifeye.ai/api/v1/projects/{project_id}/interview-drafts/{draft_id}/"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://eu.app.clarifeye.ai/api/v1/projects/{project_id}/interview-drafts/{draft_id}/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

curl --request GET \
  --url https://eu.app.clarifeye.ai/api/v1/projects/{project_id}/interview-drafts/{draft_id}/ \
  --header 'Authorization: Bearer <token>'

{
  "topic": "<string>",
  "interview_type": "interview",
  "questions": [
    "<string>"
  ],
  "topics": [
    {
      "title": "<string>",
      "description": "<string>",
      "skill_id": "<string>"
    }
  ],
  "assignee_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "invite_emails": [
    "[email protected]"
  ],
  "write_scope": "local",
  "focused_mode": false,
  "language": "<string>",
  "custom_message": "<string>",
  "scheduled_send_at": "2023-11-07T05:31:56Z",
  "reminders_enabled": false,
  "reminder_start_after_days": 2,
  "reminder_interval_days": 3,
  "reminder_max_count": 3,
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "campaign": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>"
  },
  "created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_by_email": "[email protected]",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

{
  "error": "Authentication credentials were not provided."
}

{
  "error": "You do not have permission to perform this action."
}

{
  "error": "Not found."
}

GET

projects

{project_id}

interview-drafts

{draft_id}

Retrieve an interview draft

import requests

url = "https://eu.app.clarifeye.ai/api/v1/projects/{project_id}/interview-drafts/{draft_id}/"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://eu.app.clarifeye.ai/api/v1/projects/{project_id}/interview-drafts/{draft_id}/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

curl --request GET \
  --url https://eu.app.clarifeye.ai/api/v1/projects/{project_id}/interview-drafts/{draft_id}/ \
  --header 'Authorization: Bearer <token>'

{
  "topic": "<string>",
  "interview_type": "interview",
  "questions": [
    "<string>"
  ],
  "topics": [
    {
      "title": "<string>",
      "description": "<string>",
      "skill_id": "<string>"
    }
  ],
  "assignee_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "invite_emails": [
    "[email protected]"
  ],
  "write_scope": "local",
  "focused_mode": false,
  "language": "<string>",
  "custom_message": "<string>",
  "scheduled_send_at": "2023-11-07T05:31:56Z",
  "reminders_enabled": false,
  "reminder_start_after_days": 2,
  "reminder_interval_days": 3,
  "reminder_max_count": 3,
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "campaign": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>"
  },
  "created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_by_email": "[email protected]",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

{
  "error": "Authentication credentials were not provided."
}

{
  "error": "You do not have permission to perform this action."
}

{
  "error": "Not found."
}

Authorizations

Authorization

string

header

required

Use Authorization: Bearer

Path Parameters

project_id

string<uuid>

required

UUID of the project

draft_id

string<uuid>

required

UUID of the interview draft

Response

Successful response

A saved, unsent interview-assignment payload. Becomes one interview per recipient when sent via the assign endpoint (with draft_id), which also deletes the draft.

topic

string

The interview focus. When set, a short title is generated from it.

interview_type

enum<string>

default:interview

Which conversation type the draft fans out to when sent. Set at creation (form type cards, or the scoping conversation's draft tool) and immutable afterwards — updates that change it are rejected (400).

Available options:

interview,

guided-interview

questions

string[]

Optional specific topics or questions (max 10). Rejected on guided-interview drafts — their topics structure the conversation.

topics

object[]

Guided drafts only (rejected otherwise): the ordered, editable topics the interview walks through (max 12). The scoping conversation's draft tool pre-seeds them from the standard guide.

Show child attributes

assignee_ids

string<uuid>[]

UUIDs of project members to interview. May go stale; re-validated at send.

invite_emails

string<email>[]

Emails of people not yet on the project. Nobody is contacted until the draft is sent.

write_scope

enum<string>

default:local

Available options:

local,

global

focused_mode

boolean

default:false

Simplified interview: recipients open the distraction-free full-page chat instead of the app. Best for external or mobile respondents.

language

string | null

ISO language code (e.g. fr) the interviews created from this draft must be conducted in. Null (the default) adapts to each recipient's own preferred language. Unknown codes are rejected (400).

custom_message

string

Optional note replacing the default invitation email copy.

scheduled_send_at

string<date-time> | null

reminders_enabled

boolean

default:false

reminder_start_after_days

integer

default:2

Required range: 1 <= x <= 30

reminder_interval_days

integer

default:3

Required range: 1 <= x <= 30

reminder_max_count

integer

default:3

Required range: 1 <= x <= 10

string<uuid>

read-only

name

string

read-only

Title generated from the topic at save time; empty when the draft has no topic (clients show "Untitled draft interview").

campaign

object | null

Campaign the interviews created from this draft will belong to; null when none. Set via campaign_id / campaign_name.

Show child attributes

created_by

string<uuid> | null

read-only

created_by_email

string<email> | null

read-only

created_at

string<date-time>

read-only

updated_at

string<date-time>

read-only

Create an interview draft Delete an interview draft

Concepts

Endpoints

Retrieve an interview draft

Authorizations

Path Parameters

Response