Skip to content
/
Update project details

Genway Public API (1.0.0)

Genway's API enables you to programmatically manage various aspects of your projects, prototypes, and interviews using our AI interviewer.

  • Projects - Create and manage Contextual Interviews or Prototype Testing projects.
  • Interviews - Manage and export interview data, including transcripts, summaries, audio, and video.

Genway API overview

Authentication

Genway API uses dual-header authentication for all requests to ensure secure access and proper tenant isolation.

Required Headers:

X-Api-Key: YOUR_API_KEY
X-Tenant-Id: YOUR_TENANT_UUID

Both headers are mandatory for every API call. Missing either header will result in authentication failure.

Versioning and stability

We strongly aim for backward compatibility for the documented endpoints. If backwards-incompatible changes are made, we will aim to release a new version.

  • URLs’ entry point is https://api.genway.ai/.
  • URLs are versioned https://api.genway.ai/v1/{endpoint}, e.g. https://api.genway.ai/v1/projects.

Rate limits and API status

The Genway API enforces per-IP rate limits to keep the platform responsive:

ScopeLimitEndpoints / Examples
Global throughputUp to 50 requests per minute per IPApplies to every endpoint, including Export interview video and Activate project.
Project creation10 requests per minute per IPCreate a new project (POST /projects).

When a limit is exceeded the API responds with 429 Too Many Requests, includes a Retry-After header indicating when you can resume sending requests, and returns the rate-limit payload documented in the 429 response example for endpoints such as Create a new project.

You can subscribe to our status page.

API support

If you require help you can contact our support team at support@genway.ai.

Download OpenAPI description
openapi.json
openapi.yaml
Languages
Servers
Production environment
https://api.genway.ai/v1

Multi-Tenancy

Genway provides a secure tenant-based authentication system that ensures strong data isolation between customers.

Tenants

Manage tenant creation and multi-tenancy setup.

Operations

Projects

Manage your projects programmatically.

Operations

Validate project context

Request

Validate a field controlling the context of a AI moderated interview project.

Security
api_key and tenant_id
Bodyapplication/jsonrequired
project_objectivestringnon-emptyrequired

The project objective to validate

Example: "The research on 'The Impact of Formula 1 Excitement on Fan Enthusiasm' is crucial for understanding how the thrill of racing influences spectator engagement and loyalty."
research_questionsstringnon-emptyrequired

The research questions to validate

Example: "Our primary research questions focus on understanding the impact of remote work on employee productivity and well-being."
success_criteriastringnon-emptyrequired

The success criteria to validate

Example: "Success for this project would be clearly evidenced by its direct influence on enhancing our product features, refining our design aesthetics, and strategically informing our marketing campaigns."
recruiting_criteriastringnon-emptyrequired

The recruiting criteria to validate

Example: "For this project, we are targeting interviewees who fall within the 30-50 age range, have a background in engineering or product management, and are currently employed in the tech industry."
curl -i -X POST \
  https://api.genway.ai/v1/project/validate-context \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY_HERE' \
  -H 'X-Tenant-Id: YOUR_API_KEY_HERE' \
  -d '{
    "project_objective": "The research on '\''The Impact of Formula 1 Excitement on Fan Enthusiasm'\'' is crucial for understanding how the thrill of racing influences spectator engagement and loyalty.",
    "research_questions": "Our primary research questions focus on understanding the impact of remote work on employee productivity and well-being.",
    "success_criteria": "Success for this project would be clearly evidenced by its direct influence on enhancing our product features, refining our design aesthetics, and strategically informing our marketing campaigns.",
    "recruiting_criteria": "For this project, we are targeting interviewees who fall within the 30-50 age range, have a background in engineering or product management, and are currently employed in the tech industry."
  }'

Responses

Validation result

Bodyapplication/json
project_objectiveanyrequired
project_objective.​is_validbooleanrequired

Indicates the field is valid

Default true
Valuetrue
Example: true
Discriminator
research_questionsanyrequired
research_questions.​is_validbooleanrequired

Indicates the field is valid

Default true
Valuetrue
Example: true
Discriminator
success_criteriaanyrequired
success_criteria.​is_validbooleanrequired

Indicates the field is valid

Default true
Valuetrue
Example: true
Discriminator
recruiting_criteriaanyrequired
recruiting_criteria.​is_validbooleanrequired

Indicates the field is valid

