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));

{
  "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]"
  ],
  "language": "<string>",
  "custom_message": "<string>",
  "custom_focus": "<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>"
  },
  "test_runs": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "status": "pending",
      "language": "<string>",
      "started_from_topic_index": 123,
      "started_from_topic_title": "<string>",
      "skipped_topic_ids": [
        "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      ],
      "jumps": [
        {
          "from_topic_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "to_topic_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "at_message_count": 123
        }
      ],
      "message_count": 123,
      "draft_changed_since_start": true,
      "interview_url": "<string>",
      "draft_source_session": {
        "kind": "clara_fast",
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>"
      },
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "source_session": {
    "kind": "clara_fast",
    "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));

{
  "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]"
  ],
  "language": "<string>",
  "custom_message": "<string>",
  "custom_focus": "<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>"
  },
  "test_runs": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "status": "pending",
      "language": "<string>",
      "started_from_topic_index": 123,
      "started_from_topic_title": "<string>",
      "skipped_topic_ids": [
        "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      ],
      "jumps": [
        {
          "from_topic_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "to_topic_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "at_message_count": 123
        }
      ],
      "message_count": 123,
      "draft_changed_since_start": true,
      "interview_url": "<string>",
      "draft_source_session": {
        "kind": "clara_fast",
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>"
      },
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "source_session": {
    "kind": "clara_fast",
    "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.

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.

custom_focus

string | null

Overrides the "what it's about" focus block in invitation emails without changing the interview focus. Null (the default) shows the topic truncated to a teaser; empty string removes the block; text is shown verbatim.

Maximum string length: 500

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

test_runs

object[]

read-only

This draft's test runs, newest first (see InterviewTestRun).

Show child attributes

source_session

object | null

The Clara session that created a draft (provenance, SET_NULL on both ends). kind decides the route a client builds: clara_fast = in-process Work with Clara conversation (/agent/clara-fast?conversation_id=), cma = Managed-Agents Clara session (/agent/clara?session_id=), coach = any other coach conversation (e.g. scoping), recorded but not linked from the test page.

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