POST
/
v1
/
interviews
Submit interview data
curl --request POST \
  --url https://api.vistaly.com/v1/interviews \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "body": "<string>",
  "feedbackProviders": [
    {
      "firstName": "<string>",
      "lastName": "<string>",
      "email": "jsmith@example.com"
    }
  ],
  "feedbackReceivers": [
    {
      "email": "jsmith@example.com"
    }
  ],
  "parseMarkdown": true,
  "timestamp": "2023-11-07T05:31:56Z",
  "url": "https://www.vistaly.com"
}'
{
  "message": "Interview created"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
body
string
required

The content of the feedback/interview

​
feedbackProviders
object[]

An array of individuals who provided the feedback/interview, each with their first name (optional), last name (optional), and email

​
feedbackReceivers
object[]

An array of individuals who received the feedback or conducted the interview. If the individual isn't a member of your Vistaly organization, their value will be ignored.

​
parseMarkdown
boolean

Whether to parse the body content as markdown and convert to structured format (defaults to false)

​
timestamp
string<date-time>

The timestamp of when the feedback/interview was captured (defaults to current timestamp if not provided)

​
url
string<uri>

The url where the feedback/interview came from

Example:

"https://www.vistaly.com"

Response

Interview data submitted successfully

​
message
string
Example:

"System provided message"