Default true
Valuetrue
Example: true
Discriminator
Response
application/json
{
  "project_objective": {
    "is_valid": true
  },
  "research_questions": {
    "is_valid": true
  },
  "success_criteria": {
    "is_valid": true
  },
  "recruiting_criteria": {
    "is_valid": true
  }
}

Retrieve all projects

Request

Retrieve all projects

Security
api_key and tenant_id
curl -i -X GET \
  https://api.genway.ai/v1/projects \
  -H 'X-Api-Key: YOUR_API_KEY_HERE' \
  -H 'X-Tenant-Id: YOUR_API_KEY_HERE'

Responses

Projects retrieved successfully

Bodyapplication/json
dataArray of objects(Data)required
data[].​project_idstring(uuid)required

Unique identifier for the project

Example: "123e4567-e89b-12d3-a456-426614174000"
data[].​project_typestringrequired

Type of project

Enum"contextual_interview""survey"
Example: "contextual_interview"
data[].​project_namestringnon-emptyrequired

The name of the project

Example: "The Impact of Formula 1 Excitement on Fan Enthusiasm"
data[].​project_descriptionstring or nullnon-empty

Optional description of the project

Example: "Formula 1 - US based fans"
data[].​created_atstring(date-time)required

Timestamp when the project was created

Example: "2024-01-15T10:30:00Z"
data[].​redirect_urlstring or null(uri)non-empty

URL to redirect users after completing the interview

Example: "https://example.com/thank-you"
data[].​interview_modesArray of strings(InterviewMode)required

Available interview interaction modes

Items Enum"typing""talking"
data[].​camera_accessstringrequired

Camera access requirements for interviews

Enum"not_allowed""optional""required"
Example: "optional"
data[].​logo_urlstring or null(uri)[ 1 .. 2083 ] characters

URL for custom logo to display in the interview interface

Example: "https://example.com/logo.png"
data[].​primary_colorstring or null^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$

Primary brand color (hex format)

Example: "#FF6B35"
Response
application/json
{
  "data": [
    { … }
  ]
}

Create a new project

Request

Create a new project (AI Moderated Interview or AI Moderated Survey)

Creation Modes:

  • Explicit Mode: Manually define all project context fields (project objective, research questions, success criteria, recruiting criteria)
  • Generated Mode: Provide a prompt and let AI generate the project context automatically. ⏱️ Note: Generated mode may take up to 1 minute to process due to AI content generation.

⚠️ Not Supported - Usability Testing projects creation is not yet supported.

Security
api_key and tenant_id
Bodyapplication/jsonrequired
One of:
project_typestringrequired
Default "contextual_interview"
Value"contextual_interview"
Example: "contextual_interview"
creation_modestring or null
Default "explicit"
Value"explicit"
Example: "explicit"
project_namestringnon-emptyrequired
Example: "The Impact of Formula 1 Excitement on Fan Enthusiasm"
project_objectivestringnon-emptyrequired
Example: "The research on 'The Impact of Formula 1 Excitement on Fan Enthusiasm' is crucial for understanding how the thrill of racing influences spectator engagement and loyalty. Current insights suggest that the suspense and unpredictability of races enhance viewer excitement and attachment to the sport. This study aims to delve deeper into these aspects, providing strategies to boost fan engagement and expand the sport's audience."
research_questionsstringnon-emptyrequired
Example: "Our primary research questions focus on understanding the impact of remote work on employee productivity and well-being. We hope to learn how different remote work policies affect job satisfaction and efficiency across various industries. Additionally, we aim to identify key factors that contribute to a successful remote work environment."
success_criteriastringnon-emptyrequired
Example: "Success for this project would be clearly evidenced by its direct influence on enhancing our product features, refining our design aesthetics, and strategically informing our marketing campaigns. Ideally, the research findings will provide actionable insights that directly correlate with increased user engagement and satisfaction. Ultimately, the goal is to leverage this research to drive meaningful improvements across all departments, ensuring that every decision is data-informed and aligned with our users' needs."
recruiting_criteriastringnon-emptyrequired
Example: "For this project, we are targeting interviewees who fall within the 30-50 age range, have a background in engineering or product management, and are currently employed in the tech industry. We are specifically focusing on individuals residing in North America and Europe to capture insights from key tech hubs. This demographic and customer segment approach ensures that we obtain targeted and relevant data for our research objectives."
specific_guidelinesstring or nullnon-empty
Example: "Ask from the interviewees to mute notifications during the interview."
project_descriptionstring or nullnon-empty

