Speechmind API Documentation

Welcome to the SpeechMind GraphQL API.

This reference document provides detailed information about the endpoints and features of the SpeechMind API. It covers the available queries, mutations, types, and input objects, along with usage examples and expected input/output formats.

The main focus of the initial API version are three main processes explained in the next chapters.

Authentication is required to access most API features. Clients must first obtain a JSON Web Token (JWT) through the authentication endpoint and include it in the Authorization header of all subsequent requests:

Contact

hello@speechmind.com

www.speechmind.com

API Endpoints

https://api-v2.speechmind.com/external/v1/graphql

Headers

# // Your API key
x-api-key: <your-api-key>

Version

1.0.0

Authentication Guide for using the API

To access the SpeechMind API, you need to authenticate using an API key. Follow the steps below to generate and use your API key:

🔑 Steps to Generate Your API Key

Log in to your SpeechMind account.
Navigate to Account > Organisation you find a Developers API section.
Click on Generate New API Key.
Copy the generated key and store it securely.

🚀 Using the API Key

Include your API key in the request headers under the x-api-key field when making API calls.

Example Request Header

x-api-key: <your-api-key>

Queries

`checkAnalysisResults`

Response

Returns a CheckAnalysisResultsReturn

Arguments

Name	Description
`protocolSlug` - `String!`	ID of the protocol

Example

Query

query checkAnalysisResults($protocolSlug: String!) {
  checkAnalysisResults(protocolSlug: $protocolSlug) {
    currentDepth
    classType
  }
}

Variables

{"protocolSlug": "xyz789"}

Response

{
  "data": {
    "checkAnalysisResults": {
      "currentDepth": 987,
      "classType": "xyz789"
    }
  }
}

Queries

`getAgendaItemAndUpdateDepthById`

Description

It validates the user's authentication using an API key passed in the request header and returns the agenda item associated with the specified ID and updates its depth if provided.

Response

Returns an ApiAgendaItemType

Arguments

Name	Description
`agendaItemId` - `String!`	ID of the agenda item
`depth` - `Int`	Depth of the agenda item

Example

Query

query getAgendaItemAndUpdateDepthById(
  $agendaItemId: String!,
  $depth: Int
) {
  getAgendaItemAndUpdateDepthById(
    agendaItemId: $agendaItemId,
    depth: $depth
  ) {
    id
    classType
    title
    depth
    maxDepth
    metaData
    textList
    resolutionList {
      ...ResolutionInputFragment
    }
    createdAt
    updatedAt
  }
}

Variables

{"agendaItemId": "abc123", "depth": 123}

Response

{
  "data": {
    "getAgendaItemAndUpdateDepthById": {
      "id": "abc123",
      "classType": "xyz789",
      "title": "abc123",
      "depth": 123,
      "maxDepth": 987,
      "metaData": "abc123",
      "textList": "abc123",
      "resolutionList": [ResolutionInput],
      "createdAt": "2007-12-03T10:15:30Z",
      "updatedAt": "2007-12-03T10:15:30Z"
    }
  }
}

Queries

`getAllProjects`

Description

It returns all projects for a user.

Response

Returns [ApiProjectType]

Example

Query

query getAllProjects {
  getAllProjects {
    slug
    name
  }
}

Response

{
  "data": {
    "getAllProjects": [
      {
        "slug": "xyz789",
        "name": "xyz789"
      }
    ]
  }
}

Queries

`getPresignedAwsUrl`

Description

It validates the user's authentication using an API key passed in the request header and returns a presigned URL for uploading files to AWS S3.

Response

Returns an AWSUrlObject

Arguments

Name	Description
`uniqueObjName` - `String!`	Unique name of the object

Example

Query

query getPresignedAwsUrl($uniqueObjName: String!) {
  getPresignedAwsUrl(uniqueObjName: $uniqueObjName) {
    url
    fields
  }
}

Variables

{"uniqueObjName": "abc123"}

Response

{
  "data": {
    "getPresignedAwsUrl": {
      "url": "xyz789",
      "fields": GenericScalar
    }
  }
}

Queries

`getProtocolBySlug`

Description

It validates the user's authentication using an API key passed in the request header and returns the protocol associated with the specified slug.

Response

Returns an EditSpeakerDataType

Arguments

Name	Description
`protocolSlug` - `String!`	ID of the protocol

Example

Query

