OBJECT

Query

Queries are used to retrieve data. If you're new to our API, try the me query to explore the information you have access to. Hit ctrl-space at any time to activate field completion hints, and mouse over a field or parameter to see its documentation.

link GraphQL Schema definition

1type Query {
2
3# Retrieve a list of temporal data objects.
4# Example:
5# Request:
6# query {
7#
8# temporalDataObjects(
9#
10# organizationId: "35521"){
11#
12# records{name}
13#
14# offset
15#
16# limit
17#
18# count
19#
20# }
21# }
22# Response:
23# {
24#
25# "data": {
26#
27# "temporalDataObjects": {
28#
29# "records": [
30#
31# {
32#
33# "name": "example"
34#
35# },
36#
37# {
38#
39# "name": "example"
40#
41# },
42#
43# ],
44#
45# "offset": 0,
46#
47# "limit": 30,
48#
49# "count": 8
50#
51# }
52#
53# }
54# }
55#
56# Arguments
57# organizationId: Organization ID to get TDOs for. Defaults to
58# the user's own organization.
59# You can only retrieves content for your own organizations or organizations
60# that have shared data with yours.
61# applicationId: Application ID (an authorization construct that
62# maps directly to organization ID)
63# to get TDOs for. Defaults to the user's own organization.
64# id: Provide a list of IDs to retrieve the specific TDOs.
65# offset: Provide an offset to skip to a certain element in the
66# result, for paging.
67# limit: Specify maximum number of results to retrieve in this
68# result. Page size.
69# sourceId: Optionally, specify a source ID. TDOs ingested from
70# this source will
71# be returned.
72# programId: Optionally, specify a program ID. TDOs belong to
73# this program will
74# be returned.
75# scheduledJobId: Optionally, specify a scheduled job ID. TDOs
76# ingested under this
77# scheduled job will be returned.
78# sampleMedia: Whether to retrieve only tdos with the specified
79# sampleMedia value
80# includePublic: Whether to retrieve public data that is not part
81# of the user's organization.
82# The default is false. Pass true to include public data in the result set.
83# dateTimeFilter: Provide optional filters against any date/time
84# field to filter
85# objects within a given time window.
86# Matching objects must meet all of the given conditions.
87# mentionId: Retrieve TDOs associated with the given mention
88temporalDataObjects(
89organizationId: ID,
90applicationId: ID,
91id: ID,
92ids: [ID],
93offset: Int,
94limit: Int,
95sourceId: ID,
96programId: ID,
97scheduledJobId: ID,
98sampleMedia: Boolean,
99includePublic: Boolean,
100orderBy: TemporalDataObjectOrderBy,
101orderDirection: OrderDirection,
102dateTimeFilter: [TemporalDataObjectDateTimeFilter!],
103mentionId: ID
104): TDOList
105
106# Retrieve a single temporal data object
107# Example:
108# Request:
109# query {
110#
111# temporalDataObject(
112#
113# id: 1570654874) {
114#
115# id
116#
117# name
118#
119# }
120# }
121# Response:
122# {
123#
124# "data": {
125#
126# "temporalDataObject": {
127#
128# "id": "1570654874",
129#
130# "name": "example"
131#
132# }
133#
134# }
135# }
136#
137# Arguments
138# id: the TDO ID
139temporalDataObject(id: ID!): TemporalDataObject
140
141# Retrieve a single Asset
142# Example:
143# Request:
144# query {
145#
146# asset(
147#
148# id: "1570654874_4hJtNKSUXD") {
149#
150# id
151#
152# name
153#
154# description
155#
156# }
157# }
158# Response:
159# {
160#
161# "data": {
162#
163# "asset": {
164#
165# "id": "1570654874_4hJtNKSUXD",
166#
167# "name": "example",
168#
169# "description": "example"
170#
171# }
172#
173# }
174# }
175#
176# Arguments
177# id: The asset ID
178asset(id: ID!): Asset
179
180# Retrieve multiple assets
181# Example:
182# Request:
183# query {
184#
185# assets(
186#
187# ids:["1570654874_4hJtNKSUXD"],
188#
189# contentTypes:[],
190#
191# assetTypes:["text"],
192#
193# sourceEngineIds:[],
194#
195# createdDateFilter:null,
196#
197# scrollId: null){
198#
199# assets{
200#
201# records{id}
202#
203# count
204#
205# }
206#
207# scrollId
208#
209# }
210# }
211# Response:
212# {
213#
214# "data": {
215#
216# "assets": {
217#
218# "assets": {
219#
220# "records": [],
221#
222# "count": 0
223#
224# },
225#
226# "scrollId": ""
227#
228# }
229#
230# }
231# }
232#
233# Arguments
234# ids: List of asset ids
235# contentTypes: Filter assets with content type included in the
236# list
237# See https://www.iana.org/assignments/media-types/media-types.xhtml
238# assetTypes: Filter assets with assetType included in the list
239# See https://support.veritone.com/s/article/000003943 for list of values.
240# sourceEngineIds: Filter by source engine.
241# Not all assets have associated engineId, ex. media assets
242# createdDateFilter: Filter by created date
243# Note createdDateFilter.filter is required, but currently ignored
244# offset: Offset to skip to a certain element in the result, for
245# paging.
246# limit: Maximum number of results to retrieve in this result.
247# Page size.
248# scrollId: Use this field when sequentially iterating over the
249# assets list
250# This is required for when offset + limit exceeds 10000.
251# The value of this field is set from the response of the first/previous
252# assets query
253assets(
254ids: [ID!],
255contentTypes: [String!],
256assetTypes: [String!],
257sourceEngineIds: [String!],
258createdDateFilter: TemporalDataObjectDateTimeFilter,
259offset: Int,
260limit: Int,
261scrollId: String
262): AssetScrollList
263
264# Retrieve a single Widget
265# Example:
266# Request:
267# query {
268#
269# widget(
270#
271# id: "KOIFUT_rT_Oy3Ev9zfKT6A") {
272#
273# collection{
274#
275# id
276#
277# }
278#
279# }
280# }
281# Response:
282# {
283#
284# "data": {
285#
286# "widget": {
287#
288# "collection": {
289#
290# "id": "243625"
291#
292# }
293#
294# }
295#
296# }
297# }
298#
299# Arguments
300# id: The widget ID
301widget(id: ID!): Widget
302
303# Retrieve clone job entries
304# Example:
305# Request:
306# query {
307#
308# cloneRequests {
309#
310# records{
311#
312# id
313#
314# }
315#
316# }
317# }
318#
319# Response:
320#
321# {
322#
323# "data": {
324#
325# "cloneRequests": {
326#
327# "records": []
328#
329# }
330#
331# }
332# }
333#
334# Arguments
335# id: Provide an ID to retrieve a single specific clone request.
336# applicationId: Application ID to get clone requests for.
337# Defaults to the user's own application.
338cloneRequests(id: ID, applicationId: ID, offset: Int, limit: Int): CloneRequestList
339
340# Retrieve most recent builds
341# Example:
342# Request:
343# query {
344#
345# recentBuilds(limit:2) {
346#
347# records{
348#
349# id
350#
351# name
352#
353# }
354#
355# }
356# }
357# Response:
358# {
359#
360# "data": {
361#
362# "recentBuilds": {
363#
364# "records": [
365#
366# {
367#
368# "id": "44193f81-57b4-47dd-9fe0-be95000776d9",
369#
370# "name": "example Version 5"
371#
372# },
373#
374# {
375#
376# "id": "bae12129-2724-40c3-abd2-6bb4021f21ae",
377#
378# "name": "example Version 4"
379#
380# }
381#
382# ]
383#
384# }
385#
386# }
387# }
388#
389# Arguments
390# buildStatus: Engine build status:
391# offset: Specify maximum number of results to retrieve in this
392# result. Page size.
393# limit: Specify maximum number of results to retrieve in this
394# result.
395# orderBy: Set order information on the query. Multiple fields
396# are supported.
397# Default order by modifiedDateTime desc
398recentBuilds(
399buildStatus: [BuildStatus!],
400offset: Int,
401limit: Int,
402orderBy: [EngineBuildOrderBy!]
403): BuildList
404
405# Retrieve engine overview
406# Example:
407# Request:
408# query {
409#
410# engineOverview {
411#
412# ready
413#
414# }
415# }
416#
417# Response:
418#
419# {
420#
421# "data": {
422#
423# "engineOverview": {
424#
425# "ready": 7
426#
427# }
428#
429# }
430# }
431engineOverview: EngineOverview
432
433# Retrieve engines
434# Example:
435# Request:
436# query {
437#
438# engines(limit:2) {
439#
440# records{
441#
442# id
443#
444# state
445#
446# }
447#
448# }
449# }
450# Response:
451# {
452#
453# "data": {
454#
455# "engines": {
456#
457# "records": [
458#
459# {
460#
461# "id": "2",
462#
463# "state": "pending"
464#
465# },
466#
467# {
468#
469# "id": "1",
470#
471# "state": "pending"
472#
473# }
474#
475# ]
476#
477# }
478#
479# }
480# }
481#
482# Arguments
483# id: Provide an ID to retrieve a single specific engine.
484# categoryId: Provide a category ID to filter by engine category.
485# category: provide a category name or ID to filter by engine
486# category
487# state: Provide a list of states to filter by engine state.
488# owned: If true, return only engines owned by the user's
489# organization.
490# libraryRequired: If true, return only engines that require a
491# library.
492# createsTDO: If true, return only engines that create their own
493# TDO.
494# If false, return only engines that do not create a TDO.
495# If not set, return either.
496# name: Provide a name, or part of a name, to search by engine
497# name. If `filter.name` is also provided
498# then the value of this field will be ignored.
499# offset: Specify maximum number of results to retrieve in this
500# result. Page size.
501# limit: Specify maximum number of results to retrieve in this
502# result.
503# filter: Filters for engine attributes
504# orderBy: Provide a list of EngineSortField to sort by.
505# edgeVersion: Edge version to filter
506engines(
507id: ID,
508ids: [ID!],
509categoryId: String,
510category: String,
511state: [EngineState],
512owned: Boolean,
513libraryRequired: Boolean,
514createsTDO: Boolean,
515name: String,
516offset: Int,
517limit: Int,
518filter: EngineFilter,
519orderBy: [EngineSortField],
520edgeVersion: Int
521): EngineList
522
523# Retrieve a single engine by ID
524# Example:
525# Request:
526# query {
527#
528# engine(id:1) {
529#
530# name
531#
532# state
533#
534# }
535# }
536# Response:
537# {
538#
539# "data": {
540#
541# "engine": {
542#
543# "name": "example",
544#
545# "state": "pending"
546#
547# }
548#
549# }
550# }
551#
552# Arguments
553# id: Provide the engine ID
554engine(id: ID!): Engine
555
556# Retrieve an engine build
557# Example:
558# Request:
559# query {
560#
561# engineBuild(id: "2a1a1b58-6983-4002-b9ed-7b7f325f621a"){
562#
563# name
564#
565# engineId
566#
567# }
568# }
569#
570# Response:
571# {
572#
573# "data": {
574#
575# "engineBuild": {
576#
577# "name": "example Version 1",
578#
579# "engineId": "1"
580#
581# }
582#
583# }
584# }
585#
586# Arguments
587# id: Provide the build ID
588engineBuild(id: ID!): Build
589
590# Retrieve engine categories
591# Example:
592# Request:
593# query {
594#
595# engineCategories(limit:2) {
596#
597# records {
598#
599# id
600#
601# type {
602#
603# name
604#
605# }
606#
607# name
608#
609# }
610#
611# }
612# }
613# Response:
614# {
615#
616# "data": {
617#
618# "engineCategories": {
619#
620# "records": [
621#
622# {
623#
624# "id": "581dbb32-ea5b-4458-bd15-8094942345e3",
625#
626# "type": {
627#
628# "name": "Cognition"
629#
630# },
631#
632# "name": "Transcode"
633#
634# },
635#
636# {
637#
638# "id": "67cd4dd0-2f75-445d-a6f0-2f297d6cd182",
639#
640# "type": {
641#
642# "name": "Cognition"
643#
644# },
645#
646# "name": "Transcription"
647#
648# }
649#
650# ]
651#
652# }
653#
654# }
655# }
656#
657# Arguments
658# id: Provide an ID to retrieve a single specific engine
659# category.
660# ids: Provide multiple IDs to retrieve engine categories
661# name: Provide a name, or part of one, to search by category
662# name
663# type: Return all categories of an engine type
664# offset: Specify maximum number of results to retrieve in this
665# result. Page size.
666# limit: Specify maximum number of results to retrieve in this
667# result.
668engineCategories(
669id: ID,
670ids: [ID!],
671name: String,
672type: String,
673offset: Int,
674limit: Int
675): EngineCategoryList
676
677# Retrieve a specific engine category\
678# Example:
679# Request:
680# query {
681#
682# engineCategory(id: "581dbb32-ea5b-4458-bd15-8094942345e3") {
683#
684# name
685#
686# type{
687#
688# name
689#
690# }
691#
692# }
693# }
694# Response:
695# {
696#
697# "data": {
698#
699# "engineCategory": {
700#
701# "name": "Transcode",
702#
703# "type": {
704#
705# "name": "Cognition"
706#
707# }
708#
709# }
710#
711# }
712# }
713#
714# Arguments
715# id: Supply the ID of the engine category to retrieve
716engineCategory(id: ID!): EngineCategory
717
718# Retrieve jobs
719# Example:
720# Request:
721# query {
722#
723# jobs(limit:2) {
724#
725# records{
726#
727# id
728#
729# name
730#
731# }
732#
733# }
734# }
735# Response:
736# {
737#
738# "data": {
739#
740# "jobs": {
741#
742# "records": []
743#
744# }
745#
746# }
747# }
748#
749# Arguments
750# id: Provide an ID to retrieve a single specific job.
751# status: Provide a list of status strings to filter by status
752# offset: Provide an offset to skip to a certain element in the
753# result, for paging.
754# limit: Specify the maximum number of results to included in
755# this response, or page size.
756# applicationId: Provide an application ID to filter jobs for a
757# given application.
758# Defaults to the user's own application.
759# targetId: Provide a target ID to get the set of jobs running
760# against a particular TDO.
761# clusterId: Provide a cluster ID to get the jobs running on a
762# specific cluster
763# scheduledJobIds: Provide a list of scheduled job IDs to get
764# jobs associated with the scheduled jobs
765# hasScheduledJobId: Return only jobs that are (true) or are not
766# (false) associated with a scheduled job
767# orderBy: Provide sort information. The default is to sort by
768# createdDateTime descending.
769# dateTimeFilter: Filter by date/time field
770# applicationIds: Provide list of application IDs to filter jobs.
771# Defaults to the user's own application.
772# engineIds: Provide a list of engine IDs to filter for jobs
773# that contain tasks for the specified engines.
774# engineCategoryIds: Provide a list of engine category IDs to
775# filter for jobs
776# that contain tasks for engines in the specific categories.
777# dagTemplateIds: Provide a list of DAG template IDs to get jobs
778# associated with the DAG templates
779jobs(
780hasTargetTDO: Boolean,
781id: ID,
782status: [JobStatusFilter!],
783applicationStatus: String,
784offset: Int,
785limit: Int,
786applicationId: ID,
787targetId: ID,
788clusterId: ID,
789scheduledJobIds: [ID!],
790hasScheduledJobId: Boolean,
791orderBy: [JobSortField!],
792dateTimeFilter: [JobDateTimeFilter!],
793applicationIds: [ID],
794engineIds: [ID!],
795engineCategoryIds: [ID!],
796dagTemplateIds: [ID]
797): JobList
798
799# Retrieve a single job by ID
800#
801# Arguments
802# id: the job ID.
803job(id: ID!): Job
804
805# Retrieve a single task by ID
806#
807# Arguments
808# id: Provide the task ID.
809task(id: ID!): Task
810
811# Retrieve entity identifier types
812# Example:
813# Request:
814# query {
815#
816# entityIdentifierTypes(limit:2) {
817#
818# records{
819#
820# id
821#
822# label
823#
824# }
825#
826# }
827# }
828# Response:
829# {
830#
831# "data": {
832#
833# "entityIdentifierTypes": {
834#
835# "records": [
836#
837# {
838#
839# "id": "face",
840#
841# "label": "Face"
842#
843# },
844#
845# {
846#
847# "id": "audio-recording",
848#
849# "label": "audio file"
850#
851# }
852#
853# ]
854#
855# }
856#
857# }
858# }
859#
860# Arguments
861# id: Provide an ID to retrieve a single specific entity
862# identifier type.
863# offset: Provide an offset to skip to a certain element in the
864# result, for paging.
865# limit: Specify maximum number of results to retrieve in this
866# result. Page size.
867entityIdentifierTypes(id: ID, offset: Int, limit: Int): EntityIdentifierTypeList
868
869# Retrieve an entity identifier type
870# Example:
871# Request:
872# query {
873#
874# entityIdentifierType(id:"face") {
875#
876# label
877#
878# entityIdentifierItems {
879#
880# libraryTypeId
881#
882# }
883#
884# }
885# }
886# Response:
887# {
888#
889# "data": {
890#
891# "entityIdentifierType": {
892#
893# "label": "Face",
894#
895# "entityIdentifierItems": [
896#
897# {
898#
899# "libraryTypeId": "people"
900#
901# },
902#
903# {
904#
905# "libraryTypeId": "suspect"
906#
907# },
908#
909# {
910#
911# "libraryTypeId": "people-known-offender"
912#
913# },
914#
915# {
916#
917# "libraryTypeId": "people-of-interest"
918#
919# }
920#
921# ]
922#
923# }
924#
925# }
926# }
927#
928# Arguments
929# id: Provide the entity identifier type ID
930entityIdentifierType(id: ID!): EntityIdentifierType
931
932# Retrieve all library types
933# Example:
934# Request:
935# query {
936#
937# libraryTypes(limit:2) {
938#
939# records{
940#
941# id
942#
943# entityTypeName
944#
945# }
946#
947# }
948# }
949# Response:
950# {
951#
952# "data": {
953#
954# "libraryTypes": {
955#
956# "records": [
957#
958# {
959#
960# "id": "people-known-offender",
961#
962# "entityTypeName": "known offender"
963#
964# },
965#
966# {
967#
968# "id": "dataset",
969#
970# "entityTypeName": "dataset"
971#
972# }
973#
974# ]
975#
976# }
977#
978# }
979# }
980#
981# Arguments
982# id: Provide an ID to retrieve a single specific library type.
983# offset: Provide an offset to skip to a certain element in the
984# result, for paging.
985# limit: Specify maximum number of results to retrieve in this
986# result. Page size.
987libraryTypes(id: ID, offset: Int, limit: Int): LibraryTypeList
988
989# Retrieve a single library type
990# Example:
991# Request:
992# query {
993#
994# libraryType(id: "people-known-offender") {
995#
996# entityTypeName
997#
998# label
999#
1000# }
1001# }
1002# Response:
1003# {
1004#
1005# "data": {
1006#
1007# "libraryType": {
1008#
1009# "entityTypeName": "known offender",
1010#
1011# "label": "IDentify - Known Offender"
1012#
1013# }
1014#
1015# }
1016# }
1017#
1018# Arguments
1019# id: Provide an ID to retrieve a single specific library type.
1020libraryType(id: ID): LibraryType
1021
1022# Retrieve libraries and entities
1023# Example:
1024# Request:
1025# query {
1026#
1027# libraries(limit:2) {
1028#
1029# records {
1030#
1031# id
1032#
1033# name
1034#
1035# libraryTypeId
1036#
1037# }
1038#
1039# }
1040# }
1041# Response:
1042# {
1043#
1044# "data": {
1045#
1046# "libraries": {
1047#
1048# "records": [
1049#
1050# {
1051#
1052# "id": "e0a6e5ad-dec8-49a1-ad33-3f1194c2e599",
1053#
1054# "name": "example",
1055#
1056# "libraryTypeId": "123"
1057#
1058# }
1059#
1060# ]
1061#
1062# }
1063#
1064# }
1065# }
1066#
1067# Arguments
1068# id: Provide an ID to retrieve a single specific library.
1069# name: Provide a name string to search by name.
1070# type: Provide the name or ID of a library to search for
1071# libraries
1072# that contain that type.
1073# entityIdentifierTypeIds: Provide the id of an entity identifier
1074# type to search for libraries that correlate
1075# to that type.
1076# includeOwnedOnly: Specify true if only libraries owned by the
1077# user's organization
1078# should be returned. Otherwise, shared libraries will be included.
1079# offset: Provide an offset to skip to a certain element in the
1080# result, for paging.
1081# limit: Specify maximum number of results to retrieve in this
1082# result. Page size.
1083# orderBy: Specify a field to order by
1084# orderDirection: Specify the direction to order by
1085libraries(
1086id: ID,
1087name: String,
1088type: String,
1089entityIdentifierTypeIds: [String!],
1090includeOwnedOnly: Boolean,
1091offset: Int,
1092limit: Int,
1093orderBy: LibraryOrderBy,
1094orderDirection: OrderDirection
1095): LibraryList
1096
1097# Retrieve a specific library
1098# Example:
1099# Request:
1100# query {
1101#
1102# library(id: "e0a6e5ad-dec8-49a1-ad33-3f1194c2e599") {
1103#
1104# name
1105#
1106# organizationId
1107#
1108# }
1109# }
1110# Response:
1111# {
1112#
1113# "data": {
1114#
1115# "library": {
1116#
1117# "name": "example",
1118#
1119# "organizationId": "35521"
1120#
1121# }
1122#
1123# }
1124# }
1125#
1126# Arguments
1127# id: Provide a library ID.
1128library(id: ID!): Library
1129
1130# Retrieve a specific library engine model
1131# Example:
1132# Request:
1133# query {
1134#
1135# libraryEngineModel(id: "87714ca6-8dbd-4da0-9dc0-d9233927b00d") {
1136#
1137# trainStatus
1138#
1139# engineId
1140#
1141# }
1142# }
1143# Response:
1144# {
1145#
1146# "data": {
1147#
1148# "libraryEngineModel": {
1149#
1150# "trainStatus": "pending",
1151#
1152# "engineId": "1"
1153#
1154# }
1155#
1156# }
1157# }
1158#
1159# Arguments
1160# id: Provide the library engine model ID
1161libraryEngineModel(id: ID!): LibraryEngineModel
1162
1163# Retrieve a specific entity
1164# Example:
1165# Request:
1166# query {
1167#
1168# entity(id: "85b700fa-f327-4fea-b94b-ed83054170db") {
1169#
1170# name
1171#
1172# libraryId
1173#
1174# isPublished
1175#
1176# }
1177# }
1178# Response:
1179# {
1180#
1181# "data": {
1182#
1183# "entity": {
1184#
1185# "name": "example",
1186#
1187# "libraryId": "e0a6e5ad-dec8-49a1-ad33-3f1194c2e599",
1188#
1189# "isPublished": false
1190#
1191# }
1192#
1193# }
1194# }
1195#
1196# Arguments
1197# id: Provide an entity ID.
1198entity(id: ID!): Entity
1199
1200# Retrieve a list of entities across libraries
1201# Example:
1202# Request:
1203# query {
1204#
1205# entities(libraryIds: "e0a6e5ad-dec8-49a1-ad33-3f1194c2e599") {
1206#
1207# records {
1208#
1209# id
1210#
1211# name
1212#
1213# isPublished
1214#
1215# }
1216#
1217# }
1218# }
1219# Response:
1220# {
1221#
1222# "data": {
1223#
1224# "entities": {
1225#
1226# "records": [
1227#
1228# {
1229#
1230# "id": "85b700fa-f327-4fea-b94b-ed83054170db",
1231#
1232# "name": "example",
1233#
1234# "isPublished": false
1235#
1236# }
1237#
1238# ]
1239#
1240# }
1241#
1242# }
1243# }
1244#
1245# Arguments
1246# ids: Provide a list of entity IDs to retrieve those entities
1247# libraryIds: Provide a list of library IDs to retrieve entities
1248# across
1249# multiple libraries.
1250entities(
1251ids: [ID!],
1252libraryIds: [ID!],
1253isPublished: Boolean,
1254identifierTypeId: ID,
1255name: String,
1256offset: Int,
1257limit: Int,
1258orderBy: LibraryEntityOrderBy,
1259orderDirection: OrderDirection
1260): EntityList
1261
1262# Retrieve library configuration
1263# Example:
1264# Request:
1265# query {
1266#
1267# libraryConfiguration(id:"7396e71b-db5a-4c4c-bf6f-4fc66a5a07f7") {
1268#
1269# confidence{
1270#
1271# min
1272#
1273# max
1274#
1275# }
1276#
1277# }
1278# }
1279# Response:
1280# {
1281#
1282# "data": {
1283#
1284# "libraryConfiguration": {
1285#
1286# "confidence": {
1287#
1288# "min": 0,
1289#
1290# "max": 100
1291#
1292# }
1293#
1294# }
1295#
1296# }
1297# }
1298#
1299# Arguments
1300# id: Provide configuration id
1301libraryConfiguration(id: ID!): LibraryConfiguration
1302
1303# Retrieve applications. These are custom applications integrated into
1304# the Veritone platform using the VDA framework.
1305# Example:
1306# Request:
1307# query {
1308#
1309# applications(limit:2) {
1310#
1311# records {
1312#
1313# id
1314#
1315# name
1316#
1317# }
1318#
1319# }
1320# }
1321# Response:
1322# {
1323#
1324# "data": {
1325#
1326# "applications": {
1327#
1328# "records": [
1329#
1330# {
1331#
1332# "id": "47bd3e25-f4ea-435f-b69b-13cb4f9dd60a",
1333#
1334# "name": "appexamplebill"
1335#
1336# },
1337#
1338# {
1339#
1340# "id": "5908703b-51b4-4291-9787-b54bada73b0a",
1341#
1342# "name": "appexample2"
1343#
1344# }
1345#
1346# ]
1347#
1348# }
1349#
1350# }
1351# }
1352#
1353# Arguments
1354# id: Provide an ID to retrieve a single specific application.
1355# ids: Provide a list of IDs to retrieve multiple specific
1356# applications.
1357# status: Provide a status, such as "draft" or "active"
1358# owned: If true, return only applications owned by the user's
1359# organization.
1360# orgId: For super admin user only, if specified, the query
1361# returns applications for this orgId.
1362# isPublic: Filter applications that are public
1363# excludeViewOnly: Include package grantType==VIEW
1364# filter: Filters for application attributes
1365# offset: Provide an offset to skip to a certain element in the
1366# result, for paging.
1367# limit: Specify maximum number of results to retrieve in this
1368# result. Page size.
1369# orderBy: Provide a list of ApplicationSortField to sort by.
1370# accessScope: Specify one or more access scopes to filter by
1371# accessible applications
1372applications(
1373id: ID,
1374ids: [ID!],
1375status: ApplicationStatus,
1376owned: Boolean,
1377orgId: ID,
1378isPublic: Boolean,
1379excludeViewOnly: Boolean,
1380filter: ApplicationFilter,
1381offset: Int,
1382limit: Int,
1383orderBy: [ApplicationSortField],
1384accessScope: [AccessScope!]
1385): ApplicationList
1386
1387# Retrieve organizations
1388# Example:
1389# Request:
1390# query {
1391#
1392# organizations(limit:2) {
1393#
1394# records {
1395#
1396# id
1397#
1398# name
1399#
1400# }
1401#
1402# }
1403# }
1404# Response:
1405# {
1406#
1407# "data": {
1408#
1409# "organizations": {
1410#
1411# "records": [
1412#
1413# {
1414#
1415# "id": "35521",
1416#
1417# "name": "WTS API Docs Org"
1418#
1419# }
1420#
1421# ]
1422#
1423# }
1424#
1425# }
1426# }
1427#
1428# Arguments
1429# id: Provide an ID to retrieve a single specific organization.
1430# offset: Provide an offset to skip to a certain element in the
1431# result, for paging.
1432# limit: Specify maximum number of results to retrieve in this
1433# result. Page size.
1434# kvpProperty: Provide a property from the organization kvp to
1435# filter the organization list.
1436# kvpValue: Provide value to for the kvpFeature filter.
1437# If not present the filter becomes kvpProperty existence filter
1438# name: Optionally, supply a string for string match
1439# status: Optionally, filter by Organization's status
1440# nameMatch: Supply the type of string match to apply.
1441organizations(
1442id: ID,
1443offset: Int,
1444limit: Int,
1445kvpProperty: String,
1446kvpValue: String,
1447name: String,
1448status: OrganizationStatus,
1449nameMatch: StringMatch,
1450isHubManaged: Boolean
1451): OrganizationList
1452
1453# Retrieve a single organization
1454# Example:
1455# Request:
1456# query {
1457#
1458# organization(id: "35521") {
1459#
1460# status
1461#
1462# }
1463# }
1464# Response:
1465# {
1466#
1467# "data": {
1468#
1469# "organization": {
1470#
1471# "status": "active"
1472#
1473# }
1474#
1475# }
1476# }
1477#
1478# Arguments
1479# id: The organization ID
1480# TODO take application ID as well as org ID
1481organization(id: ID!): Organization
1482
1483# Retrieve basic organization info about the organizations to which the user
1484# belongs
1485# Example:
1486# Request:
1487# query {
1488#
1489# myOrganizations {
1490#
1491# records {
1492#
1493# id
1494#
1495# name
1496#
1497# }
1498#
1499# }
1500# }
1501# Response:
1502# {
1503#
1504# "data": {
1505#
1506# "myOrganizations": {
1507#
1508# "records": [
1509#
1510# {
1511#
1512# "id": "35521",
1513#
1514# "name": "WTS API Docs Org"
1515#
1516# }
1517#
1518# ]
1519#
1520# }
1521#
1522# }
1523# }
1524#
1525# Arguments
1526# offset: Provide an offset to skip to a certain element in the
1527# result, for paging.
1528# limit: Specify maximum number of results to retrieve in this
1529# result. Page size.
1530# status: Filter by organization status
1531myOrganizations(
1532offset: Int,
1533limit: Int,
1534status: OrganizationStatus,
1535userName: String
1536): OrganizationInfoList
1537
1538# Retrieve the login configuration for an organization
1539# Example:
1540# Request:
1541# query {
1542#
1543# loginConfiguration(slug: "my-organization") {
1544#
1545# organizationInfo {
1546#
1547# id
1548#
1549# name
1550#
1551# }
1552#
1553# }
1554# }
1555# Response:
1556# {
1557#
1558# "data": {
1559#
1560# "loginConfiguration": {
1561#
1562# "organizationInfo": {
1563#
1564# "id": "12345",
1565#
1566# "name": "My Organization"
1567#
1568# }
1569#
1570# }
1571#
1572# }
1573# }
1574#
1575# Arguments
1576# slug: The login slug associated with the login configuration
1577# for an organization
1578loginConfiguration(slug: String!): LoginConfiguration
1579
1580# Retrieve all login configurations for the Instance
1581# Example:
1582# Request:
1583# query {
1584#
1585# instanceLoginConfigurations {
1586#
1587# records {
1588#
1589# slug
1590#
1591# }
1592#
1593# }
1594# }
1595# Response:
1596# {
1597#
1598# "data": {
1599#
1600# "instanceLoginConfigurations": {
1601#
1602# records: [
1603#
1604# {
1605#
1606# "slug": "instance-slug",
1607#
1608# },
1609#
1610# {
1611#
1612# "slug": "other-instance-slug",
1613#
1614# }
1615#
1616# ]
1617#
1618# }
1619#
1620# }
1621# }
1622#
1623# Arguments
1624# offset: Provide an offset to skip to a certain element in the
1625# result, for paging.
1626# limit: Specify maximum number of results to retrieve in this
1627# result. Page size.
1628instanceLoginConfigurations(offset: Int, limit: Int): LoginConfigurationList
1629
1630# Retrieve a single registration configuration
1631#
1632# Example:
1633# Request:
1634# query {
1635#
1636# registrationConfiguration(id: "12345") {
1637#
1638# slug
1639#
1640# }
1641# }
1642# Response:
1643# {
1644#
1645# "data": {
1646#
1647# "registrationConfiguration": {
1648#
1649# "slug": "test"
1650#
1651# }
1652#
1653# }
1654# }
1655#
1656# Arguments
1657# id: The registration configuration ID
1658registrationConfiguration(id: ID!): RegistrationConfiguration
1659
1660# Retrieve a single registration configuration by id:
1661#
1662# Example:
1663# Request:
1664# query {
1665#
1666# registrationConfiguration(id: "12345") {
1667#
1668# slug
1669#
1670# }
1671# }
1672# Response:
1673# {
1674#
1675# "data": {
1676#
1677# "registrationConfiguration": {
1678#
1679# "slug": "test"
1680#
1681# }
1682#
1683# }
1684# }
1685#
1686# Retrieve a registration configuration info by slug:
1687#
1688# Request:
1689# query {
1690#
1691# registrationConfigurationInfo(slug: "test") {
1692#
1693# id
1694#
1695# }
1696# }
1697# Response:
1698# {
1699#
1700# "data": {
1701#
1702# "registrationConfigurationInfo": {
1703#
1704# "id": "12345"
1705#
1706# }
1707#
1708# }
1709# }
1710#
1711# Arguments
1712# id: The registration configuration ID
1713# slug: The registration configuration url slug
1714registrationConfigurationInfo(id: ID, slug: String): RegistrationConfigurationInfo
1715
1716# Retrieve permissions
1717# Example:
1718# Request:
1719# query {
1720#
1721# permissions(limit:5) {
1722#
1723# records {
1724#
1725# id
1726#
1727# name
1728#
1729# }
1730#
1731# }
1732# }
1733#
1734# Response:
1735# {
1736#
1737# "data": {
1738#
1739# "permissions": {
1740#
1741# "records": [
1742#
1743# {
1744#
1745# "id": "2",
1746#
1747# "name": "admin.access"
1748#
1749# },
1750#
1751# {
1752#
1753# "id": "9",
1754#
1755# "name": "admin.group.create"
1756#
1757# },
1758#
1759# {
1760#
1761# "id": "12",
1762#
1763# "name": "admin.group.delete"
1764#
1765# },
1766#
1767# {
1768#
1769# "id": "10",
1770#
1771# "name": "admin.group.read"
1772#
1773# },
1774#
1775# {
1776#
1777# "id": "11",
1778#
1779# "name": "admin.group.update"
1780#
1781# }
1782#
1783# ]
1784#
1785# }
1786#
1787# }
1788# }
1789#
1790# Arguments
1791# id: Provide an ID to retrieve a single specific permission.
1792# offset: Provide an offset to skip to a certain element in the
1793# result, for paging.
1794# limit: Specify maximum number of results to retrieve in this
1795# result. Page size.
1796permissions(id: ID, name: String, offset: Int, limit: Int): PermissionList
1797
1798# Retrieve users
1799# Example:
1800# Request:
1801# query {
1802#
1803# users(
1804#
1805# organizationIds:"35521",
1806#
1807# limit: 2) {
1808#
1809# records {
1810#
1811# id
1812#
1813# name
1814#
1815# }
1816#
1817# }
1818# }
1819# Response:
1820# {
1821#
1822# "data": {
1823#
1824# "users": {
1825#
1826# "records": [
1827#
1828# {
1829#
1830# "id": "267de7e1-efb2-444a-a524-210328b78503",
1831#
1832# "name": "example"
1833#
1834# },
1835#
1836# {
1837#
1838# "id": "d8304ba1-0d4c-4268-a82c-8c62fd455066",
1839#
1840# "name": "example1"
1841#
1842# }
1843#
1844# ]
1845#
1846# }
1847#
1848# }
1849# }
1850#
1851# Arguments
1852# id: Provide an ID to retrieve a single specific user.
1853# A user ID is a string in UUID format.
1854# ids: Provide IDs to retrieve multiple users by ID.
1855# name: Provide a name, or part of one, to search by name.
1856# organizationIds: Provide a list of organization IDs to filter
1857# your search by organization.
1858# offset: Provide an offset to skip to a certain element in the
1859# result, for paging.
1860# limit: Specify maximum number of results to retrieve in this
1861# result. Page size.
1862# includeAllOrgUsers: Include all organization users.
1863# dateTimeFilter: Filter by date/time field
1864# status: Filter by account status
1865# statuses: Filter by account status list. Status field will take
1866# precedence if used
1867# roleIds: Filter by application roles
1868users(
1869id: ID,
1870ids: [ID],
1871name: String,
1872organizationIds: [ID],
1873offset: Int,
1874limit: Int,
1875includeAllOrgUsers: Boolean,
1876dateTimeFilter: [UsersDateTimeFilter!],
1877status: UserStatus,
1878statuses: [UserStatus!],
1879roleIds: [ID]
1880): UserList
1881
1882# Retrieve an individual user
1883# Example:
1884# Request:
1885# query {
1886#
1887# user(id: "267de7e1-efb2-444a-a524-210328b78503") {
1888#
1889# name
1890#
1891# status
1892#
1893# }
1894# }
1895# Response:
1896# {
1897#
1898# "data": {
1899#
1900# "user": {
1901#
1902# "name": "example",
1903#
1904# "status": "deleted"
1905#
1906# }
1907#
1908# }
1909# }
1910#
1911# Arguments
1912# id: The user ID.
1913# A user ID is a string in UUID format.
1914user(id: ID!, organizationIds: [ID]): User
1915
1916# Retrieve user's organization API tokens
1917# Example:
1918# Request:
1919# query {
1920#
1921# tokens {
1922#
1923# id
1924#
1925# applicationId
1926#
1927# }
1928# }
1929# Response:
1930# {
1931#
1932# "data": {
1933#
1934# "tokens": []
1935#
1936# }
1937# }
1938tokens: [Token]
1939
1940# Retrieve information for the current logged-in user
1941# Example:
1942# Request:
1943# query {
1944#
1945# me {
1946#
1947# id
1948#
1949# organizationId
1950#
1951# }
1952# }
1953# Response:
1954# {
1955#
1956# "data": {
1957#
1958# "me": {
1959#
1960# "id": "59cb4e74-7c31-4267-b91e-d4600bc08008",
1961#
1962# "organizationId": "35521"
1963#
1964# }
1965#
1966# }
1967# }
1968me: User
1969
1970# Retrieve groups
1971# Example:
1972# Request:
1973# query {
1974#
1975# groups {
1976#
1977# records {
1978#
1979# id
1980#
1981# name
1982#
1983# }
1984#
1985# }
1986# }
1987# Response:
1988# {
1989#
1990# "data": {
1991#
1992# "groups": {
1993#
1994# "records": [
1995#
1996# {
1997#
1998# "id": "8db639c1-c926-4f83-90de-d86c2ae5973d",
1999#
2000# "name": "WTS API Docs Org"
2001#
2002# }
2003#
2004# ]
2005#
2006# }
2007#
2008# }
2009# }
2010#
2011# Arguments
2012# id: Provide an ID to retrieve a specific group by ID
2013# ids: Provide IDs to retrieve multiple groups by ID
2014# name: Provide a name, or part of one, to search for groups by
2015# name
2016# organizationIds: "
2017# Provide a list of organization IDs to retrieve groups defined
2018# within certain organizations.
2019# offset: Provide an offset to skip to a certain element in the
2020# result, for paging.
2021# limit: Specify maximum number of results to retrieve in this
2022# result. Page size.
2023groups(id: ID, ids: [ID], name: String, organizationIds: [ID], offset: Int, limit: Int): GroupList
2024
2025# Retrieve a single mention
2026#
2027# Arguments
2028# mentionId: The mention ID
2029# limit: Comments pagination - limit
2030# offset: Comments pagination - limit
2031# userId: The user who owns the mention.
2032mention(mentionId: ID!, limit: Int, offset: Int, userId: String): Mention
2033
2034# Retrieve a shared mention
2035#
2036# Arguments
2037# shareId: share token
2038sharedMention(shareId: ID!): SharedMention
2039
2040# Search for mentions across an index.
2041# This query requires a user token.
2042# Known Issues:
2043# - Offset can not go past 10,000. To get around this, the best practice is to
2044# keep updating the start time of the query based on the last mention you have
2045# processed.
2046# Example:
2047# Request:
2048# query{
2049#
2050# searchMentions(search:{
2051#
2052# offset: 0
2053#
2054# limit: 1
2055#
2056# index: ["mine"]
2057#
2058# query:{
2059#
2060# operator: "and"
2061#
2062# conditions: [{
2063#
2064# operator: "term"
2065#
2066# field: "trackingUnitName"
2067#
2068# value: "Dallas Cowboys Super Bowl"
2069#
2070# },
2071#
2072# {
2073#
2074# operator: "term"
2075#
2076# field: "mentionStatusId"
2077#
2078# value: "1"
2079#
2080# }]
2081#
2082# }
2083#
2084# }) {
2085#
2086# jsondata
2087#
2088# }
2089# }
2090# Response:
2091# {
2092#
2093# "data": {
2094#
2095# "searchMentions": {
2096#
2097# "jsondata": {
2098#
2099# "results": [
2100#
2101# {
2102#
2103# "id": 47569938,
2104#
2105# "programFormatName": "Information and News",
2106#
2107# "mentionDate": "2017-01-31T07:59:18.000Z",
2108#
2109# "mediaStartTime": "2017-01-31T07:45:01.000Z",
2110#
2111# "mediaId": 20017455,
2112#
2113# "metadata": {
2114#
2115# "filename": "AM-RADIO",
2116#
2117# "veritone-file": {
2118#
2119# "size": 0,
2120#
2121# "filename": "AM-RADIO",
2122#
2123# "mimetype": "audio/mpeg"
2124#
2125# },
2126#
2127# "veritone-media-source": {
2128#
2129# "mediaSourceId": "14326",
2130#
2131# "mediaSourceTypeId": "1"
2132#
2133# },
2134#
2135# "veritone-program": {
2136#
2137# "programId": "3828",
2138#
2139# "programName": "AM-RADIO Morning Talk",
2140#
2141# "programImage":
2142# "https://s3.amazonaws.com/prod-veritone-ugc/cb5e59d4-a986-4e2b-b525-482319df3350%2FbrdProgram%2F2uGsLVKsQeiKN3UuHufC_941478_10151455644772706_951533539_n.jpg",
2143#
2144# "programLiveImage":
2145# "https://s3.amazonaws.com/prod-veritone-ugc/cb5e59d4-a986-4e2b-b525-482319df3350%2FbrdProgram%2FwwEn3Ya9RgmMQwUEGoD1_LUkKlgZQS36ncUbY8Iz7_2520to%2520live2.JPG"
2146#
2147# }
2148#
2149# },
2150#
2151# "fileLocation":
2152# "https://inspirent.s3.amazonaws.com/recordings/9605ea97-87df-428e-6740-720df8b8691c_original.mp3?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAI7L6G7PCOOOLA7MQ%2F20171215%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20171215T205111Z&X-Amz-Expires=604800&X-Amz-Signature=00f62a6e2367c109320c98b9aea190cd28d82ac347eeeca030f42810b7ab75e3&X-Amz-SignedHeaders=host",
2153#
2154# "fileType": "audio/mpeg",
2155#
2156# "snippets": [
2157#
2158# {
2159#
2160# "startTime": 857.62,
2161#
2162# "endTime": 887.33,
2163#
2164# "text": "eighty first women's Australian Open final Monica Seles beat Steffi
2165# Graf four six six three six two in one thousand nine hundred twenty eight the
2166# Dallas Cowboys beat the Buffalo Bills thirty to thirteen in Atlanta running back
2167# Emmitt Smith wins the M.V.P. and fourth consecutive Super Bowl game loss to the
2168# Cowboys twenty sixteen at the one hundred fourth women's Australian Open final
2169# six three six six four that time capsule your",
2170#
2171# "hits": [
2172#
2173# {
2174#
2175# "startTime": 865.7,
2176#
2177# "endTime": 865.929,
2178#
2179# "queryTerm": "Dallas"
2180#
2181# },
2182#
2183# {
2184#
2185# "startTime": 865.93,
2186#
2187# "endTime": 866.07,
2188#
2189# "queryTerm": "Cowboys"
2190#
2191# },
2192#
2193# {
2194#
2195# "startTime": 872.74,
2196#
2197# "endTime": 873.31,
2198#
2199# "queryTerm": "Super"
2200#
2201# },
2202#
2203# {
2204#
2205# "startTime": 873.31,
2206#
2207# "endTime": 873.43,
2208#
2209# "queryTerm": "Bowl"
2210#
2211# }
2212#
2213# ]
2214#
2215# }
2216#
2217# ],
2218#
2219# "userSnippets": null,
2220#
2221# "advertiserId": 0,
2222#
2223# "advertiserName": "",
2224#
2225# "brandId": 0,
2226#
2227# "brandImage": "",
2228#
2229# "brandName": "",
2230#
2231# "campaignId": 0,
2232#
2233# "campaignName": "",
2234#
2235# "organizationId": 7295,
2236#
2237# "organizationName": "Demo Organization",
2238#
2239# "trackingUnitId": 10032,
2240#
2241# "trackingUnitName": "Dallas Cowboys Super Bowl",
2242#
2243# "mentionStatusId": 1,
2244#
2245# "mediaSourceTypeId": 1,
2246#
2247# "mediaSourceTypeName": "Audio",
2248#
2249# "mediaSourceId": 14326,
2250#
2251# "mediaSourceName": "AM-RADIO Morning Talk",
2252#
2253# "isNational": true,
2254#
2255# "spotTypeId": null,
2256#
2257# "spotTypeName": null,
2258#
2259# "programId": 3828,
2260#
2261# "programName": "AM-RADIO",
2262#
2263# "programImage":
2264# "https://s3.amazonaws.com/prod-veritone-ugc/cb5e59d4-a986-4e2b-b525-482319df3350%2FbrdProgram%2F2uGsLVKsQeiKN3UuHufC_941478_10151455644772706_951533539_n.jpg",
2265#
2266# "programLiveImage":
2267# "https://s3.amazonaws.com/prod-veritone-ugc/cb5e52b4-a986-4e2b-b525-482319df3350%2FbrdProgram%2FwwEn3Ya9RgmMQwUEGoD1_LUkKlgZQS36ncUbY8Iz7_2520to%2520live2.JPG",
2268#
2269# "impressions": 1894,
2270#
2271# "audience": [
2272#
2273# {
2274#
2275# "gender": "men",
2276#
2277# "age_group": "35-44",
2278#
2279# "audience": 11,
2280#
2281# "isTargetMatch": true
2282#
2283# },
2284#
2285# {
2286#
2287# "gender": "men",
2288#
2289# "age_group": "45-49",
2290#
2291# "audience": 121,
2292#
2293# "isTargetMatch": true
2294#
2295# },
2296#
2297# {
2298#
2299# "gender": "men",
2300#
2301# "age_group": "50-54",
2302#
2303# "audience": 474,
2304#
2305# "isTargetMatch": true
2306#
2307# },
2308#
2309# {
2310#
2311# "gender": "men",
2312#
2313# "age_group": "65+",
2314#
2315# "audience": 95,
2316#
2317# "isTargetMatch": true
2318#
2319# },
2320#
2321# {
2322#
2323# "gender": "women",
2324#
2325# "age_group": "50-54",
2326#
2327# "audience": 19,
2328#
2329# "isTargetMatch": false
2330#
2331# },
2332#
2333# {
2334#
2335# "gender": "women",
2336#
2337# "age_group": "65+",
2338#
2339# "audience": 693,
2340#
2341# "isTargetMatch": false
2342#
2343# },
2344#
2345# {
2346#
2347# "gender": "men",
2348#
2349# "age_group": "55-64",
2350#
2351# "audience": 481,
2352#
2353# "isTargetMatch": true
2354#
2355# }
2356#
2357# ],
2358#
2359# "targetAudience": {
2360#
2361# "gender": 1,
2362#
2363# "genderName": "M",
2364#
2365# "ageGroup": [
2366#
2367# 0,
2368#
2369# 5
2370#
2371# ],
2372#
2373# "ageGroupMin": 18,
2374#
2375# "ageGroupMax": 0,
2376#
2377# "impressions": 1182
2378#
2379# },
2380#
2381# "audienceMarketCount": 3,
2382#
2383# "audienceAffiliateCount": 1,
2384#
2385# "rating": null,
2386#
2387# "ratings": null,
2388#
2389# "comments": null,
2390#
2391# "markets": [
2392#
2393# {
2394#
2395# "marketId": 54,
2396#
2397# "marketName": "Des Moines-Ames, IA"
2398#
2399# }
2400#
2401# ],
2402#
2403# "marketId": null,
2404#
2405# "marketName": null,
2406#
2407# "hourOfDay": 7,
2408#
2409# "dayOfWeek": 2,
2410#
2411# "dayOfMonth": 31,
2412#
2413# "month": 1,
2414#
2415# "year": 2017,
2416#
2417# "isMatch": true,
2418#
2419# "mentionStatusName": "Pending Verification",
2420#
2421# "complianceStatusId": null,
2422#
2423# "cognitiveEngineResults": null,
2424#
2425# "hits": 4
2426#
2427# }
2428#
2429# ],
2430#
2431# "totalResults": 579,
2432#
2433# "limit": 1,
2434#
2435# "from": 0,
2436#
2437# "to": 0,
2438#
2439# "searchToken": "ae882400-e1d9-11e7-947b-339cddca931e",
2440#
2441# "timestamp": 1513371071
2442#
2443# }
2444#
2445# }
2446#
2447# }
2448# }
2449#
2450# Arguments
2451# search: JSON structure containing the search query.
2452# See https://docs.veritone.com/#/apis/search-quickstart for full details on the
2453# search query syntax
2454searchMentions(search: JSONData!): SearchResult
2455
2456# Search for media across an index.
2457# This query requires a user token.
2458# Example:
2459# Request:
2460# query{
2461#
2462# searchMedia(search:{
2463#
2464# offset: 0
2465#
2466# limit: 1
2467#
2468# index: ["mine"]
2469#
2470# query:{
2471#
2472# operator: "query_string"
2473#
2474# field: "transcript.transcript"
2475#
2476# value: "paris NOT \"las vegas\""
2477#
2478# }
2479#
2480# }) {
2481#
2482# jsondata
2483#
2484# }
2485# }
2486# Response:
2487# {
2488#
2489# "data": {
2490#
2491# "searchMedia": {
2492#
2493# "jsondata": {
2494#
2495# "results": [
2496#
2497# {
2498#
2499# "recording": {
2500#
2501# "recordingId": "43033727",
2502#
2503# "fileLocation":
2504# "https://inspirent.s3.amazonaws.com/assets/43033727/ea9d9845-775b-48cd-aada-16fa56894ba0.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAI7L6G7PCOOOLA7MQ%2F20171215%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20171215T181255Z&X-Amz-Expires=604800&X-Amz-Signature=2fd918d5ac20979bd27d365bfa455904cf1726307fddbd362a28a8bd9a0a81a8&X-Amz-SignedHeaders=host",
2505#
2506# "fileType": "video/mp4",
2507#
2508# "programId": "-1",
2509#
2510# "programName": "Weekly Talkshow",
2511#
2512# "programLiveImage":
2513# "https://inspirent.s3.amazonaws.com/assets/43033727/fe693b30-18ae-47c7-984f-530eab61d7.jpeg",
2514#
2515# "mediaSourceId": "-1",
2516#
2517# "mediaSourceTypeId": "5",
2518#
2519# "sliceTime": 1512682022,
2520#
2521# "mediaStartTime": 1512681992,
2522#
2523# "aibDuration": 90,
2524#
2525# "isOwn": true,
2526#
2527# "hitStartTime": 1512682022,
2528#
2529# "hitEndTime": 1512682082
2530#
2531# },
2532#
2533# "startDateTime": 1512682022,
2534#
2535# "stopDateTime": 1512682082,
2536#
2537# "hits": [
2538#
2539# {
2540#
2541# "veritone-file": {
2542#
2543# "filename": "Veritone_v06.mp4",
2544#
2545# "mimetype": "video/mp4",
2546#
2547# "size": 162533502
2548#
2549# }
2550#
2551# }
2552#
2553# ]
2554#
2555# }
2556#
2557# ],
2558#
2559# "totalResults": 733275,
2560#
2561# "limit": 1,
2562#
2563# "from": 0,
2564#
2565# "to": 0,
2566#
2567# "searchToken": "930f0960-e1c3-11e7-9e94-eba5f6b5faf7",
2568#
2569# "timestamp": 1513361576
2570#
2571# }
2572#
2573# }
2574#
2575# }
2576# }
2577#
2578# Arguments
2579# search: JSON structure containing the search query.
2580# See https://docs.veritone.com/#/apis/search-quickstart for full details on the
2581# search query syntax
2582searchMedia(search: JSONData!): SearchResult
2583
2584# Retrieve the root folders for an organization
2585# Example:
2586# Request:
2587# query {
2588#
2589# rootFolders {
2590#
2591# id
2592#
2593# typeId
2594#
2595# }
2596# }
2597# Response:
2598# {
2599#
2600# "data": {
2601#
2602# "rootFolders": [
2603#
2604# {
2605#
2606# "id": "2ac28573-917a-4c4b-be91-a0ac64cbc982",
2607#
2608# "typeId": 4
2609#
2610# },
2611#
2612# {
2613#
2614# "id": "d3e27eb3-7d4a-47ab-af64-bf1529390f4e",
2615#
2616# "typeId": 4
2617#
2618# }
2619#
2620# ]
2621#
2622# }
2623# }
2624#
2625# Arguments
2626# type: The type of root folder to retrieve
2627rootFolders(type: RootFolderType): [Folder]
2628
2629# Retrieve a single folder. Used to navigate the folder tree structure.
2630# Example:
2631# Request:
2632# query {
2633#
2634# folder(id: "2ac28573-917a-4c4b-be91-a0ac64cbc982") {
2635#
2636# typeId
2637#
2638# id
2639#
2640# childFolders{
2641#
2642# records{
2643#
2644# id
2645#
2646# }
2647#
2648# }
2649#
2650# }
2651# }
2652# Response:
2653# {
2654#
2655# "data": {
2656#
2657# "folder": {
2658#
2659# "typeId": 4,
2660#
2661# "id": "3104f61f-4bd1-4175-9fe6-27436d591c54",
2662#
2663# "childFolders": {
2664#
2665# "records": [
2666#
2667# {
2668#
2669# "id": "9d639f1b-a0d4-47b0-8149-3568f048f320"
2670#
2671# },
2672#
2673# {
2674#
2675# "id": "a347319d-72da-43a2-93fc-e677876aca80"
2676#
2677# }
2678#
2679# ]
2680#
2681# }
2682#
2683# }
2684#
2685# }
2686# }
2687#
2688# Arguments
2689# id: Provide an ID to retrieve a single specific user.
2690folder(id: ID!): Folder
2691
2692# Retrieve the current platform information.
2693# Example:
2694# Request:
2695# query {
2696#
2697# platformInfo {
2698#
2699# properties
2700#
2701# aiWAREVersion {
2702#
2703# currentVersion {
2704#
2705# version
2706#
2707# }
2708#
2709# previousVersion {
2710#
2711# version
2712#
2713# }
2714#
2715# nextVersion {
2716#
2717# version
2718#
2719# }
2720#
2721# }
2722#
2723# aiWAREVersionHistory(offset: 0, limit: 30) {
2724#
2725# platformVersion {
2726#
2727# id
2728#
2729# version
2730#
2731# }
2732#
2733# id
2734#
2735# },
2736#
2737# aiWAREVersionList (orderBy: version, orderDirection: desc) {
2738#
2739# count
2740#
2741# records {
2742#
2743# id
2744#
2745# version
2746#
2747# }
2748#
2749# }
2750#
2751# }
2752# }
2753# Response:
2754# {
2755#
2756# "data": {
2757#
2758# "platformInfo": {
2759#
2760# "properties": {
2761#
2762# "Environment": "US West",
2763#
2764# "ClusterSize": "small"
2765#
2766# }
2767#
2768# "aiWAREVersion": {
2769#
2770# "currentVersion": {
2771#
2772# "version": "1.1.0"
2773#
2774# },
2775#
2776# "previousVersion": {
2777#
2778# "version": "1.0.0"
2779#
2780# },
2781#
2782# "nextVersion": {
2783#
2784# "version": "1.2.0"
2785#
2786# }
2787#
2788# },
2789#
2790# "aiWAREVersionHistory": [
2791#
2792# {
2793#
2794# platformVersion:
2795#
2796# {
2797#
2798# "id": "c7a91281-6a1e-46d4-9f2c-7f8b4a1fc493",
2799#
2800# "version": "1.3.0"
2801#
2802# },
2803#
2804# "id": "30c9c2a2-ae6a-4be2-b80c-6893d8b56780"
2805#
2806# },
2807#
2808# {
2809#
2810# platformVersion:
2811#
2812# {
2813#
2814# "id": "f785bc56-2d43-472e-8629-99f9b9a5c57e",
2815#
2816# "version": "1.3.0"
2817#
2818# },
2819#
2820# "id": "7b8a2ab2-00de-4f1b-9fb1-99e7a9cd108f"
2821#
2822# },
2823#
2824# {
2825#
2826# platformVersion:
2827#
2828# {
2829#
2830# "id": "3c4c0b46-1a61-45ab-9f3e-b8f7a14bfaa7",
2831#
2832# "version": "1.3.0"
2833#
2834# },
2835#
2836# "id": "d3499a78-efc7-4a72-a12d-852f53231e33"
2837#
2838# }
2839#
2840# ],
2841#
2842# "aiWAREVersionList": {
2843#
2844# "count": 3,
2845#
2846# "records": [
2847#
2848# {
2849#
2850# "id": "799150bb-8d67-4cd1-b204-d9346e012588",
2851#
2852# "version": "1.0.11"
2853#
2854# },
2855#
2856# {
2857#
2858# "id": "2892e80d-e0bf-4ffc-be17-4bb173d6ad29",
2859#
2860# "version": "1.0.2"
2861#
2862# },
2863#
2864# {
2865#
2866# "id": "095b9558-6fc1-4775-9696-082b9f098c47",
2867#
2868# "version": "1.0.1"
2869#
2870# },
2871#
2872# ]
2873#
2874# }
2875#
2876# }
2877#
2878# }
2879# }
2880platformInfo: PlatformInfo!
2881
2882# Example:
2883# Request:
2884# query {
2885#
2886# auditEvents(limit: 2) {
2887#
2888# records {
2889#
2890# id
2891#
2892# application
2893#
2894# }
2895#
2896# }
2897# }
2898# Response:
2899# {
2900#
2901# "data": {
2902#
2903# "auditEvents": {
2904#
2905# "records": [
2906#
2907# {
2908#
2909# "id": "fdc7b3a3-ab23-4866-a330-c0ad910cd64f",
2910#
2911# "application": ""
2912#
2913# }
2914#
2915# ]
2916#
2917# }
2918#
2919# }
2920# }
2921#
2922# Arguments
2923# query: An elastic query for audit events
2924# application: Filter logs by a specific application
2925# terms: Term filters to filter documents by properties in the
2926# payload
2927auditEvents(
2928query: JSONData,
2929orderDirection: OrderDirection,
2930application: String,
2931terms: [JSONData!],
2932limit: Int,
2933offset: Int
2934): AuditEventList!
2935
2936# Retrieve a folder overview
2937# Example:
2938# Request:
2939# query {
2940#
2941# folderOverview(ids:"3104f61f-4bd1-4175-9fe6-27436d591c54") {
2942#
2943# childFoldersCount
2944#
2945# childNonFolderObjectsCount
2946#
2947# }
2948# }
2949# Response:
2950# {
2951#
2952# "data": {
2953#
2954# "folderOverview": {
2955#
2956# "childFoldersCount": 3,
2957#
2958# "childNonFolderObjectsCount": 0
2959#
2960# }
2961#
2962# }
2963# }
2964#
2965# Arguments
2966# ids: Tree Object Ids
2967folderOverview(ids: [ID!]!, rootFolderType: RootFolderType): FolderOverview
2968
2969# Example:
2970# Request:
2971# query {
2972#
2973# folderSummaryDetails(ids: "3104f61f-4bd1-4175-9fe6-27436d591c54") {
2974#
2975# id
2976#
2977# typeId
2978#
2979# }
2980# }
2981# Response:
2982# {
2983#
2984# "data": {
2985#
2986# "folderSummaryDetails": [
2987#
2988# {
2989#
2990# "id": "1580701928",
2991#
2992# "typeId": 5
2993#
2994# },
2995#
2996# {
2997#
2998# "id": "1580388995",
2999#
3000# "typeId": 5
3001#
3002# },
3003#
3004# {
3005#
3006# "id": "2ac28573-917a-4c4b-be91-a0ac64cbc982",
3007#
3008# "typeId": 4
3009#
3010# },
3011#
3012# {
3013#
3014# "id": "243625",
3015#
3016# "typeId": 3
3017#
3018# },
3019#
3020# {
3021#
3022# "id": "242599",
3023#
3024# "typeId": 3
3025#
3026# },
3027#
3028# {
3029#
3030# "id": "d551fbd6-7354-4b0e-abfb-654ab8583be2",
3031#
3032# "typeId": 1
3033#
3034# },
3035#
3036# {
3037#
3038# "id": "a347319d-72da-43a2-93fc-e677876aca80",
3039#
3040# "typeId": 1
3041#
3042# },
3043#
3044# {
3045#
3046# "id": "9d639f1b-a0d4-47b0-8149-3568f048f320",
3047#
3048# "typeId": 1
3049#
3050# }
3051#
3052# ]
3053#
3054# }
3055# }
3056#
3057# Arguments
3058# ids: Tree Object Ids
3059folderSummaryDetails(
3060ids: [ID!]!,
3061rootFolderType: RootFolderType
3062): [FolderSummaryDetail]
3063
3064# Retrieve configs for a given application
3065# Example:
3066# Request:
3067# query {
3068#
3069# applicationConfig(applicationId: "47bd3e25-f4ea-435f-b69b-13cb4f9dd60a") {
3070#
3071# records: {
3072#
3073# configType
3074#
3075# configLevel
3076#
3077# }
3078#
3079# offset: 0
3080#
3081# limit: 1
3082#
3083# }
3084# }
3085# Response:
3086# {
3087#
3088# "data": {
3089#
3090# "applicationConfig": {
3091#
3092# "records": {
3093#
3094# "configType": "String",
3095#
3096# "configLevel": "Organization"
3097#
3098# }
3099#
3100# }
3101#
3102# }
3103# }
3104#
3105# Arguments
3106# orgId: Optional. Organization ID.
3107#
3108# If not specified, this will be the user's organization
3109# userId: Optional. If specified, returned the configs for this
3110# user and organization combo
3111# includeDefaults: If true, include defaults not specified
3112# configKeyRegexp: If specified, filter the configKey
3113# offset: Specify maximum number of results to retrieve in this
3114# result. Page size.
3115# limit: Specify maximum number of results to retrieve in this
3116# result.
3117applicationConfig(
3118appId: ID!,
3119orgId: ID,
3120userId: ID,
3121includeDefaults: Boolean,
3122configKeyRegexp: String,
3123offset: Int,
3124limit: Int
3125): ApplicationConfigList!
3126
3127# Retrieve config definitions for a given application
3128# Example:
3129# Request:
3130# query {
3131#
3132# applicationConfigDefinition(applicationId:
3133# "47bd3e25-f4ea-435f-b69b-13cb4f9dd60a", configKey: 'dark mode') {
3134#
3135# records: {
3136#
3137# configType
3138#
3139# defaultValue
3140#
3141# }
3142#
3143# offset: 0
3144#
3145# limit: 1
3146#
3147# }
3148# }
3149# Response:
3150# {
3151#
3152# "data": {
3153#
3154# "applicationConfigDefinition": {
3155#
3156# "records": [{
3157#
3158# "configType": Boolean,
3159#
3160# "defaultValue": true,
3161#
3162# }]
3163#
3164# }
3165#
3166# }
3167# }
3168#
3169# Arguments
3170# configKey: If specified, grab definition for this config key
3171# offset: Specify maximum number of results to retrieve in this
3172# result. Page size.
3173# limit: Specify maximum number of results to retrieve in this
3174# result.
3175applicationConfigDefinition(
3176appId: ID!,
3177configKey: String,
3178offset: Int,
3179limit: Int
3180): ApplicationConfigDefinitionList!
3181
3182# Retrieve a single application
3183# Example:
3184# Request:
3185# query {
3186#
3187# application(id: "47bd3e25-f4ea-435f-b69b-13cb4f9dd60a") {
3188#
3189# name
3190#
3191# key
3192#
3193# }
3194# }
3195# Response:
3196# {
3197#
3198# "data": {
3199#
3200# "application": {
3201#
3202# "name": "appexamplebill",
3203#
3204# "key": "appexamplebill"
3205#
3206# }
3207#
3208# }
3209# }
3210#
3211# Arguments
3212# id: The application ID
3213# excludeViewOnly: Only retrieve package grantType=VIEW when
3214# explicitly enter false
3215application(id: ID!, excludeViewOnly: Boolean): Application
3216
3217# Retrieve headerbar information for an application
3218# Example:
3219# Request:
3220# query {
3221#
3222# applicationHeaderbar(id: "47bd3e25-f4ea-435f-b69b-13cb4f9dd60a") {
3223#
3224# name
3225#
3226# config {
3227#
3228# title
3229#
3230# }
3231#
3232# }
3233# }
3234# Response:
3235# {
3236#
3237# "data": {
3238#
3239# "applicationHeaderbar": {
3240#
3241# "name": "APP_BAR",
3242#
3243# "config": {
3244#
3245# "title": "Library"
3246#
3247# }
3248#
3249# }
3250#
3251# }
3252# }
3253#
3254# Arguments
3255# appId: The application ID
3256# orgId: Optional organization ID. Normally this value is
3257# computed by the server
3258# based on the authorization token used for the request.
3259applicationHeaderbar(appId: ID!, orgId: ID): ApplicationHeaderbar
3260
3261# Retrieve a list of schemas for structured data ingestions\
3262# Example:
3263# Request:
3264# query {
3265#
3266# schemas(limit: 2) {
3267#
3268# records {
3269#
3270# id
3271#
3272# organizationId
3273#
3274# }
3275#
3276# }
3277# }
3278# Response:
3279# {
3280#
3281# "data": {
3282#
3283# "schemas": {
3284#
3285# "records": [
3286#
3287# {
3288#
3289# "id": "21a08123-45dc-497e-b329-360d9f3fcaac",
3290#
3291# "organizationId": "35521"
3292#
3293# },
3294#
3295# {
3296#
3297# "id": "57aa1618-344d-4d35-9980-5fe1ec6c3112",
3298#
3299# "organizationId": "35521"
3300#
3301# }
3302#
3303# ]
3304#
3305# }
3306#
3307# }
3308# }
3309#
3310# Arguments
3311# id: Id of a schema to retrieve
3312# ids: Ids of schemas to retrieve
3313# dataRegistryId: Specify the id of the DataRegistry to get
3314# schemas
3315# status: Specify one or more statuses to filter by schema status
3316# majorVersion: Specify a major version to filter schemas
3317# name: Specify a data registry name to filter schemas
3318# nameMatch: The strategy used to find data registry name
3319# accessScope: Specify one or more access scopes to filter by
3320# accessible schemas
3321# limit: Limit
3322# offset: Offset
3323# orderBy: Specify one or more fields and direction to order
3324# results
3325schemas(
3326id: ID,
3327ids: [ID!],
3328dataRegistryId: ID,
3329status: [SchemaStatus!],
3330majorVersion: Int,
3331name: String,
3332nameMatch: StringMatch,
3333accessScope: [AccessScope!],
3334limit: Int,
3335offset: Int,
3336orderBy: [SchemaOrder]
3337): SchemaList
3338
3339# Retrieve a schema for structured data ingestions
3340# Example:
3341# Request:
3342# query {
3343#
3344# schema(id: "21a08123-45dc-497e-b329-360d9f3fcaac") {
3345#
3346# definition
3347#
3348# status
3349#
3350# }
3351# }
3352# Response:
3353# {
3354#
3355# "data": {
3356#
3357# "schema": {
3358#
3359# "definition": {
3360#
3361# "example": "example value"
3362#
3363# },
3364#
3365# "status": "draft"
3366#
3367# }
3368#
3369# }
3370# }
3371#
3372# Arguments
3373# id: Supply the ID of the schema to retrieve
3374schema(id: ID!): Schema
3375
3376# Example:
3377# Request:
3378# query {
3379#
3380# schemaProperties(limit: 2) {
3381#
3382# records {
3383#
3384# type
3385#
3386# dataRegistryId
3387#
3388# }
3389#
3390# }
3391# }
3392# Response:
3393# {
3394#
3395# "data": {
3396#
3397# "schemaProperties": {
3398#
3399# "records": [
3400#
3401# {
3402#
3403# "type": "string",
3404#
3405# "dataRegistryId": "c3c9fa66-15b2-4bc4-b37f-c790e3ea0db6"
3406#
3407# },
3408#
3409# {
3410#
3411# "type": "string",
3412#
3413# "dataRegistryId": "dbfa78af-f935-4ace-8a70-f70ca36ce49c"
3414#
3415# }
3416#
3417# ]
3418#
3419# }
3420#
3421# }
3422# }
3423#
3424# Arguments
3425# limit: Limit
3426# offset: Offset
3427schemaProperties(
3428dataRegistryVersion: [DataRegistryVersion!],
3429search: String,
3430limit: Int,
3431offset: Int
3432): SchemaPropertyList
3433
3434# Retrieve a structured data object
3435# Example:
3436# Request:
3437# query {
3438#
3439# structuredData(
3440#
3441# id: "bbc0d388-b7ed-4073-9760-cb7701130eaf",
3442#
3443# schemaId: "acab8bd9-a4d4-44de-ad4b-cc949d696cf9") {
3444#
3445# data
3446#
3447# }
3448# }
3449# Response:
3450# {
3451#
3452# "data": {
3453#
3454# "structuredData": {
3455#
3456# "data": {
3457#
3458# "example": "example"
3459#
3460# }
3461#
3462# }
3463#
3464# }
3465# }
3466#
3467# Arguments
3468# id: Supply the ID of the structured data object to retrieve.
3469# This will override filters.
3470# schemaId: Schema Id for the structured data object to retrieve
3471structuredData(id: ID!, schemaId: ID!): StructuredData
3472
3473# Retrieve a structured data object
3474# Example:
3475# Request:
3476# query {
3477#
3478# structuredDataObject(
3479#
3480# id: "bbc0d388-b7ed-4073-9760-cb7701130eaf",
3481#
3482# schemaId: "acab8bd9-a4d4-44de-ad4b-cc949d696cf9") {
3483#
3484# data
3485#
3486# }
3487# }
3488# Response:
3489# {
3490#
3491# "data": {
3492#
3493# "structuredDataObject": {
3494#
3495# "data": {
3496#
3497# "example": "example"
3498#
3499# }
3500#
3501# }
3502#
3503# }
3504# }
3505#
3506# Arguments
3507# id: Supply the ID of the structured data object to retrieve.
3508# This will override filters.
3509# schemaId: Schema Id for the structured data object to retrieve
3510structuredDataObject(id: ID!, schemaId: ID!): StructuredData
3511
3512# Retrieve a paginated list of structured data object
3513# Example:
3514# Request:
3515# query {
3516#
3517# structuredDataObjects(schemaId: "acab8bd9-a4d4-44de-ad4b-cc949d696cf9") {
3518#
3519# records {
3520#
3521# id
3522#
3523# data
3524#
3525# }
3526#
3527# }
3528# }
3529# Response:
3530# {
3531#
3532# "data": {
3533#
3534# "structuredDataObjects": {
3535#
3536# "records": [
3537#
3538# {
3539#
3540# "id": "bbc0d388-b7ed-4073-9760-cb7701130eaf",
3541#
3542# "data": {
3543#
3544# "example": "example"
3545#
3546# }
3547#
3548# },
3549#
3550# {
3551#
3552# "id": "f914eafe-ed9b-46b1-a48d-effd5575764a",
3553#
3554# "data": {
3555#
3556# "example": "example"
3557#
3558# }
3559#
3560# }
3561#
3562# ]
3563#
3564# }
3565#
3566# }
3567# }
3568#
3569# Arguments
3570# id: Supply the ID of the structured data object to retrieve.
3571# This will override filters.
3572# ids: List of Ids of the structured data objects to retrieve.
3573# This will override filters.
3574# schemaId: Schema Id for the structured data object to retrieve
3575# filter: Passing id or ids argument will override the filter.
3576# Any field in the SDO's data column can be used as a filter with 'exact match'
3577# comparison.
3578# E.g.:
3579#
3580# filter: {
3581#
3582# name: "This is an example"
3583#
3584# }
3585structuredDataObjects(
3586id: ID,
3587ids: [ID!],
3588schemaId: ID!,
3589orderBy: [StructuredDataOrderBy!],
3590limit: Int,
3591offset: Int,
3592owned: Boolean,
3593filter: JSONData,
3594dateTimeFilter: SdoDateTimeFilter
3595): StructuredDataList
3596
3597# Returns information about the GraphQL server, useful
3598# for diagnostics. This data is primarily used by Veritone
3599# development, and some fields may be restricted to Veritone administrators.
3600graphqlServiceInfo: GraphQLServiceInfo
3601
3602# Returns a signed writable S3 URL. A client can then
3603# upload to this URL with an HTTP PUT without providing
3604# any additional authorization (_note_: it must be a PUT.
3605# A POST will fail.)
3606# Example:
3607# Request:
3608# query {
3609#
3610# getSignedWritableUrl(type: "preview") {
3611#
3612# bucket
3613#
3614# key
3615#
3616# url
3617#
3618# }
3619# }
3620# Response:
3621# {
3622#
3623# "data": {
3624#
3625# "getSignedWritableUrl": {
3626#
3627# "bucket": "prod-api.veritone.com",
3628#
3629# "key":
3630# "35521/preview/2021/5/5/_/19-50-374_ed2c10a7-6f96-4d7c-a498-7bedeb383c7e",
3631#
3632# "url":
3633# "https://s3.amazonaws.com/prod-api.veritone.com/35521/preview/2021/5/5/_/19-50-374_ed2c10a7-6f96-4d7c-a498-7bedeb383c7e?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAQMR5VATUHU3MEGOA%2F20210618%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210618T194850Z&X-Amz-Expires=86400&X-Amz-Signature=44857350a7f0b7311d4b911b557f4171a6ffe126c76e3d26f6e5cd532f645e53&X-Amz-SignedHeaders=host"
3634#
3635# }
3636#
3637# }
3638# }
3639#
3640# Arguments
3641# key: Optional key of the object to generate a writable
3642# URL for. If not provided, a new, unique key will
3643# be generated. If a key is provided and resembles a file name
3644# (with extension delimited by .), a UUID will be inserted
3645# into the file name, leaving the extension intact.
3646# If a key is provided and does not resemble
3647# a file name, a UUID will be appended.
3648# type: Optional type of resource, such as `asset`, `thumbnail`,
3649# `discovery-analytics` or `preview`
3650# path: Optional extended path information. If the uploaded
3651# content will be contained
3652# within a container such as a `TemporalDataObject` (for `asset`) or `Library`
3653# (for `entityIdentifier`), the ID of the object should be provided here.
3654# expiresInSeconds: Optional expiresInSeconds custom expiration
3655# to signedUrlExpires
3656# Max expiresInSeconds up to 604800
3657# organizationId: Optional organization ID. Normally this value
3658# is computed by the server
3659# based on the authorization token used for the request.
3660# Is is used only by Veritone platform components.
3661getSignedWritableUrl(
3662key: String,
3663type: String,
3664path: String,
3665expiresInSeconds: Int,
3666organizationId: ID
3667): WritableUrlInfo
3668
3669# Return writable storage URLs in bulk.
3670# A maximum of 1000 can be created in one call.
3671# See `getSignedWritableUrl` for details on usage of the
3672# response contents.
3673# Example:
3674# Request:
3675# query {
3676#
3677# getSignedWritableUrls(number: 2) {
3678#
3679# bucket
3680#
3681# key
3682#
3683# url
3684#
3685# }
3686# }
3687# Response:
3688# {
3689#
3690# "data": {
3691#
3692# "getSignedWritableUrls": [
3693#
3694# {
3695#
3696# "bucket": "prod-api.veritone.com",
3697#
3698# "key": "35521/other/2021/5/5/_/19-19-384_723ca284-cee6-4883-af16-edcbfed86433",
3699#
3700# "url":
3701# "https://s3.amazonaws.com/prod-api.veritone.com/35521/other/2021/5/5/_/19-19-384_723ca284-cee6-4883-af16-edcbfed86433?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAQMR5VATUHU3MEGOA%2F20210618%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210618T194919Z&X-Amz-Expires=86400&X-Amz-Signature=57c8d9046297e6d6839d19e7d22552618e9ff89dd4855ca7f7aceb26e89d3de4&X-Amz-SignedHeaders=host"
3702#
3703# },
3704#
3705# {
3706#
3707# "bucket": "prod-api.veritone.com",
3708#
3709# "key": "35521/other/2021/5/6/_/19-19-384_76af4aeb-5d9b-4bc4-b1d0-251e3f57b651",
3710#
3711# "url":
3712# "https://s3.amazonaws.com/prod-api.veritone.com/35521/other/2021/5/6/_/19-19-384_76af4aeb-5d9b-4bc4-b1d0-251e3f57b651?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAQMR5VATUHU3MEGOA%2F20210618%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210618T194919Z&X-Amz-Expires=86400&X-Amz-Signature=9e139df517ca85fa0b969f0d3ff55b890b8a5e199c4fa7b3a26ea2f12a65bfec&X-Amz-SignedHeaders=host"
3713#
3714# }
3715#
3716# ]
3717#
3718# }
3719# }
3720#
3721# Arguments
3722# number: Number of signed URLs to return
3723# type: Optional type of resource, such as `asset`, `thumbnail`,
3724# or `preview`
3725# path: Optional extended path information. If the uploaded
3726# content will be contained
3727# within a container such as a `TemporalDataObject` (for `asset`) or `Library`
3728# (for `entityIdentifier`), the ID of the object should be provided here.
3729# organizationId: Optional organization ID. Normally this value
3730# is computed by the server
3731# based on the authorization token used for the request.
3732# Is is used only by Veritone platform components.
3733getSignedWritableUrls(
3734number: Int!,
3735type: String,
3736path: String,
3737organizationId: ID
3738): [WritableUrlInfo!]!
3739
3740# Return the overall status for a PUT request, reporting any failures that might
3741# have occurred.
3742# Example:
3743# Request:
3744#
3745# query {
3746#
3747# getUploadStatus(input: {
3748#
3749# key:
3750#
3751# }) {
3752#
3753# status
3754#
3755# message
3756#
3757# totalBytesReceived
3758#
3759# missingChunkNumbers
3760#
3761# failures {
3762#
3763# records {
3764#
3765# chunkNumber
3766#
3767# status
3768#
3769# message
3770#
3771# }
3772#
3773# }
3774#
3775# }
3776#
3777# }
3778# Response:
3779#
3780# {
3781#
3782# "data": {
3783#
3784# "getUploadStatus":
3785#
3786# {
3787#
3788# "status": "processing",
3789#
3790# "message": "test message",
3791#
3792# "totalBytesReceived": 124000000
3793#
3794# "missingChunkNumbers": 2
3795#
3796# "faiulures": [
3797#
3798# {
3799#
3800# "chunkNumber": 4
3801#
3802# "status": "failed"
3803#
3804# "message": "error message"
3805#
3806# }
3807#
3808# ]
3809#
3810# }
3811#
3812# }
3813#
3814# }
3815#
3816# Arguments
3817# input: UploadStatus input
3818getUploadStatus(input: UploadStatusInput!): UploadStatus!
3819
3820# Retrieve the rights of the current user
3821# Example:
3822# Request:
3823# query {
3824#
3825# myRights {
3826#
3827# resources
3828#
3829# operations
3830#
3831# }
3832# }
3833# Response:
3834# {
3835#
3836# "data": {
3837#
3838# "myRights": {
3839#
3840# "resources": {},
3841#
3842# "operations": [
3843#
3844# "admin.access",
3845#
3846# "admin.org.read",
3847#
3848# "admin.org.update",
3849#
3850# "admin.user.create",
3851#
3852# "admin.user.read",
3853#
3854# "admin.user.update",
3855#
3856# "admin.user.delete",
3857#
3858# ...
3859#
3860# ]
3861#
3862# }
3863#
3864# }
3865# }
3866myRights: RightsListing
3867
3868# Retrieve the shared folders for an organization
3869# Example:
3870# Request:
3871# query {
3872#
3873# sharedFolders {
3874#
3875# id
3876#
3877# }
3878# }
3879# Response:
3880# {
3881#
3882# "data": {
3883#
3884# "sharedFolders": []
3885#
3886# }
3887# }
3888sharedFolders: [Folder]
3889
3890# Retrieve multiple watchlists
3891# Example:
3892# Request:
3893# query {
3894#
3895# watchlists(limit: 2) {
3896#
3897# records {
3898#
3899# id
3900#
3901# name
3902#
3903# }
3904#
3905# }
3906# }
3907# Response:
3908# {
3909#
3910# "data": {
3911#
3912# "watchlists": {
3913#
3914# "records": [
3915#
3916# {
3917#
3918# "id": "326916",
3919#
3920# "name": "example"
3921#
3922# },
3923#
3924# {
3925#
3926# "id": "325791",
3927#
3928# "name": "example"
3929#
3930# }
3931#
3932# ]
3933#
3934# }
3935#
3936# }
3937# }
3938#
3939# Arguments
3940# isDisabled: Set `true` to include only disabled watchlist or
3941# `false` to include only enabled watchlists. By default,
3942# both are included.
3943# names: Provide a list of names to filter folders
3944watchlists(
3945id: ID,
3946maxStopDateTime: DateTime,
3947minStopDateTime: DateTime,
3948minStartDateTime: DateTime,
3949maxStartDateTime: DateTime,
3950name: String,
3951offset: Int,
3952limit: Int,
3953orderBy: WatchlistOrderBy,
3954orderDirection: OrderDirection,
3955isDisabled: Boolean,
3956names: [String],
3957nameMatch: StringMatch
3958): WatchlistList
3959
3960# Retrieve a single watchlist by id
3961# Example:
3962# Request:
3963# query {
3964#
3965# watchlist(id: "325791") {
3966#
3967# name
3968#
3969# watchlistType
3970#
3971# }
3972# }
3973# Response:
3974# {
3975#
3976# "data": {
3977#
3978# "watchlist": {
3979#
3980# "name": "example",
3981#
3982# "watchlistType": "tracking"
3983#
3984# }
3985#
3986# }
3987# }
3988watchlist(id: ID!): Watchlist
3989
3990# Example:
3991# Request:
3992# query {
3993#
3994# mentionStatusOptions {
3995#
3996# id
3997#
3998# name
3999#
4000# }
4001# }
4002# Response:
4003# {
4004#
4005# "data": {
4006#
4007# "mentionStatusOptions": [
4008#
4009# {
4010#
4011# "id": "7",
4012#
4013# "name": "Auto Verified"
4014#
4015# },
4016#
4017# {
4018#
4019# "id": "5",
4020#
4021# "name": "Invalid"
4022#
4023# },
4024#
4025# {
4026#
4027# "id": "3",
4028#
4029# "name": "Needs Review"
4030#
4031# },
4032#
4033# {
4034#
4035# "id": "1",
4036#
4037# "name": "Pending Verification"
4038#
4039# },
4040#
4041# {
4042#
4043# "id": "6",
4044#
4045# "name": "Processing Verification"
4046#
4047# },
4048#
4049# {
4050#
4051# "id": "4",
4052#
4053# "name": "Request Bonus"
4054#
4055# },
4056#
4057# {
4058#
4059# "id": "2",
4060#
4061# "name": "Verified"
4062#
4063# }
4064#
4065# ]
4066#
4067# }
4068# }
4069mentionStatusOptions: [MentionStatus!]!
4070
4071# Retrieve multiple data registries
4072# Example:
4073# Request:
4074# query {
4075#
4076# dataRegistries(limit: 2) {
4077#
4078# records {
4079#
4080# id
4081#
4082# name
4083#
4084# }
4085#
4086# }
4087# }
4088# Response:
4089# {
4090#
4091# "data": {
4092#
4093# "dataRegistries": {
4094#
4095# "records": [
4096#
4097# {
4098#
4099# "id": "532ef261-d3a4-4c09-8fc7-0653a5131577",
4100#
4101# "name": "example"
4102#
4103# },
4104#
4105# {
4106#
4107# "id": "317c941d-30d0-455e-882b-34a26e513364",
4108#
4109# "name": "example"
4110#
4111# }
4112#
4113# ]
4114#
4115# }
4116#
4117# }
4118# }
4119dataRegistries(
4120id: ID,
4121ids: [ID!],
4122name: String,
4123nameMatch: StringMatch,
4124offset: Int,
4125limit: Int,
4126orderBy: DataRegistryOrderBy,
4127orderDirection: OrderDirection,
4128filterByOwnership: SchemaOwnership
4129): DataRegistryList
4130
4131# Retrieve a single data registry
4132# Example:
4133# Request:
4134# query {
4135#
4136# dataRegistry(id: "532ef261-d3a4-4c09-8fc7-0653a5131577") {
4137#
4138# name
4139#
4140# organizationId
4141#
4142# source
4143#
4144# }
4145# }
4146# Response:
4147# {
4148#
4149# "data": {
4150#
4151# "dataRegistry": {
4152#
4153# "name": "example",
4154#
4155# "organizationId": "35521",
4156#
4157# "source": "veritone-35521.datasets"
4158#
4159# }
4160#
4161# }
4162# }
4163dataRegistry(id: ID!): DataRegistry
4164
4165# Retrieve a subscription by id
4166# Example:
4167# Request:
4168# query {
4169#
4170# subscription(id: "275818") {
4171#
4172# isActive
4173#
4174# jsondata
4175#
4176# }
4177# }
4178# Response:
4179# {
4180#
4181# "data": {
4182#
4183# "subscription": {
4184#
4185# "isActive": true,
4186#
4187# "jsondata": {
4188#
4189# "tracking_unit_id": "325791",
4190#
4191# "creator_email": "example email",
4192#
4193# "unsubscribe_hash":
4194# "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0cmFja2luZ1VuaXQiOiJ0cmFja2luZ191bml0X2lkIiwiZW1haWxBZGRyZXNzIjoiZW1haWxfYWRkcmVzcyIsInRyYWNraW5nX3VuaXRfaWQiOiIzMjU3OTEiLCJlbWFpbF9hZGRyZXNzIjoiZXhhbXBsZSBlbWFpbCIsImlhdCI6MTYyNDAyMjY4OCwiaXNzIjoidmVyaXRvbmU6ZGlzY292ZXJ5Iiwic3ViIjoidW5zdWJzY3JpYmUifQ.stYGS_goXaEhwLbKtYRohPirUT-q6vuY5hMHt74BWMUuEWYhwAQBxMItoFjZSXc3lHolQutxsl_BDiMOWNS4snRvcn-jI-5HG_4A3gEjQc6sYbgtyeVGxuDAg4urtj5sSBz0AU0xXZwLp2NI0Q39dqQSi1v1ZFANFE-jGULHreE3h617hLKf6CvegaOyrn_wqNONsB6VKDbXoLxdWoYJu3k7UztbvD1SC_bYHc7ltd1Ua2blUXSH0eBlk7pSv1vWdpw9KwMeuPJdC3R3qOB3-0xtp7KzTs0f5TelSZbk-6keVJz4LQt2mDxs6uivd8wb6GJ6Ikw-uKUYuo3T-vL0p-hFA5DkwiToomqTIqXvF5DGJxx762bKLLEKALAC55LdJ7eCZc6DmrnRbYLYNVfc2jK9YBDKeZxUAjNmYvlRsQTpLIrLoxWWmCbOJznfEjrzp_gI24rUh5qZ_-KUHr0pEYd5DuURy_geCmwSedq-nHV8tlE7op1bX8k9fwWFjIS7JIjYquUJq9T2wqIORO0WN6DGhgqkL7texbx9IYSWRkAY26KQxUF08jm5Vh_jrkmRyXsS9r5kVn_AGXbMA_HqtFo2jvXw5OXDcuaRjYwJpf8YtMvjNuDl8t9gbSmKwbeG1FsErPX0ne5K2TRWIqolohIvdHTTfsZLVvWdwmASnYw"
4195#
4196# }
4197#
4198# }
4199#
4200# }
4201# }
4202subscription(id: ID!): Subscription!
4203
4204cognitiveSearch(id: ID!): CognitiveSearch!
4205
4206# Retrieve multiple collections
4207# Example:
4208# Request:
4209# query {
4210#
4211# collections {
4212#
4213# records {
4214#
4215# id
4216#
4217# name
4218#
4219# }
4220#
4221# }
4222# }
4223# Response:
4224# {
4225#
4226# "data": {
4227#
4228# "collections": {
4229#
4230# "records": [
4231#
4232# {
4233#
4234# "id": "241121",
4235#
4236# "name": "example"
4237#
4238# },
4239#
4240# {
4241#
4242# "id": "242599",
4243#
4244# "name": "example"
4245#
4246# },
4247#
4248# {
4249#
4250# "id": "243625",
4251#
4252# "name": "example"
4253#
4254# }
4255#
4256# ]
4257#
4258# }
4259#
4260# }
4261# }
4262collections(id: ID, name: String, mentionId: ID, offset: Int, limit: Int): CollectionList!
4263
4264# Retrieve a collection by id
4265# Example:
4266# Request:
4267# query {
4268#
4269# collection(id: "241121") {
4270#
4271# name
4272#
4273# isActive
4274#
4275# }
4276# }
4277# Response:
4278# {
4279#
4280# "data": {
4281#
4282# "collection": {
4283#
4284# "name": "example",
4285#
4286# "isActive": true
4287#
4288# }
4289#
4290# }
4291# }
4292collection(id: ID!): Collection!
4293
4294collectionMention(folderId: ID!, mentionId: ID!): CollectionMention!
4295
4296# Retrieve a list of collection mentions
4297# Specify at least one of folderId or mentionId
4298collectionMentions(
4299folderId: ID,
4300mentionId: ID,
4301orderBy: CollectionMentionOrderBy,
4302limit: Int,
4303offset: Int
4304): CollectionMentionList!
4305
4306# Retrieve multiple mentions
4307# Example:
4308# Request:
4309# query {
4310#
4311# mentions {
4312#
4313# records {
4314#
4315# id
4316#
4317# }
4318#
4319# }
4320# }
4321# Response:
4322# {
4323#
4324# "data": {
4325#
4326# "mentions": {
4327#
4328# "records": []
4329#
4330# }
4331#
4332# }
4333# }
4334#
4335# Arguments
4336# watchlistId: Get mentions created from the specified watchlist
4337# sourceId: Get mentions associated with the specified source
4338# sourceTypeId: Get mentions associated with sources of the
4339# specified source type
4340# tdoId: Get mentions associated directly with the specific TDO
4341# dateTimeFilter: Specify date/time filters against mention
4342# fields.
4343# Querying for mentions can be expensive. If the query does not
4344# include a filter by `id`, `tdoId`, `sourceId`, `watchlistId`, or
4345# a user-provided `dateTimeFilter`, a default filter of the
4346# past 7 days is applied.
4347# orderBy: Set order information on the query. Multiple fields
4348# are supported.
4349# folderId: Provide a folder ID to filter by collection
4350mentions(
4351id: ID,
4352watchlistId: ID,
4353sourceId: ID,
4354sourceTypeId: ID,
4355tdoId: ID,
4356dateTimeFilter: [MentionDateTimeFilter!],
4357orderBy: [MentionOrderBy!],
4358offset: Int,
4359limit: Int,
4360folderId: ID
4361): MentionList
4362
4363# Retrieves engine results by TDO and engine ID or by job ID.
4364# Example:
4365# Request:
4366# query {
4367#
4368# engineResults(
4369#
4370# tdoId: "1580507556",
4371#
4372# engineIds: "4") {
4373#
4374# sourceId
4375#
4376# records {
4377#
4378# tdoId
4379#
4380# }
4381#
4382# }
4383# }
4384# Response:
4385# {
4386#
4387# "data": {
4388#
4389# "engineResults": {
4390#
4391# "sourceId": null,
4392#
4393# "records": []
4394#
4395# }
4396#
4397# }
4398# }
4399#
4400# Arguments
4401# tdoId: Provide the ID of the TDO containing engine results to
4402# retrieve.
4403# If this parameter is used, engineIds or engineCategoryIds must also be set.
4404# Results for _only_ the specified TDO will be returned.
4405# sourceId: Provide the ID of the Source containing engine
4406# results to retrieve.
4407# If this parameter is used, engineIds or engineCategoryIds must also be set.
4408# This takes priority over tdoId.
4409# engineIds: Provide one or more engine IDs to retrieve engine
4410# results by
4411# ID. This parameter is mandatory if tdoId is used, but optional
4412# if jobId or engineCategory is used.
4413# engineCategoryIds: Provide one or more category IDs to get all
4414# results from that categroy.
4415# jobId: Provide a job ID to retrieve engine results for the job.
4416# mentionId: Provide a mention ID to retrieve engine results for
4417# the mention.
4418# startOffsetMs: Start offset ms for the results.
4419# stopOffsetMs: End offset ms for the results.
4420# startDate: Start date for the results. Takes priority over
4421# startOffsetMs.
4422# stopDate: End date for the results. Takes priority over
4423# stopOffsetMs.
4424# ignoreUserEdited: Whether or not to exclude user edited engine
4425# results. Defaults to false.
4426# fallbackTdoId: A TDO ID can be provided for use if the provided
4427# `sourceId` and/or
4428# `mentionId` parameters do not resolve to a logical set of TDOs.
4429# Depending on parameter settings and available data,
4430# results from other TDOs can be included in the response.
4431engineResults(
4432tdoId: ID,
4433sourceId: ID,
4434engineIds: [ID!],
4435engineCategoryIds: [ID!],
4436jobId: ID,
4437mentionId: ID,
4438startOffsetMs: Int,
4439stopOffsetMs: Int,
4440startDate: DateTime,
4441stopDate: DateTime,
4442ignoreUserEdited: Boolean,
4443fallbackTdoId: ID
4444): EngineResultList
4445
4446# Retrieve a trigger by id
4447# Example:
4448# Request:
4449# query {
4450#
4451# trigger(id: "2998") {
4452#
4453# target
4454#
4455# createdDateTime
4456#
4457# }
4458# }
4459# Response:
4460# {
4461#
4462# "data": {
4463#
4464# "trigger": {
4465#
4466# "target": "Email",
4467#
4468# "createdDateTime": "2021-06-18T13:35:08.631Z"
4469#
4470# }
4471#
4472# }
4473# }
4474trigger(id: ID!): Trigger
4475
4476# Retrieve triggers
4477# Example:
4478# Request:
4479# query {
4480#
4481# triggers {
4482#
4483# id
4484#
4485# }
4486# }
4487# Response:
4488# {
4489#
4490# "data": {
4491#
4492# "triggers": [
4493#
4494# {
4495#
4496# "id": "2998"
4497#
4498# }
4499#
4500# ]
4501#
4502# }
4503# }
4504triggers: [Trigger]
4505
4506# Fetch all saved searches that the current user has made
4507# Fetch all saved searches that have been shared with
4508# the current users organization
4509# Include any saved searches that the user has created
4510# Example:
4511# Request:
4512# query {
4513#
4514# savedSearches {
4515#
4516# records {
4517#
4518# id
4519#
4520# name
4521#
4522# }
4523#
4524# }
4525# }
4526# Response:
4527# {
4528#
4529# "data": {
4530#
4531# "savedSearches": {
4532#
4533# "records": [
4534#
4535# {
4536#
4537# "id": "3aa9fecb-d3cb-4fa5-a11b-20e02ae494b9",
4538#
4539# "name": "example"
4540#
4541# }
4542#
4543# ]
4544#
4545# }
4546#
4547# }
4548# }
4549savedSearches(
4550offset: Int,
4551limit: Int,
4552includeShared: Boolean,
4553filterByName: String,
4554orderBy: SavedSearchOrderBy,
4555orderDirection: OrderDirection
4556): SavedSearchList!
4557
4558# Retrieve a list of export requests
4559# Example:
4560# Request:
4561# query {
4562#
4563# exportRequests(limit: 2) {
4564#
4565# records {
4566#
4567# id
4568#
4569# organizationId
4570#
4571# }
4572#
4573# }
4574# }
4575# Response:
4576# {
4577#
4578# "data": {
4579#
4580# "exportRequests": {
4581#
4582# "records": [
4583#
4584# {
4585#
4586# "id": "938b2d64-6df1-486b-b6ea-29d33dee49ad",
4587#
4588# "organizationId": "35521"
4589#
4590# }
4591#
4592# ]
4593#
4594# }
4595#
4596# }
4597# }
4598#
4599# Arguments
4600# id: Provide an ID to retrieve a single export request
4601# offset: Provide an offset to skip to a certain element in the
4602# result, for paging.
4603# limit: Specify maximum number of results to retrieve in this
4604# result. Page size.
4605# status: Provide a list of status options to filter by status
4606# event: Provide an event to retrieve export request. Should be
4607# 'exportRequest' or 'mentionExportRequest'
4608# Default value is 'exportRequest'
4609exportRequests(
4610id: ID,
4611offset: Int,
4612limit: Int,
4613status: [ExportRequestStatus!],
4614event: ExportRequestEvent
4615): ExportRequestList!
4616
4617# Retrieve a single export request by id
4618# Example:
4619# Request:
4620# query {
4621#
4622# exportRequest(id: "938b2d64-6df1-486b-b6ea-29d33dee49ad") {
4623#
4624# id
4625#
4626# organizationId
4627#
4628# requestorId
4629#
4630# status
4631#
4632# }
4633# }
4634# Response:
4635# {
4636#
4637# "data": {
4638#
4639# "exportRequest": {
4640#
4641# "id": "938b2d64-6df1-486b-b6ea-29d33dee49ad",
4642#
4643# "organizationId": "35521",
4644#
4645# "requestorId": "59cb4e74-7c31-4267-b91e-d4600bc08008",
4646#
4647# "status": "complete"
4648#
4649# }
4650#
4651# }
4652# }
4653#
4654# Arguments
4655# event: Provide an event to retrieve export request. Should be
4656# 'exportRequest' or 'mentionExportRequest'
4657# Default value is 'exportRequest'
4658exportRequest(id: ID!, event: ExportRequestEvent): ExportRequest!
4659
4660# Retrieve a event by id
4661# Example:
4662# Request:
4663# query {
4664#
4665# event(id: "55fc7c51-1521-4043-902f-f0f3a357da6d") {
4666#
4667# eventName
4668#
4669# eventType
4670#
4671# description
4672#
4673# }
4674# }
4675# Response:
4676# {
4677#
4678# "data": {
4679#
4680# "event": {
4681#
4682# "eventName": "example",
4683#
4684# "eventType": "example",
4685#
4686# "description": "new example description"
4687#
4688# }
4689#
4690# }
4691# }
4692event(id: ID!): Event
4693
4694# Retrieve a list of events by application
4695# Example:
4696# Request:
4697# query {
4698#
4699# events(
4700#
4701# application: "system",
4702#
4703# limit: 2) {
4704#
4705# records {
4706#
4707# id
4708#
4709# eventName
4710#
4711# }
4712#
4713# }
4714# }
4715# Response:
4716# {
4717#
4718# "data": {
4719#
4720# "events": {
4721#
4722# "records": [
4723#
4724# {
4725#
4726# "id": "8876aa2f-1068-411d-b746-28c867c151cc",
4727#
4728# "eventName": "ActionTokenForbidden"
4729#
4730# },
4731#
4732# {
4733#
4734# "id": "d5082d0e-3c96-4c71-9f27-c679650f2adf",
4735#
4736# "eventName": "ActionUserForbidden"
4737#
4738# }
4739#
4740# ]
4741#
4742# }
4743#
4744# }
4745# }
4746#
4747# Arguments
4748# application: Provide an application to retrieve all its events.
4749# Use 'system' to list all public system events.
4750# offset: Provide an offset to skip to a certain element in the
4751# result, for paging.
4752# limit: Specify maximum number of results to retrieve in this
4753# result. Page size.
4754events(application: String!, offset: Int, limit: Int): EventList!
4755
4756# Retrieve a list of subscriptions by organization
4757# Example:
4758# Request:
4759# query {
4760#
4761# eventSubscriptions(limit: 2) {
4762#
4763# records {
4764#
4765# id
4766#
4767# eventName
4768#
4769# }
4770#
4771# }
4772# }
4773# Response:
4774# {
4775#
4776# "data": {
4777#
4778# "eventSubscriptions": {
4779#
4780# "records": [
4781#
4782# {
4783#
4784# "id": "4a81cdf7-e85b-4dc4-85ce-7c2d300cd194",
4785#
4786# "eventName": "LibraryTrain"
4787#
4788# },
4789#
4790# {
4791#
4792# "id": "c7c4a969-4500-4d7b-b77f-81b1e64bf112",
4793#
4794# "eventName": "LibraryTrain"
4795#
4796# }
4797#
4798# ]
4799#
4800# }
4801#
4802# }
4803# }
4804#
4805# Arguments
4806# ids: The event subscription ids
4807# eventName: The name of the event
4808# eventType: The type of event, such as `mention`, `job`,
4809# `engine`.
4810# offset: Provide an offset to skip to a certain element in the
4811# result, for paging.
4812# limit: Specify maximum number of results to retrieve in this
4813# result. Page size.
4814# orgId: The organization ID with which these event subscriptions
4815# are associated.
4816# appId: The application ID with which these event subscriptions
4817# are associated.
4818# scope: Event subscription scope
4819eventSubscriptions(
4820ids: [ID!],
4821eventName: String,
4822eventType: String,
4823offset: Int,
4824limit: Int,
4825orgId: ID,
4826appId: ID,
4827scope: EventSubscriptionScope
4828): EventSubscriptionList!
4829
4830# Retrieve a subscription by id
4831# Example:
4832# Request:
4833# query {
4834#
4835# eventSubscription(id: "4a81cdf7-e85b-4dc4-85ce-7c2d300cd194") {
4836#
4837# id
4838#
4839# organizationId
4840#
4841# eventName
4842#
4843# targetName
4844#
4845# }
4846# }
4847# Response:
4848# {
4849#
4850# "data": {
4851#
4852# "eventSubscription": {
4853#
4854# "id": "4a81cdf7-e85b-4dc4-85ce-7c2d300cd194",
4855#
4856# "organizationId": "35521",
4857#
4858# "eventName": "LibraryTrain",
4859#
4860# "targetName": "NotificationMailbox"
4861#
4862# }
4863#
4864# }
4865# }
4866eventSubscription(id: ID!): EventSubscription!
4867
4868# Example:
4869# Request:
4870# query {
4871#
4872# eventActionTemplate(id: "d02522d7-ef5f-448f-981a-d2cfc7603d92") {
4873#
4874# organizationId
4875#
4876# actionType
4877#
4878# name
4879#
4880# }
4881# }
4882# Response:
4883# {
4884#
4885# "data": {
4886#
4887# "eventActionTemplate": {
4888#
4889# "organizationId": "35521",
4890#
4891# "actionType": "job",
4892#
4893# "name": "example"
4894#
4895# }
4896#
4897# }
4898# }
4899eventActionTemplate(id: ID!): EventActionTemplate
4900
4901# Example:
4902# Request:
4903# query {
4904#
4905# eventActionTemplates(
4906#
4907# inputType: event,
4908#
4909# actionType: job
4910#
4911# limit:2) {
4912#
4913# records {
4914#
4915# id
4916#
4917# name
4918#
4919# }
4920#
4921# }
4922# }
4923# Response:
4924# {
4925#
4926# "data": {
4927#
4928# "eventActionTemplates": {
4929#
4930# "records": [
4931#
4932# {
4933#
4934# "id": "d02522d7-ef5f-448f-981a-d2cfc7603d92",
4935#
4936# "name": "example"
4937#
4938# },
4939#
4940# {
4941#
4942# "id": "49d28375-b6b2-418e-b965-8e939d1189ae",
4943#
4944# "name": "example"
4945#
4946# }
4947#
4948# ]
4949#
4950# }
4951#
4952# }
4953# }
4954#
4955# Arguments
4956# ownerApplicationId: The application id
4957# inputType: use "event" for now. In the future, we allow
4958# additional input_type types. For example, a schedule or a tweet.
4959# actionType: Either "job", "webhook", "sms", "email". Future
4960# action_type could be "gql" where action is purely a function call.
4961# offset: Provide an offset to skip to a certain element in the
4962# result, for paging.
4963# limit: Specify maximum number of results to retrieve in this
4964# result. Page size.
4965eventActionTemplates(
4966ownerApplicationId: ID,
4967inputType: EventActionTemplateInputType,
4968actionType: EventActionTemplateActionType,
4969offset: Int,
4970limit: Int
4971): EventActionTemplateList!
4972
4973# Example:
4974# Request:
4975# query {
4976#
4977# eventCustomRule(id: "c2c1ee13-37d2-4f92-9156-5cb1a3c59ed5") {
4978#
4979# name
4980#
4981# eventName
4982#
4983# description
4984#
4985# }
4986# }
4987# Response:
4988# {
4989#
4990# "data": {
4991#
4992# "eventCustomRule": {
4993#
4994# "name": "example",
4995#
4996# "eventName": "example",
4997#
4998# "description": "example description"
4999#
5000# }
5001#
5002# }
5003# }
5004eventCustomRule(id: ID!): EventCustomRule
5005
5006# Example:
5007# Request:
5008# query {
5009#
5010# eventCustomRules(limit: 2) {
5011#
5012# records {
5013#
5014# id
5015#
5016# name
5017#
5018# }
5019#
5020# }
5021# }
5022# Response:
5023# {
5024#
5025# "data": {
5026#
5027# "eventCustomRules": {
5028#
5029# "records": [
5030#
5031# {
5032#
5033# "id": "c2c1ee13-37d2-4f92-9156-5cb1a3c59ed5",
5034#
5035# "name": "example"
5036#
5037# }
5038#
5039# ]
5040#
5041# }
5042#
5043# }
5044# }
5045#
5046# Arguments
5047# offset: the offset to skip to a certain element in the result
5048# limit: the maximum number of rows in the results
5049eventCustomRules(offset: Int, limit: Int): EventCustomRuleList!
5050
5051# This query returns information about time zones recognized by this
5052#
5053# server. The information is static and does not change.
5054#
5055# Example:
5056#
5057# Request:
5058#
5059# query {
5060#
5061# timeZones {
5062#
5063# name
5064#
5065# abbreviations{
5066#
5067# name
5068#
5069# }
5070#
5071# }
5072# }
5073# Response:
5074# {
5075#
5076# "data": {
5077#
5078# "timeZones": [
5079#
5080# {
5081#
5082# "name": "Africa/Abidjan",
5083#
5084# "abbreviations": [
5085#
5086# {
5087#
5088# "name": "GMT"
5089#
5090# }
5091#
5092# ]
5093#
5094# },
5095#
5096# {
5097#
5098# "name": "Africa/Accra",
5099#
5100# "abbreviations": [
5101#
5102# {
5103#
5104# "name": "GMT"
5105#
5106# },
5107#
5108# {
5109#
5110# "name": "+0020"
5111#
5112# }
5113#
5114# ]
5115#
5116# },
5117#
5118# {
5119#
5120# "name": "Africa/Lagos",
5121#
5122# "abbreviations": [
5123#
5124# {
5125#
5126# "name": "WAT"
5127#
5128# }
5129#
5130# ]
5131#
5132# },
5133#
5134# ...
5135#
5136# ...
5137#
5138# ]
5139#
5140# }
5141#
5142# ]
5143#
5144# }
5145timeZones: [TimeZone!]!
5146
5147# Examine entries from the audit log. All operations that modify data are
5148# written to the audit log. Only entries for the user's own organization
5149# can be queried.
5150# All queries are bracketed by a time window. A default time window is applied
5151# if the `toDateTime` and/or `fromDateTime` parameters are not provided.
5152# The maximum time window length is 30 days.
5153# Only Veritone and organization administrators can use this query.
5154# Example:
5155# Request:
5156# query {
5157#
5158# auditLog(limit: 2) {
5159#
5160# records {
5161#
5162# id
5163#
5164# objectId
5165#
5166# description
5167#
5168# }
5169#
5170# }
5171# }
5172# Response:
5173# {
5174#
5175# "data": {
5176#
5177# "auditLog": {
5178#
5179# "records": [
5180#
5181# {
5182#
5183# "id": "735915311",
5184#
5185# "objectId": "*********",
5186#
5187# "description": "Changed password"
5188#
5189# },
5190#
5191# {
5192#
5193# "id": "735915307",
5194#
5195# "objectId": "********",
5196#
5197# "description": "Changed password"
5198#
5199# }
5200#
5201# ]
5202#
5203# }
5204#
5205# }
5206# }
5207#
5208# Arguments
5209# toDateTime: Date/time up to which entries will be returned. In
5210# other words, the
5211# end of the query time window.
5212# Defaults to the current time.
5213# fromDateTime: Date/time from which entries will be returned. In
5214# other words, the
5215# start of the query time window.
5216# Defaults to the `toDateTime` minus 7 days.
5217# organizationId: Organization ID to query records for. This
5218# value can only be used by
5219# Veritone administrators. Any value provided by user administrators will
5220# be ignored.
5221# userName: User name on audit entry. Must be exact match.
5222# clientIpAddress: IP address of the client that generated the
5223# audit action. Must be exact match.
5224# clientUserAgent: HTTP user agent of the client that generated
5225# the audit action. Must be exact match.
5226# eventType: The event type, such as `Create`, `Update`, or
5227# `Delete`.
5228# Must be exact match.
5229# objectId: The ID of the object involved in the audit action.
5230# The format of this ID
5231# varies by object type. Must be exact match.
5232# objectType: The type of the object involved in the audit
5233# action, such as `Watchlist`
5234# or `TemporalDataObject`. Must be exact match.
5235# success: Whether or not the action was successful.
5236# id: The unique ID of an audit log entry. Multiple values can be
5237# provided.
5238# offset: Offset into result set, for paging.
5239# limit: Limit on result size, for paging (page size). Audit
5240# queries are
5241# lightweight so the default of 100 is higher than the default offset
5242# used elsewhere in the API.
5243# orderBy: Order information. Default is order by
5244# `createdDateTime` descending.
5245auditLog(
5246toDateTime: DateTime,
5247fromDateTime: DateTime,
5248organizationId: ID,
5249userName: String,
5250clientIpAddress: String,
5251clientUserAgent: String,
5252eventType: String,
5253objectId: ID,
5254objectType: String,
5255success: Boolean,
5256id: [ID!],
5257offset: Int,
5258limit: Int,
5259orderBy: [AuditLogOrderBy!]
5260): AuditLogEntryList! @deprecated( reason: "No longer supported." )
5261
5262# Get the media share by media shareId
5263mediaShare(id: ID!): MediaShare!
5264
5265# Retrieve a shared collection
5266#
5267# Arguments
5268# shareId: share token
5269sharedCollection(shareId: ID!): SharedCollection
5270
5271# Retrieve shared collection history records
5272# Example:
5273# Request:
5274# query {
5275#
5276# sharedCollectionHistory(limit: 2,
5277#
5278# folderId: "d551fbd6-7354-4b0e-abfb-654ab8583be2") {
5279#
5280# records {
5281#
5282# id
5283#
5284# status
5285#
5286# shareId
5287#
5288# }
5289#
5290# }
5291# }
5292# Response:
5293# {
5294#
5295# "data": {
5296#
5297# "sharedCollectionHistory": {
5298#
5299# "records": []
5300#
5301# }
5302#
5303# }
5304# }
5305#
5306# Arguments
5307# ids: Provide an ID to retrieve a single history record
5308# folderId: Provide a folder ID to filter by collection
5309# shareId: Provide a share ID to filter by share ID
5310# offset: Specify maximum number of results to retrieve in this
5311# result. Page size.
5312# limit: Specify maximum number of results to retrieve in this
5313# result.
5314sharedCollectionHistory(
5315ids: [ID!],
5316folderId: ID,
5317shareId: String,
5318offset: Int,
5319limit: Int
5320): SharedCollectionHistoryList!
5321
5322# Get list process templates by id or current organizationId
5323# Example:
5324# Request:
5325# query {
5326#
5327# processTemplates(limit: 2) {
5328#
5329# records {
5330#
5331# id
5332#
5333# organizationId
5334#
5335# name
5336#
5337# }
5338#
5339# }
5340# }
5341# Response:
5342# {
5343#
5344# "data": {
5345#
5346# "processTemplates": {
5347#
5348# "records": [
5349#
5350# {
5351#
5352# "id": "762",
5353#
5354# "organizationId": "35521",
5355#
5356# "name": "example"
5357#
5358# }
5359#
5360# ]
5361#
5362# }
5363#
5364# }
5365# }
5366processTemplates(id: ID, offset: Int, limit: Int): ProcessTemplateList!
5367
5368# Get process templates by id
5369# Example:
5370# Request:
5371# query {
5372#
5373# processTemplate(id: "762") {
5374#
5375# name
5376#
5377# organizationId
5378#
5379# }
5380# }
5381# Response:
5382# {
5383#
5384# "data": {
5385#
5386# "processTemplate": {
5387#
5388# "name": "example",
5389#
5390# "organizationId": "35521"
5391#
5392# }
5393#
5394# }
5395# }
5396processTemplate(id: ID!): ProcessTemplate!
5397
5398# Get creative by id with current organizationId
5399# Example:
5400# Request:
5401# query {
5402#
5403# creative(id: "25209") {
5404#
5405# organizationId
5406#
5407# brandId
5408#
5409# }
5410# }
5411# Response:
5412# {
5413#
5414# "data": {
5415#
5416# "creative": {
5417#
5418# "organizationId": "35521",
5419#
5420# "brandId": null
5421#
5422# }
5423#
5424# }
5425# }
5426creative(id: ID!): Creative!
5427
5428# Retrieve list of engine classes
5429# Example:
5430# Request:
5431# query {
5432#
5433# engineClasses(limit: 2) {
5434#
5435# records {
5436#
5437# id
5438#
5439# name
5440#
5441# description
5442#
5443# }
5444#
5445# }
5446# }
5447# Response:
5448# {
5449#
5450# "data": {
5451#
5452# "engineClasses": {
5453#
5454# "records": [
5455#
5456# {
5457#
5458# "id": "e0283fdf-7f85-472e-b367-59cc8d205ba7",
5459#
5460# "name": "audio",
5461#
5462# "description": "The input to engines in the Audio class is an audio or video
5463# file or stream. If your engine processes human speech or voice, it likely
5464# belongs in the Speech class instead. Audio engines may recognize a specific
5465# audio segment, such as an advertisement, identify sounds like that of a crying
5466# baby or detect the presence of audio or music in an audio or video file, for
5467# example."
5468#
5469# },
5470#
5471# {
5472#
5473# "id": "1bcfdd35-1e9b-4694-8273-00b19510d164",
5474#
5475# "name": "biometrics",
5476#
5477# "description": "The input to engines in the Biometrics class may be an image,
5478# speech or other audio or video file or stream. By definition, the Biometrics
5479# class covers cognitive analysis related to data points from the human body.
5480# Biometrics engines may detect or recognize faces, identify face attributes to
5481# estimate a person's age or ethnicity or verify a person based on their unique
5482# iris, for example."
5483#
5484# }
5485#
5486# ]
5487#
5488# }
5489#
5490# }
5491# }
5492#
5493# Arguments
5494# id: Provide an ID to retrieve a single specific engine class.
5495# name: Provide a name, or part of one, to search by class name
5496# offset: Specify maximum number of results to retrieve in this
5497# result. Page size.
5498# limit: Specify maximum number of results to retrieve in this
5499# result.
5500engineClasses(id: ID, name: String, offset: Int, limit: Int): EngineClassList
5501
5502# Retrieve a specific engine class
5503# Example:
5504# Request:
5505# query {
5506#
5507# engineClass(id: "e0283fdf-7f85-472e-b367-59cc8d205ba7") {
5508#
5509# id
5510#
5511# name
5512#
5513# description
5514#
5515# }
5516# }
5517# Response:
5518# {
5519#
5520# "data": {
5521#
5522# "engineClass": {
5523#
5524# "id": "e0283fdf-7f85-472e-b367-59cc8d205ba7",
5525#
5526# "name": "audio",
5527#
5528# "description": "The input to engines in the Audio class is an audio or video
5529# file or stream. If your engine processes human speech or voice, it likely
5530# belongs in the Speech class instead. Audio engines may recognize a specific
5531# audio segment, such as an advertisement, identify sounds like that of a crying
5532# baby or detect the presence of audio or music in an audio or video file, for
5533# example."
5534#
5535# }
5536#
5537# }
5538# }
5539#
5540# Arguments
5541# id: Supply the ID of the engine class to retrieve
5542engineClass(id: ID!): EngineClass
5543
5544# Retrieve list entity tags where tag key contains user input
5545# Example:
5546# Request:
5547# query {
5548#
5549# matchEntityTags(input: { tagKey: "test"}) {
5550#
5551# records {
5552#
5553# tagKey
5554#
5555# tagValue
5556#
5557# }
5558#
5559# }
5560# }
5561# Response:
5562# {
5563#
5564# "data": {
5565#
5566# "matchEntityTags": {
5567#
5568# "records": [
5569#
5570# {
5571#
5572# "tagKey": "test-tag",
5573#
5574# "tagValue": "test-value"
5575#
5576# },
5577#
5578# {
5579#
5580# "tagKey": "another-testtag",
5581#
5582# "tagValue": ""
5583#
5584# },
5585#
5586# ]
5587#
5588# }
5589#
5590# }
5591# }
5592#
5593# Arguments
5594# input: User provided text and entity type input.
5595# offset: Specify maximum number of results to retrieve in this
5596# result. Page size.
5597# limit: Specify maximum number of results to retrieve in this
5598# result.
5599matchEntityTags(input: MatchEntityTagInput!, offset: Int, limit: Int): MatchedEntityTagsList
5600
5601# Returns all custom dashboards created by user
5602# Example:
5603# Request:
5604# query {
5605#
5606# customDashboards {
5607#
5608# records {
5609#
5610# id
5611#
5612# description
5613#
5614# hostAppId
5615#
5616# }
5617#
5618# }
5619# }
5620# Response:
5621# {
5622#
5623# "data": {
5624#
5625# "customDashboards": {
5626#
5627# "records": [
5628#
5629# {
5630#
5631# "id": "a20ae938-e827-4b0b-a62a-6c9af0b98cc9",
5632#
5633# "description": "example",
5634#
5635# "hostAppId": "80354999-d633-4595-9578-d82f59a5134f"
5636#
5637# }
5638#
5639# ]
5640#
5641# }
5642#
5643# }
5644# }
5645#
5646# Arguments
5647# offset: Provide an offset to skip to a certain element in the
5648# result, for paging.
5649# limit: Specify maximum number of results to retrieve in this
5650# result. Page size.
5651# hostAppId: Include only dashboards created by specific
5652# host_app_id
5653customDashboards(offset: Int, limit: Int, hostAppId: ID): CustomDashboardList
5654
5655# Returns custom dashboard by id
5656# Example:
5657# Request:
5658# query {
5659#
5660# customDashboard(id: "a20ae938-e827-4b0b-a62a-6c9af0b98cc9") {
5661#
5662# hostAppId
5663#
5664# name
5665#
5666# }
5667# }
5668# Response:
5669# {
5670#
5671# "data": {
5672#
5673# "customDashboard": {
5674#
5675# "hostAppId": "80354999-d633-4595-9578-d82f59a5134f",
5676#
5677# "name": "example"
5678#
5679# }
5680#
5681# }
5682# }
5683customDashboard(id: ID!): CustomDashboard
5684
5685# Gets engine usage for an organization based on their billing type.
5686# Example:
5687# Request:
5688# query {
5689#
5690# getUsageByTaskType {
5691#
5692# totalDuration
5693#
5694# totalCost
5695#
5696# }
5697# }
5698# Response:
5699# {
5700#
5701# "data": {
5702#
5703# "getUsageByTaskType": {
5704#
5705# "totalDuration": 0,
5706#
5707# "totalCost": "0"
5708#
5709# }
5710#
5711# }
5712# }
5713getUsageByTaskType: UsageByTaskType!
5714
5715# Retrives the specific Dataset
5716#
5717# Arguments
5718# id: Supply the ID of the Dataset to retrieve
5719dataset(id: ID!): Dataset
5720
5721# Retrieve list of Datasets
5722# Example:
5723# Request:
5724# query {
5725#
5726# datasets(limit:2, filter: {operation:OR}) {
5727#
5728# records {
5729#
5730# datasetId
5731#
5732# name
5733#
5734# }
5735#
5736# }
5737# }
5738# Response:
5739# {
5740#
5741# "data": {
5742#
5743# "datasets": {
5744#
5745# "records": []
5746#
5747# }
5748#
5749# }
5750# }
5751#
5752# Arguments
5753# offset: Provide an offset to skip to a certain element in the
5754# result, for paging.
5755# limit: Specify maximum number of results to retrieve in this
5756# result. Page size.
5757# filter: Filters for Dataset attributes
5758datasets(offset: Int, limit: Int, filter: DatasetFilter): DatasetList
5759
5760# Arguments
5761# datasetId: Supply the ID of the Dataset to retrieve
5762# offset: Provide an offset to skip to a certain element in the
5763# result, for paging.
5764# limit: Specify maximum number of results to retrieve in this
5765# result. Page size.
5766# filter: Query to filter SDO. Supports operations such as and,
5767# or, eq, gt, lt, etc.
5768# TODO link to syntax documentation
5769# orderBy: Order by
5770datasetDataQuery(
5771datasetId: ID!,
5772offset: Int,
5773limit: Int,
5774filter: JSONData,
5775orderBy: [StructuredDataOrderBy!]
5776): DatasetEntryList!
5777
5778# Retrive list of Engine Replacement
5779# Example:
5780# Request:
5781# query {
5782#
5783# taskReplacementEngines {
5784#
5785# records {
5786#
5787# sourceEngineId
5788#
5789# replacementEngineId
5790#
5791# }
5792#
5793# }
5794# }
5795# Response:
5796# {
5797#
5798# "data": {
5799#
5800# "taskReplacementEngines": {
5801#
5802# "records": [
5803#
5804# {
5805#
5806# "sourceEngineId": "1",
5807#
5808# "replacementEngineId": "2"
5809#
5810# }
5811#
5812# ]
5813#
5814# }
5815#
5816# }
5817# }
5818#
5819# Arguments
5820# organizationId: Only superadmin can get engine replacement of
5821# other orgs
5822# engineId: Filter by the source engineId
5823# offset: Provide an offset to skip to a certain element in the
5824# result, for paging.
5825# limit: Specify maximum number of results to retrieve in this
5826# result. Page size.
5827taskReplacementEngines(
5828organizationId: ID,
5829engineId: ID,
5830offset: Int,
5831limit: Int
5832): TaskReplacementEngineList
5833
5834# Retrive Notification Mailboxes by list of mailboxIds
5835# Example:
5836# Request:
5837# query {
5838#
5839# notificationMailboxes {
5840#
5841# id
5842#
5843# name
5844#
5845# }
5846# }
5847# Response:
5848# {
5849#
5850# "data": {
5851#
5852# "notificationMailboxes": [
5853#
5854# {
5855#
5856# "id": "6fda80b5-3d1a-4eb8-bd32-277be5104149",
5857#
5858# "name": "example"
5859#
5860# },
5861#
5862# {
5863#
5864# "id": "d20e9f37-a887-41bb-aed0-3268884ecebc",
5865#
5866# "name": "Library training mailbox"
5867#
5868# },
5869#
5870# {
5871#
5872# "id": "2d29533b-560e-4354-b794-84f823d33205",
5873#
5874# "name": "Library training mailbox"
5875#
5876# }
5877#
5878# ]
5879#
5880# }
5881# }
5882notificationMailboxes(ids: [ID!], name: String): [NotificationMailbox!]
5883
5884# Retrive Notification Templates
5885# Example:
5886# Request:
5887# query {
5888#
5889# notificationTemplates(limit: 2) {
5890#
5891# records {
5892#
5893# id
5894#
5895# eventName
5896#
5897# }
5898#
5899# }
5900# }
5901# Response:
5902# {
5903#
5904# "data": {
5905#
5906# "notificationTemplates": {
5907#
5908# "records": [
5909#
5910# {
5911#
5912# "id": "3947b833-2be4-4415-8272-2cee62fbca23",
5913#
5914# "eventName": "example"
5915#
5916# }
5917#
5918# ]
5919#
5920# }
5921#
5922# }
5923# }
5924#
5925# Arguments
5926# ids: Get by array of ids
5927# eventName: Get by eventName
5928# eventType: Get by eventType
5929# application: Get by application
5930# mailboxId: Get by mailboxId
5931# ownerOrganizationId: Only super-admin or orgless token can get
5932# templates by ownerOrganizationId
5933# offset: Provide an offset to skip to a certain element in the
5934# result, for paging.
5935# limit: Specify maximum number of results to retrieve in this
5936# result. Page size.
5937notificationTemplates(
5938ids: [ID],
5939eventName: String,
5940eventType: String,
5941application: String,
5942mailboxId: ID,
5943ownerOrganizationId: ID,
5944offset: Int,
5945limit: Int
5946): NotificationTemplateList
5947
5948# Retrieve Notification Actions
5949# Example:
5950# Request:
5951# query {
5952#
5953# notificationActions {
5954#
5955# records {
5956#
5957# id
5958#
5959# actionName
5960#
5961# }
5962#
5963# }
5964# }
5965# Response:
5966# {
5967#
5968# "data": {
5969#
5970# "notificationActions": {
5971#
5972# "records": [
5973#
5974# {
5975#
5976# "id": "866aad9c-9e68-4c33-b523-373bb332aea2",
5977#
5978# "actionName": "example"
5979#
5980# }
5981#
5982# ]
5983#
5984# }
5985#
5986# }
5987# }
5988#
5989# Arguments
5990# ids: Get by array of ids
5991# eventName: Get by eventName
5992# eventType: Get by eventType
5993# application: Get by application
5994# mailboxId: Get by mailboxId
5995# ownerOrganizationId: Only super-admin or orgless token can get
5996# templates by ownerOrganizationId
5997# offset: Provide an offset to skip to a certain element in the
5998# result, for paging.
5999# limit: Specify maximum number of results to retrieve in this
6000# result. Page size.
6001notificationActions(
6002ids: [ID],
6003eventName: String,
6004eventType: String,
6005application: String,
6006mailboxId: ID,
6007ownerOrganizationId: ID,
6008offset: Int,
6009limit: Int
6010): NotificationActionList
6011
6012# Retrieve Application user setting definitions
6013# Example:
6014# Request:
6015# query {
6016#
6017# getUserSettingDefinitions(application: "80354999-d633-4595-9578-d82f59a5134f") {
6018#
6019# key
6020#
6021# value
6022#
6023# }
6024# }
6025# Response:
6026# {
6027#
6028# "data": {
6029#
6030# "getUserSettingDefinitions": [
6031#
6032# {
6033#
6034# "key": "example",
6035#
6036# "value": "example"
6037#
6038# }
6039#
6040# ]
6041#
6042# }
6043# }
6044#
6045# Arguments
6046# application: Specify the applicationId
6047# key: Specify the key of user setting (optional)
6048# organizationGuid: Specify the organizationGuid (require for
6049# internal token)
6050# This can be specified by superadmin to get user setting definitions of other
6051# organization
6052getUserSettingDefinitions(
6053application: ID!,
6054key: String,
6055organizationGuid: ID
6056): [ApplicationSetting]
6057
6058# Retrive User setting
6059# Example:
6060# Request:
6061# query {
6062#
6063# getUserSettings {
6064#
6065# key
6066#
6067# applicationId
6068#
6069# }
6070# }
6071# Response:
6072# {
6073#
6074# "data": {
6075#
6076# "getUserSettings": [
6077#
6078# {
6079#
6080# "key": "example12",
6081#
6082# "applicationId": "80354999-d633-4595-9578-d82f59a5134f"
6083#
6084# }
6085#
6086# ]
6087#
6088# }
6089# }
6090#
6091# Arguments
6092# userId: Filter by userId (optional).
6093# If it's not specified, default is current user
6094# application: Filter by applicationId
6095# keys: Filter by keys
6096getUserSettings(userId: ID, application: ID, keys: [String]): [UserSetting]
6097
6098# Example:
6099# Request:
6100# query {
6101#
6102# staticAppConfig {
6103#
6104# loginUrl
6105#
6106# apiRoot
6107#
6108# }
6109# }
6110# Response:
6111# {
6112#
6113# "data": {
6114#
6115# "staticAppConfig": {
6116#
6117# "loginUrl": "https://login.veritone.com",
6118#
6119# "apiRoot": "https://api.veritone.com"
6120#
6121# }
6122#
6123# }
6124# }
6125staticAppConfig: StaticAppConfig!
6126
6127# Get OpenID Provider by id
6128openIdProvider(id: ID!): OpenIdProvider!
6129
6130# Get OpenID Provides
6131# Example:
6132# Request:
6133# query {
6134#
6135# openIdProviders {
6136#
6137# records {
6138#
6139# id
6140#
6141# isGlobal
6142#
6143# websiteUrl
6144#
6145# }
6146#
6147# }
6148# }
6149# Response:
6150# {
6151#
6152# "data": {
6153#
6154# "openIdProviders": {
6155#
6156# "records": []
6157#
6158# }
6159#
6160# }
6161# }
6162#
6163# Arguments
6164# orgId: Filter Providers by organizationId. This is only used by
6165# superadmin.
6166# If filter with org-admin role, orgId is always the current user org.
6167openIdProviders(
6168ids: [ID],
6169isGlobal: Boolean,
6170orgId: ID,
6171offset: Int,
6172limit: Int
6173): OpenIdProviderList
6174
6175# Arguments
6176# orgId: This returns all packages that the Organization has
6177# access to.
6178#
6179# ___Note: for Super-Admin use only.___
6180# resourceId: This returns packages that have the provided
6181# resource linked to it
6182# resourceAlias: This returns any packages have resources that
6183# have the alias.
6184# primaryResourceId: This returns packages that have the provided
6185# resource as its primary resource
6186# sourceOriginId: This returns the entire lineage of packages
6187# that share the same sourceOriginId.
6188#
6189# This UUID is used to track a package's lineage. This UUID and versions is NOT
6190# guaranteed to be a package ID and should not be used as such.
6191# sourcePackageId: This returns any packages that immediately
6192# derive from the provided ID.
6193#
6194# The sourcePackageId of a package refers to the package that it derived from, if
6195# any.
6196# For example, there is a lineage of packages that contain versions 1.0, 2.0, 3.0,
6197# and 4.0.
6198# If the ID of version 2.0 is provided, this filter will return the package
6199# information for
6200# only version 3.0. This is because version 3.0 is the immediate descendent of
6201# version 2.0.
6202# packageFilter: Fields to filter the results by.
6203# distributionType: This returns packages of a specific
6204# distribution type
6205# distributionTypes: This returns packages of a list of
6206# distribution types
6207# status: This returns packages with a specific status
6208# nameRegexp: Search by package name via regex pattern. By
6209# default, this search is _case sensitive_. To change this behavior,
6210# refer to the `packageFilter.caseSensitive` field.
6211# owned: If true, return only packages owned by the calling org.
6212#
6213# If false, return all packages that the calling org has access to.
6214#
6215# The default behavior when `owned` is not provided assumes `false`.
6216#
6217# __Note__: Superadmin tokens are authorized to change the `orgId` field. If
6218# provided, the above behavior will apply to `orgId` instead of the calling org.
6219# includeDeleted: If true, result includes deleted packages
6220# offset: Provide an offset to skip to a certain element in the
6221# result, for paging.
6222# limit: Specify maximum number of results to retrieve in this
6223# result. Page size.
6224packages(
6225id: ID,
6226ids: [ID!],
6227orgId: ID,
6228resourceId: ID,
6229resourceAlias: String,
6230primaryResourceId: ID,
6231sourceOriginId: ID,
6232sourcePackageId: ID,
6233packageFilter: PackageFilter,
6234distributionType: EngineDistributionType,
6235distributionTypes: [EngineDistributionType!],
6236status: PackageStatus,
6237nameRegexp: String,
6238owned: Boolean,
6239includeDeleted: Boolean,
6240offset: Int,
6241limit: Int,
6242orderBy: [PackageOrderBy!]
6243): PackageList
6244
6245# List existing package grants.
6246# Either packageId or organizationId must be specified.
6247#
6248# The following examples assume that the caller is the owner of the Packages:
6249# packageGrants(id: 123) - Show Grants for Package 123
6250# packageGrants(organizationId: 12) - Show Grants for all Packages to Org 12
6251# packageGrants(id: 123, organizationId: 12) Show Grants for Package 123 to Org 12
6252#
6253# Arguments
6254# id: Package ID. If specified, show all the Grants for this
6255# Package.
6256#
6257# If calling Org is owner of the Package, show all Grants.
6258#
6259# If calling Org is not owner of the Package, only show Grants for the Package to
6260# the calling Org.
6261#
6262# If Super-Admin, show all Grants for the Package.
6263# orgId: Show all Grants to the specified Org.
6264#
6265# If the input organizationId is different from the calling Org, this will show
6266# Grants for Packages
6267# that are owned by the calling Org to the specified Org.
6268#
6269# If the input organizationId is the same as the caller's Org, this will show
6270# Grants for Packages
6271# to the calling Org.
6272#
6273# If Super-Admin, show Grants for all Packages to the specified Org.
6274# includeDeleted: If true, result includes deleted packages
6275# offset: Provide an offset to skip to a certain element in the
6276# result, for paging.
6277# limit: Specify maximum number of results to retrieve in this
6278# result. Page size.
6279packageGrants(
6280id: ID,
6281orgId: ID,
6282includeDeleted: Boolean,
6283offset: Int,
6284limit: Int,
6285packageFilter: PackageGrantFilter
6286): PackageGrantList
6287
6288# Retrieve the basic user information.
6289# The caller and the queried user are required to be members of the same
6290# organization,
6291# unless the caller is superadmin user.
6292# Example:
6293# Request:
6294# query {
6295#
6296# basicUserInfo(id: "267de7e1-efb2-444a-a524-210328b78503") {
6297#
6298# id
6299#
6300# name
6301#
6302# firstName
6303#
6304# lastName
6305#
6306# email
6307#
6308# imageUrl
6309#
6310# }
6311# }
6312# Response:
6313# {
6314#
6315# "data": {
6316#
6317# "basicUserInfo": {
6318#
6319# "id": "267de7e1-efb2-444a-a524-210328b78503",
6320#
6321# "name": "username",
6322#
6323# "firstName": "first",
6324#
6325# "lastName": "last",
6326#
6327# "email": "email@test.com",
6328#
6329# "imageUrl": null
6330#
6331# }
6332#
6333# }
6334# }
6335#
6336# Arguments
6337# id: The user ID.
6338# A user ID is a string in UUID format.
6339basicUserInfo(id: ID!): BasicUserInfo
6340
6341apiTokens: [ApiTokenInfo]!
6342
6343# Gets the most up to date package linked to this automate flow
6344#
6345# Arguments
6346# engineId: Engine Id for the automate flow.
6347automatePackage(engineId: ID!): Package
6348
6349# Retrieve applicationViewers
6350# Example:
6351# Request:
6352# query {
6353# applicationViewers(limit:2) {
6354# records{
6355# id
6356# name
6357# }
6358# }
6359# }
6360# Response:
6361# {
6362# "data": {
6363# "viewers": {
6364# "records": [
6365# {
6366# "id": "2a1a1b58-6983-4002-b9ed-7b7f325f621a",
6367# "name": "Viewer 1"
6368# },
6369# {
6370# "id": "4a2a1b58-6993-4002-b9ed-7b7f325f662c",
6371# "name": "Viewer 2"
6372# }
6373# ]
6374# }
6375# }
6376# }
6377#
6378# Arguments
6379# ids: Provide an ids to retrieve specific viewers.
6380# offset: Specify maximum number of results to retrieve in this
6381# result. Page size.
6382# limit: Specify maximum number of results to retrieve in this
6383# result.
6384# orderBy: Provide a list of ApplicationViewerSortField to sort
6385# by.
6386# isPublic: Filter viewers that are publicly accessible across
6387# all organizations.
6388applicationViewers(
6389ids: [ID!],
6390offset: Int,
6391limit: Int,
6392orderBy: ApplicationViewerSortField,
6393isPublic: Boolean
6394): ApplicationViewerList
6395
6396# Arguments
6397# encryptionKey: Key to decrypt the stored data.
6398# fromAddress: Credential id to look up in the database.
6399platformEmailProvider(
6400encryptionKey: String,
6401fromAddress: String
6402): EmailProviderConfig
6403
6404# Retrieve email template by id.
6405emailTemplateGet(id: ID!, organizationGuid: ID): EmailTemplate
6406
6407# Retrieve a single ingest slug by source ID and fileUri.
6408#
6409# An ingest slug is a record that tracks a file through the ingestion pipeline,
6410# containing metadata about the file and its processing status. Both sourceId and
6411# fileUri are required to uniquely identify a slug.
6412#
6413# Example:
6414# query {
6415#
6416# ingestSlug(sourceId: "100", fileUri: "s3://bucket/videos/sample.mp4") {
6417#
6418# sourceId
6419#
6420# fileUri
6421#
6422# organizationId
6423#
6424# status
6425#
6426# mimeType
6427#
6428# fileSizeBytes
6429#
6430# fileCreatedAt
6431#
6432# fileModifiedAt
6433#
6434# statusMessage
6435#
6436# tdoId
6437#
6438# assetId
6439#
6440# createdAt
6441#
6442# updatedAt
6443#
6444# createdBy
6445#
6446# }
6447# }
6448#
6449# Response:
6450# {
6451#
6452# "data": {
6453#
6454# "ingestSlug": {
6455#
6456# "sourceId": "100",
6457#
6458# "fileUri": "s3://bucket/videos/sample.mp4",
6459#
6460# "organizationId": "35521",
6461#
6462# "status": "ingested",
6463#
6464# "mimeType": "video/mp4",
6465#
6466# "fileSizeBytes": 2147483648,
6467#
6468# "fileCreatedAt": "2024-01-15T10:00:00Z",
6469#
6470# "fileModifiedAt": "2024-01-15T10:30:00Z",
6471#
6472# "statusMessage": "Successfully ingested",
6473#
6474# "tdoId": "1570654874",
6475#
6476# "assetId": "1570654874_4hJtNKSUXD",
6477#
6478# "createdAt": "2024-01-15T09:00:00Z",
6479#
6480# "updatedAt": "2024-01-15T12:00:00Z",
6481#
6482# "createdBy": "550e8400-e29b-41d4-a716-446655440000"
6483#
6484# }
6485#
6486# }
6487# }
6488ingestSlug(sourceId: ID!, fileUri: String!): IngestSlug!
6489
6490# Retrieve a list of ingest slugs with optional filtering and pagination.
6491#
6492# This query supports complex filtering on status, file URIs, time ranges, and
6493# other attributes.
6494# Results are paginated and sorted by createdAt ascending. Default offset is 0 and
6495# limit is 30.
6496# The results are automatically filtered to the user's organization from their
6497# authorization context.
6498#
6499# Filter supports:
6500# - sourceId/sourceIds: Filter by media source
6501# - status: Filter by ingestion status (pending, uploaded, ingested, failed, etc.)
6502# - fileUriExact: Match exact file URIs
6503# - fileUriPrefix: Match file URIs by prefix (case-insensitive)
6504# - bundleKey: Group files by bundle identifier
6505# - batchFileUri: Associated batch file URI
6506# - tdoId/assetId: Filter by associated temporal data object or asset
6507# - mimeType: Filter by file MIME type
6508# - updatedFromTime/updatedToTime: Filter by update time range
6509# - updatedFromTimeExclusive/updatedToTimeExclusive: Use exclusive comparison
6510# operators
6511#
6512# Example 1: Get all pending ingest slugs for a specific source:
6513# query {
6514#
6515# ingestSlugs(
6516#
6517# filter: {
6518#
6519# sourceId: "100"
6520#
6521# status: ["pending"]
6522#
6523# }
6524#
6525# offset: 0
6526#
6527# limit: 10
6528#
6529# ) {
6530#
6531# records {
6532#
6533# fileUri
6534#
6535# status
6536#
6537# statusMessage
6538#
6539# fileSizeBytes
6540#
6541# mimeType
6542#
6543# bundleKey
6544#
6545# }
6546#
6547# offset
6548#
6549# limit
6550#
6551# count
6552#
6553# }
6554# }
6555#
6556# Example 2: Search for files by URI prefix and filter by time range:
6557# query {
6558#
6559# ingestSlugs(
6560#
6561# filter: {
6562#
6563# fileUriPrefix: ["s3://bucket/archive/2024-01"]
6564#
6565# updatedFromTime: "2024-01-01T00:00:00Z"
6566#
6567# updatedToTime: "2024-01-31T23:59:59Z"
6568#
6569# status: ["ingested"]
6570#
6571# }
6572#
6573# offset: 0
6574#
6575# limit: 50
6576#
6577# ) {
6578#
6579# records {
6580#
6581# sourceId
6582#
6583# fileUri
6584#
6585# organizationId
6586#
6587# status
6588#
6589# tdoId
6590#
6591# assetId
6592#
6593# updatedAt
6594#
6595# }
6596#
6597# count
6598#
6599# }
6600# }
6601#
6602# Example 3: Get ingest slugs with TDO associations:
6603# query {
6604#
6605# ingestSlugs(
6606#
6607# filter: {
6608#
6609# status: ["ingested"]
6610#
6611# tdoId: ["1570654874"]
6612#
6613# }
6614#
6615# limit: 20
6616#
6617# ) {
6618#
6619# records {
6620#
6621# sourceId
6622#
6623# fileUri
6624#
6625# status
6626#
6627# tdoId
6628#
6629# assetId
6630#
6631# tdo {
6632#
6633# id
6634#
6635# name
6636#
6637# startDateTime
6638#
6639# }
6640#
6641# }
6642#
6643# }
6644# }
6645ingestSlugs(filter: IngestSlugFilter, offset: Int, limit: Int): IngestSlugList!
6646
6647# Retrieve a single processing project by ID.
6648processingProject(id: ID!): ProcessingProject
6649
6650# Retrieve a list of processing projects with filtering and pagination.
6651processingProjects(
6652offset: Int,
6653limit: Int,
6654filter: ProcessingProjectFilter
6655): ProcessingProjectList
6656
6657# Retrieve a single processing deliverable by ID.
6658processingDeliverable(project_id: ID!, id: ID!): ProcessingDeliverable
6659
6660# Retrieve a list of processing deliverables with filtering and pagination.
6661processingDeliverables(
6662projectId: ID!,
6663offset: Int,
6664limit: Int,
6665filter: ProcessingDeliverableFilter
6666): ProcessingDeliverableList
6667
6668}

link Required by

This element is not required by anyone