Add project internal name or noteworthy information.

Example: "Formula 1 - US based fans"
redirect_urlstring or null(uri)non-empty^https://.*

HTTPS URL to redirect interviewees after completing the interview

Example: "https://example.com/thank-you"
interview_modesArray of strings or null(InterviewMode)

Interview modes available for interviewees

Default ["talking"]
Enum"typing""talking"
Example: ["typing","talking"]
camera_accessstring

Camera access requirements for the interview

Default "not_allowed"
Enum"not_allowed""optional""required"
Example: "optional"
logo_urlstring or null(uri)[ 1 .. 2083 ] characters

URL to the organization's logo for branding. Recommended: minimum resolution of 160x160px with 1:1 aspect ratio for optimal display.

Default "https://app.genway.ai/assets/images/logoa1.svg"
Example: "https://example.com/logo.png"
primary_colorstring or null^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$

Primary brand color in hex format

Default "#6759DF"
Example: "#FF6B35"
interview_languagesArray of strings or null(SupportedLanguage)

List of languages supported for the interview using ISO 639-1 codes

Default ["en"]
Enum"en""fr""de""es""it""ar""ru""ja""he""el"
Example: ["en","fr","es"]
interview_lengthinteger or null

Duration of the interview in minutes

Default 10
Enum101520
Example: 15
screenersobject or null(Screeners)

Optional screeners configuration shown before starting the interview or survey

Default null
curl -i -X POST \
  https://api.genway.ai/v1/projects \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY_HERE' \
  -H 'X-Tenant-Id: YOUR_API_KEY_HERE' \
  -d '{
    "project_type": "contextual_interview",
    "creation_mode": "explicit",
    "project_name": "The Impact of Formula 1 Excitement on Fan Enthusiasm",
    "project_objective": "The research on '\''The Impact of Formula 1 Excitement on Fan Enthusiasm'\'' is crucial for understanding how the thrill of racing influences spectator engagement and loyalty. Current insights suggest that the suspense and unpredictability of races enhance viewer excitement and attachment to the sport. This study aims to delve deeper into these aspects, providing strategies to boost fan engagement and expand the sport'\''s audience.",
    "research_questions": "Our primary research questions focus on understanding the impact of remote work on employee productivity and well-being. We hope to learn how different remote work policies affect job satisfaction and efficiency across various industries. Additionally, we aim to identify key factors that contribute to a successful remote work environment.",
    "success_criteria": "Success for this project would be clearly evidenced by its direct influence on enhancing our product features, refining our design aesthetics, and strategically informing our marketing campaigns. Ideally, the research findings will provide actionable insights that directly correlate with increased user engagement and satisfaction. Ultimately, the goal is to leverage this research to drive meaningful improvements across all departments, ensuring that every decision is data-informed and aligned with our users'\'' needs.",
    "recruiting_criteria": "For this project, we are targeting interviewees who fall within the 30-50 age range, have a background in engineering or product management, and are currently employed in the tech industry. We are specifically focusing on individuals residing in North America and Europe to capture insights from key tech hubs. This demographic and customer segment approach ensures that we obtain targeted and relevant data for our research objectives.",
    "specific_guidelines": "Ask from the interviewees to mute notifications during the interview.",
    "project_description": "Formula 1 - US based fans",
    "redirect_url": "https://example.com/thank-you",
    "interview_modes": [
      "typing",
      "talking"
    ],
    "camera_access": "optional",
    "logo_url": "https://example.com/logo.png",
    "primary_color": "#FF6B35",
    "interview_languages": [
      "en",
      "fr",
      "es"
    ],
    "interview_length": 15,
    "screeners": null
  }'

Responses

Project created successfully

Bodyapplication/json
project_idstring(uuid)
Example: "123e4567-e89b-12d3-a456-426614174000"
Response
application/json
{
  "project_id": "123e4567-e89b-12d3-a456-426614174000"
}

Get project details

Request

Retrieve the details of a project by its project_id.

Security
api_key and tenant_id
Path
project_idstring(uuid)required

The ID of the project to retrieve

curl -i -X GET \
  'https://api.genway.ai/v1/projects/{project_id}' \
  -H 'X-Api-Key: YOUR_API_KEY_HERE' \
  -H 'X-Tenant-Id: YOUR_API_KEY_HERE'