query getProtocolBySlug($protocolSlug: String!) {
  getProtocolBySlug(protocolSlug: $protocolSlug) {
    protocol {
      ...ApiProtocolTypeFragment
    }
    speakerList
    summaryPerSpeakerList {
      ...ApiSummaryPerSpeakerItemTypeFragment
    }
  }
}

Variables

{"protocolSlug": "xyz789"}

Response

{
  "data": {
    "getProtocolBySlug": {
      "protocol": ApiProtocolType,
      "speakerList": GenericScalar,
      "summaryPerSpeakerList": [
        ApiSummaryPerSpeakerItemType
      ]
    }
  }
}

Queries

`getProtocolsByProjectSlug`

Description

It returns all the documents from a project.

Response

Returns [ApiProtocolType]

Arguments

Name	Description
`slug` - `String!`	Slug of the project

Example

Query

query getProtocolsByProjectSlug($slug: String!) {
  getProtocolsByProjectSlug(slug: $slug) {
    slug
    name
    date
    status
    editStage
    bucketAws
  }
}

Variables

{"slug": "xyz789"}

Response

{
  "data": {
    "getProtocolsByProjectSlug": [
      {
        "slug": "abc123",
        "name": "abc123",
        "date": "xyz789",
        "status": true,
        "editStage": false,
        "bucketAws": "abc123"
      }
    ]
  }
}

Queries

`getResultItemsByProtocol`

Description

It validates the user's authentication using an API key passed in the request header and returns the result items associated with the specified protocol slug.

Response

Returns an AgendaItemListType

Arguments

Name	Description
`protocolSlug` - `String!`	ID of the protocol

Example

Query

query getResultItemsByProtocol($protocolSlug: String!) {
  getResultItemsByProtocol(protocolSlug: $protocolSlug) {
    agendaItemList {
      ...ApiAgendaItemTypeFragment
    }
    taskList {
      ...ApiTaskTypeFragment
    }
  }
}

Variables

{"protocolSlug": "xyz789"}

Response

{
  "data": {
    "getResultItemsByProtocol": {
      "agendaItemList": [ApiAgendaItemType],
      "taskList": [ApiTaskType]
    }
  }
}

Queries

`getTextsegmentsByProtocolAndPage`

Description

It validates the user's authentication using an API key passed in the request header and returns the text segments associated with the specified protocol slug and page number.

Response

Returns a TextsegmentListType

Arguments

Name	Description
`protocolSlug` - `String!`	ID of the protocol
`page` - `String!`	Page number

Example

Query

query getTextsegmentsByProtocolAndPage(
  $protocolSlug: String!,
  $page: String!
) {
  getTextsegmentsByProtocolAndPage(
    protocolSlug: $protocolSlug,
    page: $page
  ) {
    textsegmentList {
      ...ApiTextsegmentTypeFragment
    }
  }
}

Variables

{
  "protocolSlug": "abc123",
  "page": "abc123"
}

Response

{
  "data": {
    "getTextsegmentsByProtocolAndPage": {
      "textsegmentList": [ApiTextsegmentType]
    }
  }
}

Queries

`getTranscriptByStartEndId`

Description

It validates the user's authentication using an API key passed in the request header and returns the text segments between the specified start and end IDs.

Response

Returns [ApiTextsegmentTypeWithSpeaker]

Arguments

Name	Description
`startId` - `String!`	ID of the start text segment
`endId` - `String`	ID of the end text segment

Example

Query

query getTranscriptByStartEndId(
  $startId: String!,
  $endId: String
) {
  getTranscriptByStartEndId(
    startId: $startId,
    endId: $endId
  ) {
    id
    speakerObj {
      ...ApiSpeakerTypeFragment
    }
    textJson {
      ...TranscriptSegmentFragment
    }
    pos
  }
}

Variables

{
  "startId": "xyz789",
  "endId": "abc123"
}

Response

{
  "data": {
    "getTranscriptByStartEndId": [
      {
        "id": "xyz789",
        "speakerObj": ApiSpeakerType,
        "textJson": [TranscriptSegment],
        "pos": 987
      }
    ]
  }
}

Mutations

`createAnalysis`

Description

Create a new analysis for a given protocol. It validates the user's authentication using an API key passed in the request header and processes the provided protocol slug.

Response

Returns a CreateAnalysisMutation

Arguments

