Speechmind API Documentation

Welcome to the SpeechMind GraphQL API v2.

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

This updated version of the API introduces enhanced features and improved functionality across the 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/v2/graphql

Headers

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

Version

2.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

`getAllProjects`

Description

It returns all projects for a user.

Response

Returns [ApiProjectType]

Example

Query

query getAllProjects {
  getAllProjects {
    slug
    name
  }
}

Response

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

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 EditSpeakerDataTypeWithSpeaker

Arguments

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

Example

Query

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

Variables

{"protocolSlug": "abc123"}

Response

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

Queries

`getProtocolsByProject`

Description

It returns all the documents from a project.

Response

Returns [ApiProtocolType]

Arguments

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

Example

Query

query getProtocolsByProject($slug: String!) {
  getProtocolsByProject(slug: $slug) {
    slug
    name
    date
    language
    empty
    editStage
    creatingStep
    status
  }
}

Variables

{"slug": "xyz789"}

Response

{
  "data": {
    "getProtocolsByProject": [
      {
        "slug": "abc123",
        "name": "xyz789",
        "date": "abc123",
        "language": "abc123",
        "empty": true,
        "editStage": false,
        "creatingStep": "abc123",
        "status": true
      }
    ]
  }
}

Queries

`getResults`

Response

Returns an ApiResultsType

Arguments

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

Example

Query

query getResults($protocolSlug: String!) {
  getResults(protocolSlug: $protocolSlug) {
    creationDone
    protocol {
      ...ApiProtocolTypeFragment
    }
    agendaItemList {
      ...ApiAgendaItemTypeFragment
    }
    taskItemList {
      ...ApiTaskTypeFragment
    }
  }
}

Variables

{"protocolSlug": "abc123"}

Response