Responses

Project details retrieved successfully

Bodyapplication/json
One of:
project_idstring(uuid)

Unique identifier for the project

Example: "123e4567-e89b-12d3-a456-426614174000"
project_typestring

Type of project

Value"contextual_interview"
Example: "contextual_interview"
project_namestringnon-empty

The name of the project

Example: "The Impact of Formula 1 Excitement on Fan Enthusiasm"
project_objectivestringnon-empty

The main objective or goal of the project

Example: "The research on 'The Impact of Formula 1 Excitement on Fan Enthusiasm' is crucial for understanding how the thrill of racing influences spectator engagement and loyalty. Current insights suggest that the suspense and unpredictability of races enhance viewer excitement and attachment to the sport. This study aims to delve deeper into these aspects, providing strategies to boost fan engagement and expand the sport's audience."
research_questionsstringnon-empty

Key research questions to be explored

Example: "Our primary research questions focus on understanding the impact of remote work on employee productivity and well-being. We hope to learn how different remote work policies affect job satisfaction and efficiency across various industries. Additionally, we aim to identify key factors that contribute to a successful remote work environment."
success_criteriastringnon-empty

Criteria that define successful completion of the project

Example: "Success for this project would be clearly evidenced by its direct influence on enhancing our product features, refining our design aesthetics, and strategically informing our marketing campaigns. Ideally, the research findings will provide actionable insights that directly correlate with increased user engagement and satisfaction. Ultimately, the goal is to leverage this research to drive meaningful improvements across all departments, ensuring that every decision is data-informed and aligned with our users' needs."
recruiting_criteriastringnon-empty

Criteria for recruiting interview interviewees

Example: "For this project, we are targeting interviewees who fall within the 30-50 age range, have a background in engineering or product management, and are currently employed in the tech industry. We are specifically focusing on individuals residing in North America and Europe to capture insights from key tech hubs. This demographic and customer segment approach ensures that we obtain targeted and relevant data for our research objectives."
specific_guidelinesstring or nullnon-empty

Specific guidelines for conducting interviews

Example: "Ask from the interviewees to mute notifications during the interview."
project_descriptionstring or nullnon-empty

Optional description of the project

Example: "Formula 1 - US based fans"
redirect_urlstring or null(uri)non-empty

URL to redirect users after completing the interview

Example: "https://example.com/thank-you"
interview_modesArray of strings(InterviewMode)

Available interview interaction modes

Items Enum"typing""talking"
camera_accessstring

Camera access requirements for interviews

Enum"not_allowed""optional""required"
Example: "optional"
logo_urlstring or null(uri)[ 1 .. 2083 ] characters

URL for custom logo to display in the interview interface

Example: "https://example.com/logo.png"
primary_colorstring or null^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$

Primary brand color (hex format)

Example: "#FF6B35"
screenersobject or null(ScreenersResponse)

Screeners configuration shown before the starting the interview or survey

interview_languagesArray of strings(SupportedLanguage)

Languages available for interviews

Items Enum"en""fr""de""es""it""ar""ru""ja""he""el"
interview_lengthinteger

Duration of interviews in minutes

Enum101520
Example: 15
Response
application/json
{
  "project_id": "123e4567-e89b-12d3-a456-426614174000",
  "project_type": "contextual_interview",
  "project_name": "The Impact of Formula 1 Excitement on Fan Enthusiasm",
  "project_objective": "The research on 'The Impact of Formula 1 Excitement on Fan Enthusiasm' is crucial for understanding how the thrill of racing influences spectator engagement and loyalty. Current insights suggest that the suspense and unpredictability of races enhance viewer excitement and attachment to the sport. This study aims to delve deeper into these aspects, providing strategies to boost fan engagement and expand the sport's audience.",
  "research_questions": "Our primary research questions focus on understanding the impact of remote work on employee productivity and well-being. We hope to learn how different remote work policies affect job satisfaction and efficiency across various industries. Additionally, we aim to identify key factors that contribute to a successful remote work environment.",
  "success_criteria": "Success for this project would be clearly evidenced by its direct influence on enhancing our product features, refining our design aesthetics, and strategically informing our marketing campaigns. Ideally, the research findings will provide actionable insights that directly correlate with increased user engagement and satisfaction. Ultimately, the goal is to leverage this research to drive meaningful improvements across all departments, ensuring that every decision is data-informed and aligned with our users' needs.",
  "recruiting_criteria": "For this project, we are targeting interviewees who fall within the 30-50 age range, have a background in engineering or product management, and are currently employed in the tech industry. We are specifically focusing on individuals residing in North America and Europe to capture insights from key tech hubs. This demographic and customer segment approach ensures that we obtain targeted and relevant data for our research objectives.",
  "specific_guidelines": "Ask from the interviewees to mute notifications during the interview.",
  "project_description": "Formula 1 - US based fans",
  "redirect_url": "https://example.com/thank-you",
  "interview_modes": [
    "typing"
  ],
  "camera_access": "optional",
  "logo_url": "https://example.com/logo.png",
  "primary_color": "#FF6B35",
  "screeners": {
    "screener_blocks": [ … ],
    "screen_out_url": "https://example.com/not-qualified"
  },
  "interview_languages": [
    "en"
  ],
  "interview_length": 15
}