Name	Description
`protocolSlug` - `String!`	Name of the protocol

Example

Query

mutation createAnalysis($protocolSlug: String!) {
  createAnalysis(protocolSlug: $protocolSlug) {
    success
  }
}

Variables

{"protocolSlug": "abc123"}

Response

{"data": {"createAnalysis": {"success": false}}}

Mutations

`createProject`

Description

Create a new project. User can upload files into a project. Pass the resulting slug into the import audio mutation.

Response

Returns a CreateProjectMutation

Arguments

Name	Description
`name` - `String!`	Name of the project

Example

Query

mutation createProject($name: String!) {
  createProject(name: $name) {
    project {
      ...ApiProjectTypeFragment
    }
  }
}

Variables

{"name": "xyz789"}

Response

{"data": {"createProject": {"project": ApiProjectType}}}

Mutations

`deleteAudioByProtocolSlug`

Response

Returns a DeleteAudioByProtocolSlugMutation

Arguments

Name	Description
`protocolSlug` - `String!`

Example

Query

mutation deleteAudioByProtocolSlug($protocolSlug: String!) {
  deleteAudioByProtocolSlug(protocolSlug: $protocolSlug) {
    success
    protocol {
      ...ApiProtocolTypeFragment
    }
  }
}

Variables

{"protocolSlug": "xyz789"}

Response

{
  "data": {
    "deleteAudioByProtocolSlug": {
      "success": true,
      "protocol": ApiProtocolType
    }
  }
}

Mutations

`deleteProtocol`

Response

Returns a DeleteProtocolMutation

Arguments

Name	Description
`protocolSlug` - `String!`

Example

Query

mutation deleteProtocol($protocolSlug: String!) {
  deleteProtocol(protocolSlug: $protocolSlug) {
    success
  }
}

Variables

{"protocolSlug": "abc123"}

Response

{"data": {"deleteProtocol": {"success": true}}}

Mutations

`extendAgendaItem`

Description

Extend an agenda item by its ID by user input. It validates the user's authentication using an API key passed in the request header and extends the content of the agenda item in case it's too short.

Response

Returns an ExtendAgendaItemByIdMutation

Arguments

Name	Description
`agendaItemId` - `String!`	Agenda item to be extended by user prompt
`userInput` - `String`	Prompt by the user to extend the agenda item

Example

Query

mutation extendAgendaItem(
  $agendaItemId: String!,
  $userInput: String
) {
  extendAgendaItem(
    agendaItemId: $agendaItemId,
    userInput: $userInput
  ) {
    summarySuggestions {
      ...ApiAgendaItemSummaryFragment
    }
  }
}

Variables

{
  "agendaItemId": "xyz789",
  "userInput": "abc123"
}

Response

{
  "data": {
    "extendAgendaItem": {
      "summarySuggestions": ApiAgendaItemSummary
    }
  }
}

Mutations

`importAudio`

Description

Mutation to upload and register an audio file for processing. This mutation allows users to upload an audio file and register it for further processing. It validates the user's authentication using an API key passed in the request header and processes the provided audio metadata.

Response

Returns an ImportAudioMutation

Arguments

Name	Description
`date` - `Date!`	Date of the audio file
`duration` - `String!`	Duration of the audio file
`language` - `String!`	Language of the audio file
`name` - `String!`	Name of the audio file
`projectSlug` - `String!`	Slug of the project
`topList` - `String`	Agenda list of the audio file
`typeOfDocument` - `String!`	Type of the document
`uniqueObjName` - `String!`	Unique Name of the audio file

Example

Query

mutation importAudio(
  $date: Date!,
  $duration: String!,
  $language: String!,
  $name: String!,
  $projectSlug: String!,
  $topList: String,
  $typeOfDocument: String!,
  $uniqueObjName: String!
) {
  importAudio(
    date: $date,
    duration: $duration,
    language: $language,
    name: $name,
    projectSlug: $projectSlug,
    topList: $topList,
    typeOfDocument: $typeOfDocument,
    uniqueObjName: $uniqueObjName
  ) {
    protocol {
      ...ApiProtocolTypeFragment
    }
    success
  }
}

Variables

{
  "date": "2007-12-03",
  "duration": "xyz789",
  "language": "xyz789",
  "name": "xyz789",
  "projectSlug": "xyz789",
  "topList": "xyz789",
  "typeOfDocument": "xyz789",
  "uniqueObjName": "xyz789"
}