{
  "data": {
    "getResults": {
      "creationDone": true,
      "protocol": ApiProtocolType,
      "agendaItemList": [ApiAgendaItemType],
      "taskItemList": [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 TextsegmentListTypeV2

Arguments

Name	Description
`protocolSlug` - `String!`	ID of the protocol
`page` - `Int!`	Page number must start from page 1

Example

Query

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

Variables

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

Response

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

Queries

`getTranscriptByAgendaItemId`

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 [ApiTextsegmentTypeV2]

Arguments

Name	Description
`protocolSlug` - `String!`	ID of the protocol
`agendaItemId` - `String!`	ID of the agenda item

Example

Query

query getTranscriptByAgendaItemId(
  $protocolSlug: String!,
  $agendaItemId: String!
) {
  getTranscriptByAgendaItemId(
    protocolSlug: $protocolSlug,
    agendaItemId: $agendaItemId
  ) {
    id
    speakerObj {
      ...ApiSpeakerTypeFragment
    }
    textJson {
      ...TranscriptSegmentFragment
    }
    pos
  }
}

Variables

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

Response

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

Queries

`getUploadUrl`

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 audio file together with the file ending (e.g. .ogg, .mp3, .mp4)

Example

Query

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

Variables

{"uniqueObjName": "abc123"}

Response

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

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": "abc123"}

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": "abc123"}

Response

{
  "data": {
    "deleteAudioByProtocolSlug": {
      "success": false,
      "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": "xyz789"}

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

`initProtocol`

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 InitProtocolMutation

Arguments

Name	Description
`agendaItemList` - `[AgendaItemListInput]`	Agenda list of the audio file
`date` - `Date!`	Date of the audio file
`language` - `String!`	Language of the audio file
`name` - `String!`	Name of the audio file
`projectSlug` - `String!`	Slug of the project
`speakerList` - `[PersonInputList]`	List of speakers to rename
`typeOfDocument` - `String!`	Type of the document
`uniqueObjName` - `String!`	Unique Name of the audio file

Example

Query

mutation initProtocol(
  $agendaItemList: [AgendaItemListInput],
  $date: Date!,
  $language: String!,
  $name: String!,
  $projectSlug: String!,
  $speakerList: [PersonInputList],
  $typeOfDocument: String!,
  $uniqueObjName: String!
) {
  initProtocol(
    agendaItemList: $agendaItemList,
    date: $date,
    language: $language,
    name: $name,
    projectSlug: $projectSlug,
    speakerList: $speakerList,
    typeOfDocument: $typeOfDocument,
    uniqueObjName: $uniqueObjName
  ) {
    protocol {
      ...ApiProtocolTypeFragment
    }
    success
  }
}

Variables

{
  "agendaItemList": [AgendaItemListInput],
  "date": "2007-12-03",
  "language": "abc123",
  "name": "xyz789",
  "projectSlug": "abc123",
  "speakerList": [PersonInputList],
  "typeOfDocument": "abc123",
  "uniqueObjName": "abc123"
}

Response

{
  "data": {
    "initProtocol": {
      "protocol": ApiProtocolType,
      "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
`speakerList` - `[SpeakerDataInput]!`	List of speakers to rename

Example

Query

mutation renameSpeakerInTextsegment(
  $protocolSlug: String!,
  $speakerList: [SpeakerDataInput]!
) {
  renameSpeakerInTextsegment(
    protocolSlug: $protocolSlug,
    speakerList: $speakerList
  ) {
    success
    nextSteps
  }
}

Variables

{
  "protocolSlug": "xyz789",
  "speakerList": [SpeakerDataInput]
}

Response

{
  "data": {
    "renameSpeakerInTextsegment": {
      "success": true,
      "nextSteps": "xyz789"
    }
  }
}

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": "xyz789"
}

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": "xyz789",
  "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` - `AgendaItemInput!`	Agenda item to be updated
`agendaItemId` - `Int!`	ID of the agenda item to be updated

Example

Query

mutation updateAgendaItemById(
  $agendaItem: AgendaItemInput!,
  $agendaItemId: Int!
) {
  updateAgendaItemById(
    agendaItem: $agendaItem,
    agendaItemId: $agendaItemId
  ) {
    agendaItem {
      ...ApiAgendaItemTypeFragment
    }
  }
}

Variables

{"agendaItem": AgendaItemInput, "agendaItemId": 987}

Response

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

Mutations

`updateAllAgendaItemsByDepth`

Description

Setting the detail depth of the agenda items for a given protocol. Depth can't be bigger than the max_depth of the agenda items.

Response

Returns an UpdateAllAgendaItemsByDepthMutation

Arguments

Name	Description
`depth` - `Int!`	New detail depth of the agenda item
`protocolSlug` - `String!`	Name of the protocol

Example

Query

mutation updateAllAgendaItemsByDepth(
  $depth: Int!,
  $protocolSlug: String!
) {
  updateAllAgendaItemsByDepth(
    depth: $depth,
    protocolSlug: $protocolSlug
  ) {
    agendaItemList {
      ...ApiAgendaItemTypeFragment
    }
    success
  }
}

Variables

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

Response

{
  "data": {
    "updateAllAgendaItemsByDepth": {
      "agendaItemList": [ApiAgendaItemType],
      "success": false
    }
  }
}

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

AgendaItemInput

Fields

Input Field	Description
`title` - `String`	Title of the agenda item
`depth` - `Int`	Depth of the agenda item
`textList` - `[TextListItemInput]`	Text list of the agenda item
`resolutionList` - `[ResolutionInputType]`	Resolution list of the agenda item

Example

{
  "title": "xyz789",
  "depth": 987,
  "textList": [TextListItemInput],
  "resolutionList": [ResolutionInputType]
}

Types

AgendaItemListInput

Fields

Input Field	Description
`title` - `String!`	Name of the agenda item
`systemId` - `String`	ID of the agenda item in external system
`startTime` - `String`	Timestamp 'HH:MM:SS' of the start time of the agenda item
`resolution` - `String`	Resolution text of the agenda item in external system

Example

{
  "title": "xyz789",
  "systemId": "abc123",
  "startTime": "xyz789",
  "resolution": "abc123"
}

Types

ApiAgendaItemSummary

Fields

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

Example

{"suggestions": ["abc123"]}

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` - `GenericScalar`	{ "0": ["Die Software funktioniert gut."], "1": ["Bitte fügen Sie eine Chat-Funktion hinzu."], "2": ["Das Login über Google sollte schneller sein."] ... }
`resolutionList` - `[ResolutionType]`	List of resolutions
`createdAt` - `DateTime`	Creation date of the agenda item
`updatedAt` - `DateTime`	Last update date of the agenda item

Example

{
  "id": "abc123",
  "classType": "xyz789",
  "title": "xyz789",
  "depth": 123,
  "maxDepth": 987,
  "metaData": "xyz789",
  "textList": GenericScalar,
  "resolutionList": [ResolutionType],
  "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": "abc123"
}

Types

ApiProtocolType

Fields

Field Name	Description
`slug` - `String`	ID of the protocol
`name` - `String`	Name of the protocol
`date` - `String`	Date of the protocol
`language` - `String`	Language of the protocol
`empty` - `Boolean`	Empty status of the protocol
`editStage` - `Boolean`	DEPRICATED: Edit stage of the protocol
`creatingStep` - `String`	Creation step of the protocol
`status` - `Boolean`	Status of the protocol, status can be True or False

Example

{
  "slug": "abc123",
  "name": "abc123",
  "date": "abc123",
  "language": "abc123",
  "empty": false,
  "editStage": false,
  "creatingStep": "abc123",
  "status": false
}

Types

ApiResultsType

Fields

Field Name	Description
`creationDone` - `Boolean`	Protocol creation status
`protocol` - `ApiProtocolType`	Protocol object
`agendaItemList` - `[ApiAgendaItemType]`	List of agenda items
`taskItemList` - `[ApiTaskType]`	List of tasks

Example

{
  "creationDone": true,
  "protocol": ApiProtocolType,
  "agendaItemList": [ApiAgendaItemType],
  "taskItemList": [ApiTaskType]
}

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
`systemId` - `String`	External System ID of the speaker
`specialCase` - `Boolean`	Special Case of the speaker

Example

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

Types

ApiSummaryPerSpeakerItemTypeWithSpeaker

Fields

Field Name	Description
`speakerObj` - `ApiSpeakerType`	Object of the speaker
`textList` - `GenericScalar`	{ "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

{
  "speakerObj": ApiSpeakerType,
  "textList": GenericScalar,
  "speakerSuggestion": "abc123",
  "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": "xyz789",
  "date": "abc123",
  "assignedTo": "xyz789",
  "done": false,
  "createdAt": "2007-12-03T10:15:30Z",
  "updatedAt": "2007-12-03T10:15:30Z"
}

Types

ApiTextsegmentTypeV2

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": 123
}

Types

Boolean

Description

The Boolean scalar type represents true or 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": true}

Types

EditSpeakerDataTypeWithSpeaker

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` - `[ApiSummaryPerSpeakerItemTypeWithSpeaker]`	List of summaries per speaker

Example

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

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

InitProtocolMutation

Description

Fields

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

Example

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

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

PersonInputList

Fields

Input Field	Description
`gender` - `String!`	Gender of the speaker [w, m, d]
`givenName` - `String!`	Given name of the speaker
`familyName` - `String!`	Family name of the speaker
`party` - `String`	Partei Firma of the speaker. Default = `null`
`preTitle` - `String`	Pre Titel of the speaker. Default = `null`
`postTitle` - `String`	Post Titel of the speaker. Default = `null`
`systemId` - `String`	External System ID of the speaker. Default = `null`

Example

{
  "gender": "xyz789",
  "givenName": "xyz789",
  "familyName": "xyz789",
  "party": "xyz789",
  "preTitle": "abc123",
  "postTitle": "xyz789",
  "systemId": "xyz789"
}

Types

RenameSpeakerInTextsegmentMutation

Description

Fields

Field Name	Description
`success` - `Boolean`	Indicates if the rename operation was successful
`nextSteps` - `String`	Next steps after the rename operation

Example

{"success": true, "nextSteps": "abc123"}

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

ResolutionInputType

Fields

Input Field	Description
`resolution` - `String`	Resolution text. Default = `null`
`decision` - `String`	Decision text. Default = `null`

Example

{
  "resolution": "abc123",
  "decision": "abc123"
}

Types

ResolutionType

Fields

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

Example

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

Types

ShortenAgendaItemByIdMutation

Description

Fields

Field Name	Description
`summarySuggestions` - `ApiAgendaItemSummary`

Example

{"summarySuggestions": ApiAgendaItemSummary}

Types

SpeakerDataInput

Fields

Input Field	Description
`oldSlug` - `String!`	Current slug of the speaker
`gender` - `String`	Gender of the new speaker
`givenName` - `String`	Given name of the new speaker
`familyName` - `String`	Family name of the new speaker
`party` - `String`	Party of the new speaker
`preTitle` - `String`	Pre-title of the new speaker
`postTitle` - `String`	Post-title of the new speaker
`posLong` - `String`	Long position of the new speaker
`posShort` - `String`	Short position of the new speaker
`systemId` - `String`	External System ID of the new speaker

Example

{
  "oldSlug": "abc123",
  "gender": "abc123",
  "givenName": "abc123",
  "familyName": "abc123",
  "party": "abc123",
  "preTitle": "xyz789",
  "postTitle": "abc123",
  "posLong": "xyz789",
  "posShort": "abc123",
  "systemId": "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

TextListItemInput

Fields

Input Field	Description
`depth` - `String!`	Identifier like '0', '1', '2'
`sentenceList` - `[String]!`	List of sentences for this detail depth

Example

{
  "depth": "abc123",
  "sentenceList": ["xyz789"]
}

Types

TextsegmentListTypeV2

Fields

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

Example

{"textsegmentList": [ApiTextsegmentTypeV2]}

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": 123.45,
  "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

UpdateAllAgendaItemsByDepthMutation

Description

Setting the detail depth of the agenda items for a given protocol. Depth can't be bigger than the max_depth of the agenda items.

Fields

Field Name	Description
`agendaItemList` - `[ApiAgendaItemType]`	List of agenda items
`success` - `Boolean`	Indicates if the rename operation was successful

Example

{"agendaItemList": [ApiAgendaItemType], "success": true}

Documentation by Anvil SpectaQL