Update project details

Request

Update the details of a project by its projectId.

Note: When updating array fields, the entire array is replaced with your new values - existing items are not merged. This endpoint follows RFC 7386 JSON Merge Patch behavior.

Security
api_key and tenant_id
Path
project_idstring(uuid)required

The ID of the project to update

Bodyapplication/jsonrequired
One of:
project_namestringnon-empty
Example: "The Impact of Formula 1 Excitement on Fan Enthusiasm"
project_descriptionstring or null

Add project internal name or noteworthy information.

Example: "Forumla 1 - US based fans"
project_objectivestringnon-empty
Example: "The research on 'The Impact of Formula 1 Excitement on Fan Enthusiasm' is crucial for understanding how the thrill of racing influences spectator engagement and loyalty. Current insights suggest that the suspense and unpredictability of races enhance viewer excitement and attachment to the sport. This study aims to delve deeper into these aspects, providing strategies to boost fan engagement and expand the sport's audience."
research_questionsstringnon-empty
Example: "Our primary research questions focus on understanding the impact of remote work on employee productivity and well-being. We hope to learn how different remote work policies affect job satisfaction and efficiency across various industries. Additionally, we aim to identify key factors that contribute to a successful remote work environment."
success_criteriastringnon-empty
Example: "Success for this project would be clearly evidenced by its direct influence on enhancing our product features, refining our design aesthetics, and strategically informing our marketing campaigns. Ideally, the research findings will provide actionable insights that directly correlate with increased user engagement and satisfaction. Ultimately, the goal is to leverage this research to drive meaningful improvements across all departments, ensuring that every decision is data-informed and aligned with our users' needs."
recruiting_criteriastringnon-empty
Example: "For this project, we are targeting interviewees who fall within the 30-50 age range, have a background in engineering or product management, and are currently employed in the tech industry. We are specifically focusing on individuals residing in North America and Europe to capture insights from key tech hubs. This demographic and customer segment approach ensures that we obtain targeted and relevant data for our research objectives."
specific_guidelinesstring or null
Example: "Ask from the interviewees to mute notifications during the interview."
redirect_urlstring or null(uri)^https://.*

HTTPS URL to redirect interviewees after completing the interview

Example: "https://example.com/thank-you"
interview_modesArray of strings(InterviewMode)non-empty

Interview modes available for interviewees. Note: The entire array is replaced with new values.

Items Enum"typing""talking"
Example: ["typing","talking"]
camera_accessstring

Camera access requirements for the interview

Enum"not_allowed""optional""required"
Example: "optional"
logo_urlstring or null(uri)<= 2083 characters

URL to the organization's logo for branding. Recommended: minimum resolution of 160x160px with 1:1 aspect ratio for optimal display.

Example: "https://example.com/logo.png"
primary_colorstring^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$

Primary brand color in hex format

Example: "#FF6B35"
interview_languagesArray of strings or null(SupportedLanguage)

List of languages supported for the interview using ISO 639-1 codes. Note: The entire array is replaced with new values.

Enum"en""fr""de""es""it""ar""ru""ja""he""el"
Example: ["en","fr","es"]
interview_lengthinteger or null

Duration of the interview in minutes

Enum101520
Example: 15
screenersobject or null(ScreenersPatch)

Screeners configuration patch for updating interview or survey