Response

{
  "data": {
    "importAudio": {
      "protocol": ApiProtocolType,
      "success": false
    }
  }
}

Mutations

`recreateProtocolAfterSpeakerChange`

Response

Returns a RecreateProtocolMutation

Arguments

Name	Description
`protocolSlug` - `String!`	Name of the protocol to be recreated

Example

Query

mutation recreateProtocolAfterSpeakerChange($protocolSlug: String!) {
  recreateProtocolAfterSpeakerChange(protocolSlug: $protocolSlug) {
    success
  }
}

Variables

{"protocolSlug": "abc123"}

Response

{"data": {"recreateProtocolAfterSpeakerChange": {"success": false}}}

Mutations

`renameSpeakerInTextsegment`

Description

Rename speaker in text segments for a given protocol. It validates the user's authentication using an API key passed in the request header and processes the provided protocol slug and speaker information.

Response

Returns a RenameSpeakerInTextSegmentMutation

Arguments

Name	Description
`protocolSlug` - `String!`	Name of the protocol
`speakerJson` - `[SpeakerInput]!`	List of speakers to rename

Example

Query

mutation renameSpeakerInTextsegment(
  $protocolSlug: String!,
  $speakerJson: [SpeakerInput]!
) {
  renameSpeakerInTextsegment(
    protocolSlug: $protocolSlug,
    speakerJson: $speakerJson
  ) {
    textsegmentsForRename {
      ...ApiTextsegmentTypeFragment
    }
    success
  }
}

Variables

{
  "protocolSlug": "xyz789",
  "speakerJson": [SpeakerInput]
}

Response

{
  "data": {
    "renameSpeakerInTextsegment": {
      "textsegmentsForRename": [ApiTextsegmentType],
      "success": true
    }
  }
}

Mutations

`rephraseAgendaItem`

Description

Rephrase an agenda item by its ID by user input. It validates the user's authentication using an API key passed in the request header and rephrases the content of the agenda item.

Response

Returns a RephraseAgendaItemByIdMutation

Arguments

Name	Description
`agendaItemId` - `String!`	Agenda item to be extended by user prompt
`userInput` - `String!`	Prompt by the user to extend the agenda item

Example

Query

mutation rephraseAgendaItem(
  $agendaItemId: String!,
  $userInput: String!
) {
  rephraseAgendaItem(
    agendaItemId: $agendaItemId,
    userInput: $userInput
  ) {
    summarySuggestions {
      ...ApiAgendaItemSummaryFragment
    }
  }
}

Variables

{
  "agendaItemId": "abc123",
  "userInput": "abc123"
}

Response

{
  "data": {
    "rephraseAgendaItem": {
      "summarySuggestions": ApiAgendaItemSummary
    }
  }
}

Mutations

`shortenAgendaItem`

Description

Shortens an agenda item by its ID by user input. It validates the user's authentication using an API key passed in the request header and shortens the content of the agenda item in case it's too long.

Response

Returns a ShortenAgendaItemByIdMutation

Arguments

Name	Description
`agendaItemId` - `String!`	Agenda item to be extended by user prompt
`userInput` - `String`	Prompt by the user to extend the agenda item

Example

Query

mutation shortenAgendaItem(
  $agendaItemId: String!,
  $userInput: String
) {
  shortenAgendaItem(
    agendaItemId: $agendaItemId,
    userInput: $userInput
  ) {
    summarySuggestions {
      ...ApiAgendaItemSummaryFragment
    }
  }
}

Variables

{
  "agendaItemId": "abc123",
  "userInput": "xyz789"
}

Response

{
  "data": {
    "shortenAgendaItem": {
      "summarySuggestions": ApiAgendaItemSummary
    }
  }
}

Mutations

`updateAgendaItemById`

Description

Update a specific agenda item by its ID. It validates the user's authentication using an API key passed in the request header and processes the provided agenda item data.

Response

Returns an UpdateAgendaItemByIdMutation

Arguments

Name	Description
`agendaItem` - `String!`	Agenda item to be updated

Example

Query

mutation updateAgendaItemById($agendaItem: String!) {
  updateAgendaItemById(agendaItem: $agendaItem) {
    agendaItem {
      ...ApiAgendaItemTypeFragment
    }
  }
}

Variables