Default null
curl -i -X PATCH \
  'https://api.genway.ai/v1/projects/{project_id}' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY_HERE' \
  -H 'X-Tenant-Id: YOUR_API_KEY_HERE' \
  -d '{
    "project_name": "The Impact of Formula 1 Excitement on Fan Enthusiasm",
    "project_description": "Forumla 1 - US based fans",
    "project_objective": "The research on '\''The Impact of Formula 1 Excitement on Fan Enthusiasm'\'' is crucial for understanding how the thrill of racing influences spectator engagement and loyalty. Current insights suggest that the suspense and unpredictability of races enhance viewer excitement and attachment to the sport. This study aims to delve deeper into these aspects, providing strategies to boost fan engagement and expand the sport'\''s audience.",
    "research_questions": "Our primary research questions focus on understanding the impact of remote work on employee productivity and well-being. We hope to learn how different remote work policies affect job satisfaction and efficiency across various industries. Additionally, we aim to identify key factors that contribute to a successful remote work environment.",
    "success_criteria": "Success for this project would be clearly evidenced by its direct influence on enhancing our product features, refining our design aesthetics, and strategically informing our marketing campaigns. Ideally, the research findings will provide actionable insights that directly correlate with increased user engagement and satisfaction. Ultimately, the goal is to leverage this research to drive meaningful improvements across all departments, ensuring that every decision is data-informed and aligned with our users'\'' needs.",
    "recruiting_criteria": "For this project, we are targeting interviewees who fall within the 30-50 age range, have a background in engineering or product management, and are currently employed in the tech industry. We are specifically focusing on individuals residing in North America and Europe to capture insights from key tech hubs. This demographic and customer segment approach ensures that we obtain targeted and relevant data for our research objectives.",
    "specific_guidelines": "Ask from the interviewees to mute notifications during the interview.",
    "redirect_url": "https://example.com/thank-you",
    "interview_modes": [
      "typing",
      "talking"
    ],
    "camera_access": "optional",
    "logo_url": "https://example.com/logo.png",
    "primary_color": "#FF6B35",
    "interview_languages": [
      "en",
      "fr",
      "es"
    ],
    "interview_length": 15,
    "screeners": null
  }'

Responses

Project details updated successfully

Bodyapplication/json
project_idstring(uuid)
Example: "123e4567-e89b-12d3-a456-426614174000"
Response
application/json
{
  "project_id": "123e4567-e89b-12d3-a456-426614174000"
}

Publish/resume a project

Request

Publish or resume a project

Security
api_key and tenant_id
Path
project_idstring(uuid)required

The ID of the project to activate

curl -i -X POST \
  'https://api.genway.ai/v1/projects/{project_id}/activate' \
  -H 'X-Api-Key: YOUR_API_KEY_HERE' \
  -H 'X-Tenant-Id: YOUR_API_KEY_HERE'

Responses

Project activated successfully

Response
No content

Pause a project

Request

Pause an active project, making it inactive. This is useful for temporarily halting a project.

Security
api_key and tenant_id
Path
project_idstring(uuid)required

The ID of the project to deactivate

curl -i -X POST \
  'https://api.genway.ai/v1/projects/{project_id}/deactivate' \
  -H 'X-Api-Key: YOUR_API_KEY_HERE' \
  -H 'X-Tenant-Id: YOUR_API_KEY_HERE'

Responses

Project deactivated successfully

Response
No content

Export all interviews transcripts and summaries

Request

Export all interviews transcripts and summaries for a specific project.

Security
api_key and tenant_id
Path
project_idstring(uuid)required

The ID of the project

curl -i -X GET \
  'https://api.genway.ai/v1/projects/{project_id}/interviews-export' \
  -H 'X-Api-Key: YOUR_API_KEY_HERE' \
  -H 'X-Tenant-Id: YOUR_API_KEY_HERE'

Responses

Export successful

Bodytext/csv
string(binary)

CSV file containing interview data with the following columns:

  • interview_id: The unique identifier for the interview.
  • identifier: The identifier for the interviewee, which can be an email, user_id, or external_user_id.
  • country_code: The country code of the interviewee.
  • interview_status: The status of the interview session, based on completion level. Logic varies by project type:
    • AI Moderated Interviews / Usability:
      • INITIATED: Fewer than 4 responses
      • PARTIAL: 4+ responses, but interview not fully completed
      • COMPLETED: Full interview completed
    • AI Moderated Surveys:
      • INITIATED: Less than 1/3 of survey blocks answered
      • PARTIAL: At least 1/3 of blocks completed, but not the full interview
      • COMPLETED: Full interview completed
  • opt_in_for_followup: Indicates whether the interviewee has opted in for follow-up.
  • created_at: The timestamp when the interview session itself started.
  • ended_at: The timestamp when the interview was completed. If this field is missing, the interview was not completed.
  • project_type: The research project type (INTERVIEW, SURVEY, or USABILITY).
  • device_type: The type of device used by the interviewee (MOBILE or DESKTOP).
  • external_metadata: External metadata associated with the interviewee (JSON format).
  • transcription: Transcription of the interview.
  • interview_summary: Summary of the interview.
Response
No content

Export all interviewees' information

Request

Export all interviewees' information for a specific project as a CSV file.

Security
api_key and tenant_id
Path
project_idstring(uuid)required

The ID of the project

curl -i -X GET \
  'https://api.genway.ai/v1/projects/{project_id}/interviewees-export' \
  -H 'X-Api-Key: YOUR_API_KEY_HERE' \
  -H 'X-Tenant-Id: YOUR_API_KEY_HERE'

Responses

Export successful

Bodytext/csv
string(binary)

CSV file containing interviewee data with the following columns:

  • interview_id: The unique identifier for the interview.
  • identifier: The identifier for the interviewee, which can be an email, user_id, or external_user_id.
  • country_code: The country code of the interviewee.
  • interview_status: The status of the interview session, based on completion level. Logic varies by project type:
    • AI Moderated Interviews / Usability:
      • INITIATED: Fewer than 4 responses
      • PARTIAL: 4+ responses, but interview not fully completed
      • COMPLETED: Full interview completed
    • AI Moderated Surveys:
      • INITIATED: Less than 1/3 of survey blocks answered
      • PARTIAL: At least 1/3 of blocks completed, but not the full interview
      • COMPLETED: Full interview completed
  • opt_in_for_followup: Indicates whether the interviewee has opted in for follow-up.
  • created_at: The timestamp when the interview session itself started.
  • ended_at: The timestamp when the interview was completed. If this field is missing, the interview was not completed.
  • project_type: The research project type (INTERVIEW, SURVEY, or USABILITY).
  • device_type: The type of device used by the interviewee (MOBILE or DESKTOP).
  • external_metadata: External metadata associated with the interviewee (JSON format).
Response
No content

Get project URL for sharing with interviewees

Request

Get the URL for a project to share with interviewees. Accepts a parameter to specify sandbox or production URL.

Security
api_key and tenant_id
Path
project_idstring(uuid)required

The ID of the project

Query
environmentstringrequired

Specify whether the URL should be for a sandbox or production interview

Enum"sandbox""production"
curl -i -X GET \
  'https://api.genway.ai/v1/projects/{project_id}/url?environment=sandbox' \
  -H 'X-Api-Key: YOUR_API_KEY_HERE' \
  -H 'X-Tenant-Id: YOUR_API_KEY_HERE'

Responses

URL retrieved successfully

Bodyapplication/json
project_idstring(uuid)
Example: "123e4567-e89b-12d3-a456-426614174000"
urlstring(uri)
Example: "https://app.genway.ai/meet/123e4567-e89b-12d3-a456-426614174000"
Response
application/json
{
  "project_id": "123e4567-e89b-12d3-a456-426614174000",
  "url": "https://app.genway.ai/meet/123e4567-e89b-12d3-a456-426614174000"
}

Interviews

Manage and export interview data.

Operations

Files

Upload and manage files for use in projects.

Operations

Webhooks

Webhooks deliver event data to your applications as it happens, offering an alternative to frequent data polling.

  • The secret created via the /webhooks/secrets endpoint is permanent and should be stored securely in your system. This secret will serve for the verifying section.
  • The x-hook-secret is temporary and should be used only once during the confirmation process.
  • Until the webhook is confirmed, no events will be sent to the subscriber's endpoint.
Operations

Errors

The Genway API uses standard HTTP response codes to indicate the success or failure of the request. Codes follow this pattern:

  • 2xx codes indicate success.
  • 4xx codes indicate a request that failed given the information provided (e.g., a required parameter was omitted).
  • 5xx codes indicate an error with Genway's platform.