{"agendaItem": "xyz789"}

Response

{
  "data": {
    "updateAgendaItemById": {
      "agendaItem": ApiAgendaItemType
    }
  }
}

Mutations

`updateAgendaItems`

Description

Update agenda items for a given protocol. It validates the user's authentication using an API key passed in the request header and processes the provided agenda items and protocol slug.

Response

Returns an UpdateAgendaItemsMutation

Arguments

Name	Description
`agendaItems` - `String!`	Agenda items to be updated
`protocolSlug` - `String!`	Name of the protocol

Example

Query

mutation updateAgendaItems(
  $agendaItems: String!,
  $protocolSlug: String!
) {
  updateAgendaItems(
    agendaItems: $agendaItems,
    protocolSlug: $protocolSlug
  ) {
    agendaItems {
      ...ApiAgendaItemTypeFragment
    }
  }
}

Variables

{
  "agendaItems": "abc123",
  "protocolSlug": "abc123"
}

Response

{
  "data": {
    "updateAgendaItems": {
      "agendaItems": [ApiAgendaItemType]
    }
  }
}

Types

AWSUrlObject

Fields

Field Name	Description
`url` - `String`	AWS Url bucket name
`fields` - `GenericScalar`	{ "Content-Type": "multipart/form-data", "key": "test-audio.ogg", "x-amz-algorithm": "AWS4-HMAC-SHA256", "x-amz-credential": "", "x-amz-date": "20250512T105036Z", "policy": "", "x-amz-signature": "" }

Example

{
  "url": "abc123",
  "fields": GenericScalar
}

Types

AgendaItemListType

Fields

Field Name	Description
`agendaItemList` - `[ApiAgendaItemType]`	List of agenda items
`taskList` - `[ApiTaskType]`	List of tasks

Example

{
  "agendaItemList": [ApiAgendaItemType],
  "taskList": [ApiTaskType]
}

Types

ApiAgendaItemSummary

Fields

Field Name	Description
`suggestions` - `[String]`	List of agenda item suggestions

Example

{"suggestions": ["xyz789"]}

Types

ApiAgendaItemType

Fields

Field Name	Description
`id` - `String`	ID of the agenda item
`classType` - `String`	Class type of the agenda item
`title` - `String`	Title of the agenda item
`depth` - `Int`	Depth of the textlist
`maxDepth` - `Int`	Maximal depth of the textlist
`metaData` - `String`	Meta data of the agenda item
`textList` - `String`	{ "0": ["Die Software funktioniert gut."], "1": ["Bitte fügen Sie eine Chat-Funktion hinzu."], "2": ["Das Login über Google sollte schneller sein."] ... }
`resolutionList` - `[ResolutionInput]`	List of resolutions
`createdAt` - `DateTime`	Creation date of the agenda item
`updatedAt` - `DateTime`	Last update date of the agenda item

Example

{
  "id": "abc123",
  "classType": "abc123",
  "title": "xyz789",
  "depth": 987,
  "maxDepth": 123,
  "metaData": "abc123",
  "textList": "xyz789",
  "resolutionList": [ResolutionInput],
  "createdAt": "2007-12-03T10:15:30Z",
  "updatedAt": "2007-12-03T10:15:30Z"
}

Types

ApiProjectType

Fields

Field Name	Description
`slug` - `String`	Slug of the project
`name` - `String`	Name of the project

Example

{
  "slug": "xyz789",
  "name": "xyz789"
}

Types

ApiProtocolType

Fields

Field Name	Description
`slug` - `String`	ID of the protocol
`name` - `String`	Name of the protocol
`date` - `String`	Date of the protocol
`status` - `Boolean`	Status of the protocol, status can be True or False
`editStage` - `Boolean`	Edit stage of the protocol, edit_stage can be True or False
`bucketAws` - `String`	AWS bucket name, Example Object: {'bucket': 'bucket_name', 'key': 'key_name', 'video.mp3': 'video_name.ogg'}

Example

{
  "slug": "xyz789",
  "name": "abc123",
  "date": "abc123",
  "status": true,
  "editStage": false,
  "bucketAws": "abc123"
}

Types

ApiSpeakerType

Fields

Field Name	Description
`slug` - `String`	Slug of the speaker
`gender` - `String`	Gender of the speaker
`givenName` - `String`	Given name of the speaker
`familyName` - `String`	Family name of the speaker
`party` - `String`	Partei Firma of the speaker
`preTitle` - `String`	Pre Titel of the speaker
`posShort` - `String`	Pos Short of the speaker
`posLong` - `String`	Pos Long of the speaker
`postTitle` - `String`	Post Titel of the speaker
`specialCase` - `Boolean`	Special Case of the speaker

Example

{
  "slug": "xyz789",
  "gender": "xyz789",
  "givenName": "xyz789",
  "familyName": "xyz789",
  "party": "xyz789",
  "preTitle": "abc123",
  "posShort": "xyz789",
  "posLong": "xyz789",
  "postTitle": "xyz789",
  "specialCase": false
}

Types

ApiSummaryPerSpeakerItemType

Fields

Field Name	Description
`speaker` - `String`	Name of the speaker
`textList` - `String`	{ "0": ["Die Software funktioniert gut."], "1": ["Bitte fügen Sie eine Chat-Funktion hinzu."], "2": ["Das Login über Google sollte schneller sein."] ... }
`speakerSuggestion` - `String`	Speaker suggestion
`createdAt` - `DateTime`	Creation date of the summary
`updatedAt` - `DateTime`	Last update date of the summary

Example

{
  "speaker": "abc123",
  "textList": "xyz789",
  "speakerSuggestion": "xyz789",
  "createdAt": "2007-12-03T10:15:30Z",
  "updatedAt": "2007-12-03T10:15:30Z"
}

Types

ApiTaskType

Fields

Field Name	Description
`id` - `String`	ID of the task
`text` - `String`	Text of the task
`date` - `String`	Date of the task
`assignedTo` - `String`	Assigned person for the task
`done` - `Boolean`	Task completion status
`createdAt` - `DateTime`	Creation date of the task
`updatedAt` - `DateTime`	Last update date of the task

Example

{
  "id": "abc123",
  "text": "abc123",
  "date": "abc123",
  "assignedTo": "xyz789",
  "done": false,
  "createdAt": "2007-12-03T10:15:30Z",
  "updatedAt": "2007-12-03T10:15:30Z"
}

Types

ApiTextsegmentType

Fields

Field Name	Description
`id` - `String`	ID of the TextSegment
`speaker` - `String`	Name of the speaker
`textJson` - `[TranscriptSegment]`	List of transcript segments
`pos` - `Int`	Position of the text segment

Example

{
  "id": "abc123",
  "speaker": "abc123",
  "textJson": [TranscriptSegment],
  "pos": 987
}

Types

ApiTextsegmentTypeWithSpeaker

Fields

Field Name	Description
`id` - `String`	ID of the TextSegment
`speakerObj` - `ApiSpeakerType`	Object of the speaker
`textJson` - `[TranscriptSegment]`	List of transcript segments
`pos` - `Int`	Position of the text segment

Example

{
  "id": "abc123",
  "speakerObj": ApiSpeakerType,
  "textJson": [TranscriptSegment],
  "pos": 987
}

Types

Boolean

Description

The Boolean scalar type represents true or false.

Example

true

Types

CheckAnalysisResultsReturn

Fields

Field Name	Description
`currentDepth` - `Int`
`classType` - `String`

Example

{"currentDepth": 123, "classType": "xyz789"}

Types

CreateAnalysisMutation

Description

Create a new analysis for a given protocol. It validates the user's authentication using an API key passed in the request header and processes the provided protocol slug.

Fields

Field Name	Description
`success` - `Boolean`

Example

{"success": false}

Types

CreateProjectMutation

Description

Create a new project. User can upload files into a project. Pass the resulting slug into the import audio mutation.

Fields

Field Name	Description
`project` - `ApiProjectType`

Example

{"project": ApiProjectType}

Types

Date

Description

The Date scalar type represents a Date value as specified by iso8601.

Example

"2007-12-03"

Types

DateTime

Description

The DateTime scalar type represents a DateTime value as specified by iso8601.

Example

"2007-12-03T10:15:30Z"

Types

DeleteAudioByProtocolSlugMutation

Fields

Field Name	Description
`success` - `Boolean`
`protocol` - `ApiProtocolType`

Example

{"success": false, "protocol": ApiProtocolType}

Types

DeleteProtocolMutation

Fields

Field Name	Description
`success` - `Boolean`

Example

{"success": false}

Types

EditSpeakerDataType

Fields

Field Name	Description
`protocol` - `ApiProtocolType`	Protocol object
`speakerList` - `GenericScalar`	{ "Rafiq": { "duration": 77.32, "textsegment": [ { "id": 8, "textsegment_duration": 5.8, "text": "Hello world.", "time": { "start_time": 12.97, "end_time": 14.48 } } ] } }
`summaryPerSpeakerList` - `[ApiSummaryPerSpeakerItemType]`	List of summaries per speaker

Example

{
  "protocol": ApiProtocolType,
  "speakerList": GenericScalar,
  "summaryPerSpeakerList": [ApiSummaryPerSpeakerItemType]
}

Types

ExtendAgendaItemByIdMutation

Description

Extend an agenda item by its ID by user input. It validates the user's authentication using an API key passed in the request header and extends the content of the agenda item in case it's too short.

Fields

Field Name	Description
`summarySuggestions` - `ApiAgendaItemSummary`

Example

{"summarySuggestions": ApiAgendaItemSummary}

Types

Float

Description

The Float scalar type represents signed double-precision fractional values as specified by IEEE 754.

Example

123.45

Types

GenericScalar

Description

The GenericScalar scalar type represents a generic GraphQL scalar value that could be: String, Boolean, Int, Float, List or Object.

Example

GenericScalar

Types

ImportAudioMutation

Description

Fields

Field Name	Description
`protocol` - `ApiProtocolType`	Protocol object
`success` - `Boolean`	Indicates if import audio was successful

Example

{"protocol": ApiProtocolType, "success": true}

Types

Int

Description

The Int scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.

Example

Types

RecreateProtocolMutation

Fields

Field Name	Description
`success` - `Boolean`	Indicates if recreation of protocol was successful

Example

{"success": true}

Types

RenameSpeakerInTextSegmentMutation

Description

Fields

Field Name	Description
`textsegmentsForRename` - `[ApiTextsegmentType]`	List of text segments with renamed speakers
`success` - `Boolean`	Indicates if the rename operation was successful

Example

{
  "textsegmentsForRename": [ApiTextsegmentType],
  "success": false
}

Types

RephraseAgendaItemByIdMutation

Description

Rephrase an agenda item by its ID by user input. It validates the user's authentication using an API key passed in the request header and rephrases the content of the agenda item.

Fields

Field Name	Description
`summarySuggestions` - `ApiAgendaItemSummary`

Example

{"summarySuggestions": ApiAgendaItemSummary}

Types

ResolutionInput

Fields

Field Name	Description
`resolution` - `String`	Resolution text
`decision` - `String`	Decision text

Example

{
  "resolution": "xyz789",
  "decision": "xyz789"
}

Types

ShortenAgendaItemByIdMutation

Description

Fields

Field Name	Description
`summarySuggestions` - `ApiAgendaItemSummary`

Example

{"summarySuggestions": ApiAgendaItemSummary}

Types

SpeakerInput

Fields

Input Field	Description
`old` - `String!`	Current name of the speaker
`new` - `String!`	New name for the speaker

Example

{
  "old": "abc123",
  "new": "abc123"
}

Types

String

Description

The String scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.

Example

"xyz789"

Types

TextsegmentListType

Fields

Field Name	Description
`textsegmentList` - `[ApiTextsegmentType]`	List of text segments

Example

{"textsegmentList": [ApiTextsegmentType]}

Types

TranscriptSegment

Fields

Field Name	Description
`text` - `String`	Transcription text
`startTime` - `Float`	Start time of the segment in seconds
`endTime` - `Float`	End time of the segment in seconds

Example

{
  "text": "xyz789",
  "startTime": 987.65,
  "endTime": 987.65
}

Types

UpdateAgendaItemByIdMutation

Description

Update a specific agenda item by its ID. It validates the user's authentication using an API key passed in the request header and processes the provided agenda item data.

Fields

Field Name	Description
`agendaItem` - `ApiAgendaItemType`	Updated agenda item

Example

{"agendaItem": ApiAgendaItemType}

Types

UpdateAgendaItemsMutation

Description

Update agenda items for a given protocol. It validates the user's authentication using an API key passed in the request header and processes the provided agenda items and protocol slug.

Fields

Field Name	Description
`agendaItems` - `[ApiAgendaItemType]`

Example

{"agendaItems": [ApiAgendaItemType]}