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 organization.
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=EXAMPLE_AWS_ACCESS_KEY_ID%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=EXAMPLE_AWS_ACCESS_KEY_ID%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 {
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": "35521/other/2021/6/18/ed2c10a7-6f96-4d7c-a498-7bedeb383c7e_19-50-374",
3630#
3631# "url":
3632# "https://s3.amazonaws.com/prod-api.veritone.com/35521/other/2021/6/18/ed2c10a7-6f96-4d7c-a498-7bedeb383c7e_19-50-374?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"
3633#
3634# }
3635#
3636# }
3637# }
3638#
3639# Arguments
3640# key: DEPRECATED and ignored. The object key is always generated
3641# server-side.
3642# Any value supplied here is discarded; the returned `key`, `url` and
3643# `unsignedUrl` all reflect the server-generated key.
3644# type: DEPRECATED and ignored. The object key's resource-type
3645# segment is always a
3646# server-generated literal. Any value supplied here is discarded; the returned
3647# `key`, `url` and `unsignedUrl` all reflect the server-generated key.
3648# path: DEPRECATED and ignored. The object key contains no
3649# client-supplied path
3650# component. Any value supplied here is discarded. To associate an upload with
3651# a container, pass the container's ID to the mutation that consumes the URL
3652# (for example `createAsset(input: { containerId })`) rather than to this query.
3653# expiresInSeconds: Optional expiresInSeconds custom expiration
3654# to signedUrlExpires
3655# Max expiresInSeconds up to 604800
3656# organizationId: Optional organization ID. Normally this value
3657# is computed by the server
3658# based on the authorization token used for the request.
3659# Is is used only by Veritone platform components.
3660getSignedWritableUrl(
3661key: String,
3662type: String,
3663path: String,
3664expiresInSeconds: Int,
3665organizationId: ID
3666): WritableUrlInfo
3667
3668# Issue a short-lived signed PUT URL to overwrite an EXISTING asset in place.
3669# The destination bucket + key are derived server-side from the persisted asset
3670# (never from client input) and confined to buckets managed by this service, so
3671# the URL can only overwrite that specific asset object. Intended for internal
3672# platform components (e.g. core-eventing) to flush asset content without holding
3673# S3 credentials of their own. The returned `contentType` and, when non-null,
3674# `serverSideEncryption` are baked into the signature — the caller MUST send
3675# matching `Content-Type` and `x-amz-server-side-encryption` headers on the PUT.
3676# Restricted to internal service tokens and (currently) media-mdp assets.
3677#
3678# Arguments
3679# assetId: ID of the existing asset to issue a writable URL for.
3680# expiresInSeconds: Optional expiry in seconds. Clamped to the
3681# range [60, 3600]; defaults to the
3682# bucket's configured signedUrlExpires (or 900).
3683getSignedWritableAssetUrl(
3684assetId: ID!,
3685expiresInSeconds: Int
3686): SignedWritableAssetUrlInfo
3687
3688# Return writable storage URLs in bulk.
3689# A maximum of 1000 can be created in one call.
3690# See `getSignedWritableUrl` for details on usage of the
3691# response contents.
3692# Example:
3693# Request:
3694# query {
3695#
3696# getSignedWritableUrls(number: 2) {
3697#
3698# bucket
3699#
3700# key
3701#
3702# url
3703#
3704# }
3705# }
3706# Response:
3707# {
3708#
3709# "data": {
3710#
3711# "getSignedWritableUrls": [
3712#
3713# {
3714#
3715# "bucket": "prod-api.veritone.com",
3716#
3717# "key": "35521/other/2021/6/18/723ca284-cee6-4883-af16-edcbfed86433_19-19-384",
3718#
3719# "url":
3720# "https://s3.amazonaws.com/prod-api.veritone.com/35521/other/2021/6/18/723ca284-cee6-4883-af16-edcbfed86433_19-19-384?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"
3721#
3722# },
3723#
3724# {
3725#
3726# "bucket": "prod-api.veritone.com",
3727#
3728# "key": "35521/other/2021/6/18/76af4aeb-5d9b-4bc4-b1d0-251e3f57b651_19-19-384",
3729#
3730# "url":
3731# "https://s3.amazonaws.com/prod-api.veritone.com/35521/other/2021/6/18/76af4aeb-5d9b-4bc4-b1d0-251e3f57b651_19-19-384?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"
3732#
3733# }
3734#
3735# ]
3736#
3737# }
3738# }
3739#
3740# Arguments
3741# number: Number of signed URLs to return
3742# type: DEPRECATED and ignored. The object key's resource-type
3743# segment is always a
3744# server-generated literal. Any value supplied here is discarded. This query
3745# shares its key generation with `getSignedWritableUrl`, so it is deprecated
3746# on the same schedule.
3747# path: DEPRECATED and ignored. The object key contains no
3748# client-supplied path
3749# component. Any value supplied here is discarded. To associate an upload with
3750# a container, pass the container's ID to the mutation that consumes the URL
3751# (for example `createAsset(input: { containerId })`) rather than to this query.
3752# organizationId: Optional organization ID. Normally this value
3753# is computed by the server
3754# based on the authorization token used for the request.
3755# Is is used only by Veritone platform components.
3756getSignedWritableUrls(
3757number: Int!,
3758type: String,
3759path: String,
3760organizationId: ID
3761): [WritableUrlInfo!]!
3762
3763# Return the overall status for a PUT request, reporting any failures that might
3764# have occurred.
3765# Example:
3766# Request:
3767#
3768# query {
3769#
3770# getUploadStatus(input: {
3771#
3772# key:
3773#
3774# }) {
3775#
3776# status
3777#
3778# message
3779#
3780# totalBytesReceived
3781#
3782# missingChunkNumbers
3783#
3784# failures {
3785#
3786# records {
3787#
3788# chunkNumber
3789#
3790# status
3791#
3792# message
3793#
3794# }
3795#
3796# }
3797#
3798# }
3799#
3800# }
3801# Response:
3802#
3803# {
3804#
3805# "data": {
3806#
3807# "getUploadStatus":
3808#
3809# {
3810#
3811# "status": "processing",
3812#
3813# "message": "test message",
3814#
3815# "totalBytesReceived": 124000000
3816#
3817# "missingChunkNumbers": 2
3818#
3819# "faiulures": [
3820#
3821# {
3822#
3823# "chunkNumber": 4
3824#
3825# "status": "failed"
3826#
3827# "message": "error message"
3828#
3829# }
3830#
3831# ]
3832#
3833# }
3834#
3835# }
3836#
3837# }
3838#
3839# Arguments
3840# input: UploadStatus input
3841getUploadStatus(input: UploadStatusInput!): UploadStatus!
3842
3843# Retrieve the rights of the current user
3844# Example:
3845# Request:
3846# query {
3847#
3848# myRights {
3849#
3850# resources
3851#
3852# operations
3853#
3854# }
3855# }
3856# Response:
3857# {
3858#
3859# "data": {
3860#
3861# "myRights": {
3862#
3863# "resources": {},
3864#
3865# "operations": [
3866#
3867# "admin.access",
3868#
3869# "admin.org.read",
3870#
3871# "admin.org.update",
3872#
3873# "admin.user.create",
3874#
3875# "admin.user.read",
3876#
3877# "admin.user.update",
3878#
3879# "admin.user.delete",
3880#
3881# ...
3882#
3883# ]
3884#
3885# }
3886#
3887# }
3888# }
3889myRights: RightsListing
3890
3891# Retrieve the shared folders for an organization
3892# Example:
3893# Request:
3894# query {
3895#
3896# sharedFolders {
3897#
3898# id
3899#
3900# }
3901# }
3902# Response:
3903# {
3904#
3905# "data": {
3906#
3907# "sharedFolders": []
3908#
3909# }
3910# }
3911sharedFolders: [Folder]
3912
3913# Retrieve multiple watchlists
3914# Example:
3915# Request:
3916# query {
3917#
3918# watchlists(limit: 2) {
3919#
3920# records {
3921#
3922# id
3923#
3924# name
3925#
3926# }
3927#
3928# }
3929# }
3930# Response:
3931# {
3932#
3933# "data": {
3934#
3935# "watchlists": {
3936#
3937# "records": [
3938#
3939# {
3940#
3941# "id": "326916",
3942#
3943# "name": "example"
3944#
3945# },
3946#
3947# {
3948#
3949# "id": "325791",
3950#
3951# "name": "example"
3952#
3953# }
3954#
3955# ]
3956#
3957# }
3958#
3959# }
3960# }
3961#
3962# Arguments
3963# isDisabled: Set `true` to include only disabled watchlist or
3964# `false` to include only enabled watchlists. By default,
3965# both are included.
3966# names: Provide a list of names to filter folders
3967watchlists(
3968id: ID,
3969maxStopDateTime: DateTime,
3970minStopDateTime: DateTime,
3971minStartDateTime: DateTime,
3972maxStartDateTime: DateTime,
3973name: String,
3974offset: Int,
3975limit: Int,
3976orderBy: WatchlistOrderBy,
3977orderDirection: OrderDirection,
3978isDisabled: Boolean,
3979names: [String],
3980nameMatch: StringMatch
3981): WatchlistList
3982
3983# Retrieve a single watchlist by id
3984# Example:
3985# Request:
3986# query {
3987#
3988# watchlist(id: "325791") {
3989#
3990# name
3991#
3992# watchlistType
3993#
3994# }
3995# }
3996# Response:
3997# {
3998#
3999# "data": {
4000#
4001# "watchlist": {
4002#
4003# "name": "example",
4004#
4005# "watchlistType": "tracking"
4006#
4007# }
4008#
4009# }
4010# }
4011watchlist(id: ID!): Watchlist
4012
4013# Example:
4014# Request:
4015# query {
4016#
4017# mentionStatusOptions {
4018#
4019# id
4020#
4021# name
4022#
4023# }
4024# }
4025# Response:
4026# {
4027#
4028# "data": {
4029#
4030# "mentionStatusOptions": [
4031#
4032# {
4033#
4034# "id": "7",
4035#
4036# "name": "Auto Verified"
4037#
4038# },
4039#
4040# {
4041#
4042# "id": "5",
4043#
4044# "name": "Invalid"
4045#
4046# },
4047#
4048# {
4049#
4050# "id": "3",
4051#
4052# "name": "Needs Review"
4053#
4054# },
4055#
4056# {
4057#
4058# "id": "1",
4059#
4060# "name": "Pending Verification"
4061#
4062# },
4063#
4064# {
4065#
4066# "id": "6",
4067#
4068# "name": "Processing Verification"
4069#
4070# },
4071#
4072# {
4073#
4074# "id": "4",
4075#
4076# "name": "Request Bonus"
4077#
4078# },
4079#
4080# {
4081#
4082# "id": "2",
4083#
4084# "name": "Verified"
4085#
4086# }
4087#
4088# ]
4089#
4090# }
4091# }
4092mentionStatusOptions: [MentionStatus!]!
4093
4094# Retrieve multiple data registries
4095# Example:
4096# Request:
4097# query {
4098#
4099# dataRegistries(limit: 2) {
4100#
4101# records {
4102#
4103# id
4104#
4105# name
4106#
4107# }
4108#
4109# }
4110# }
4111# Response:
4112# {
4113#
4114# "data": {
4115#
4116# "dataRegistries": {
4117#
4118# "records": [
4119#
4120# {
4121#
4122# "id": "532ef261-d3a4-4c09-8fc7-0653a5131577",
4123#
4124# "name": "example"
4125#
4126# },
4127#
4128# {
4129#
4130# "id": "317c941d-30d0-455e-882b-34a26e513364",
4131#
4132# "name": "example"
4133#
4134# }
4135#
4136# ]
4137#
4138# }
4139#
4140# }
4141# }
4142dataRegistries(
4143id: ID,
4144ids: [ID!],
4145name: String,
4146nameMatch: StringMatch,
4147offset: Int,
4148limit: Int,
4149orderBy: DataRegistryOrderBy,
4150orderDirection: OrderDirection,
4151filterByOwnership: SchemaOwnership
4152): DataRegistryList
4153
4154# Retrieve a single data registry
4155# Example:
4156# Request:
4157# query {
4158#
4159# dataRegistry(id: "532ef261-d3a4-4c09-8fc7-0653a5131577") {
4160#
4161# name
4162#
4163# organizationId
4164#
4165# source
4166#
4167# }
4168# }
4169# Response:
4170# {
4171#
4172# "data": {
4173#
4174# "dataRegistry": {
4175#
4176# "name": "example",
4177#
4178# "organizationId": "35521",
4179#
4180# "source": "veritone-35521.datasets"
4181#
4182# }
4183#
4184# }
4185# }
4186dataRegistry(id: ID!): DataRegistry
4187
4188# Retrieve a subscription by id
4189# Example:
4190# Request:
4191# query {
4192#
4193# subscription(id: "275818") {
4194#
4195# isActive
4196#
4197# jsondata
4198#
4199# }
4200# }
4201# Response:
4202# {
4203#
4204# "data": {
4205#
4206# "subscription": {
4207#
4208# "isActive": true,
4209#
4210# "jsondata": {
4211#
4212# "tracking_unit_id": "325791",
4213#
4214# "creator_email": "example email",
4215#
4216# "unsubscribe_hash": "example jwt token"
4217#
4218# }
4219#
4220# }
4221#
4222# }
4223# }
4224subscription(id: ID!): Subscription!
4225
4226cognitiveSearch(id: ID!): CognitiveSearch!
4227
4228# Retrieve multiple collections
4229# Example:
4230# Request:
4231# query {
4232#
4233# collections {
4234#
4235# records {
4236#
4237# id
4238#
4239# name
4240#
4241# }
4242#
4243# }
4244# }
4245# Response:
4246# {
4247#
4248# "data": {
4249#
4250# "collections": {
4251#
4252# "records": [
4253#
4254# {
4255#
4256# "id": "241121",
4257#
4258# "name": "example"
4259#
4260# },
4261#
4262# {
4263#
4264# "id": "242599",
4265#
4266# "name": "example"
4267#
4268# },
4269#
4270# {
4271#
4272# "id": "243625",
4273#
4274# "name": "example"
4275#
4276# }
4277#
4278# ]
4279#
4280# }
4281#
4282# }
4283# }
4284collections(id: ID, name: String, mentionId: ID, offset: Int, limit: Int): CollectionList!
4285
4286# Retrieve a collection by id
4287# Example:
4288# Request:
4289# query {
4290#
4291# collection(id: "241121") {
4292#
4293# name
4294#
4295# isActive
4296#
4297# }
4298# }
4299# Response:
4300# {
4301#
4302# "data": {
4303#
4304# "collection": {
4305#
4306# "name": "example",
4307#
4308# "isActive": true
4309#
4310# }
4311#
4312# }
4313# }
4314collection(id: ID!): Collection!
4315
4316collectionMention(folderId: ID!, mentionId: ID!): CollectionMention!
4317
4318# Retrieve a list of collection mentions
4319# Specify at least one of folderId or mentionId
4320collectionMentions(
4321folderId: ID,
4322mentionId: ID,
4323orderBy: CollectionMentionOrderBy,
4324limit: Int,
4325offset: Int
4326): CollectionMentionList!
4327
4328# Retrieve multiple mentions
4329# Example:
4330# Request:
4331# query {
4332#
4333# mentions {
4334#
4335# records {
4336#
4337# id
4338#
4339# }
4340#
4341# }
4342# }
4343# Response:
4344# {
4345#
4346# "data": {
4347#
4348# "mentions": {
4349#
4350# "records": []
4351#
4352# }
4353#
4354# }
4355# }
4356#
4357# Arguments
4358# watchlistId: Get mentions created from the specified watchlist
4359# sourceId: Get mentions associated with the specified source
4360# sourceTypeId: Get mentions associated with sources of the
4361# specified source type
4362# tdoId: Get mentions associated directly with the specific TDO
4363# dateTimeFilter: Specify date/time filters against mention
4364# fields.
4365# Querying for mentions can be expensive. If the query does not
4366# include a filter by `id`, `tdoId`, `sourceId`, `watchlistId`, or
4367# a user-provided `dateTimeFilter`, a default filter of the
4368# past 7 days is applied.
4369# orderBy: Set order information on the query. Multiple fields
4370# are supported.
4371# folderId: Provide a folder ID to filter by collection
4372mentions(
4373id: ID,
4374watchlistId: ID,
4375sourceId: ID,
4376sourceTypeId: ID,
4377tdoId: ID,
4378dateTimeFilter: [MentionDateTimeFilter!],
4379orderBy: [MentionOrderBy!],
4380offset: Int,
4381limit: Int,
4382folderId: ID
4383): MentionList
4384
4385# Retrieves engine results by TDO and engine ID or by job ID.
4386# Example:
4387# Request:
4388# query {
4389#
4390# engineResults(
4391#
4392# tdoId: "1580507556",
4393#
4394# engineIds: "4") {
4395#
4396# sourceId
4397#
4398# records {
4399#
4400# tdoId
4401#
4402# }
4403#
4404# }
4405# }
4406# Response:
4407# {
4408#
4409# "data": {
4410#
4411# "engineResults": {
4412#
4413# "sourceId": null,
4414#
4415# "records": []
4416#
4417# }
4418#
4419# }
4420# }
4421#
4422# Arguments
4423# tdoId: Provide the ID of the TDO containing engine results to
4424# retrieve.
4425# If this parameter is used, engineIds or engineCategoryIds must also be set.
4426# Results for _only_ the specified TDO will be returned.
4427# sourceId: Provide the ID of the Source containing engine
4428# results to retrieve.
4429# If this parameter is used, engineIds or engineCategoryIds must also be set.
4430# This takes priority over tdoId.
4431# engineIds: Provide one or more engine IDs to retrieve engine
4432# results by
4433# ID. This parameter is mandatory if tdoId is used, but optional
4434# if jobId or engineCategory is used.
4435# engineCategoryIds: Provide one or more category IDs to get all
4436# results from that categroy.
4437# jobId: Provide a job ID to retrieve engine results for the job.
4438# mentionId: Provide a mention ID to retrieve engine results for
4439# the mention.
4440# startOffsetMs: Start offset ms for the results.
4441# stopOffsetMs: End offset ms for the results.
4442# startDate: Start date for the results. Takes priority over
4443# startOffsetMs.
4444# stopDate: End date for the results. Takes priority over
4445# stopOffsetMs.
4446# ignoreUserEdited: Whether or not to exclude user edited engine
4447# results. Defaults to false.
4448# fallbackTdoId: A TDO ID can be provided for use if the provided
4449# `sourceId` and/or
4450# `mentionId` parameters do not resolve to a logical set of TDOs.
4451# Depending on parameter settings and available data,
4452# results from other TDOs can be included in the response.
4453engineResults(
4454tdoId: ID,
4455sourceId: ID,
4456engineIds: [ID!],
4457engineCategoryIds: [ID!],
4458jobId: ID,
4459mentionId: ID,
4460startOffsetMs: Int,
4461stopOffsetMs: Int,
4462startDate: DateTime,
4463stopDate: DateTime,
4464ignoreUserEdited: Boolean,
4465fallbackTdoId: ID
4466): EngineResultList
4467
4468# Retrieve a trigger by id
4469# Example:
4470# Request:
4471# query {
4472#
4473# trigger(id: "2998") {
4474#
4475# target
4476#
4477# createdDateTime
4478#
4479# }
4480# }
4481# Response:
4482# {
4483#
4484# "data": {
4485#
4486# "trigger": {
4487#
4488# "target": "Email",
4489#
4490# "createdDateTime": "2021-06-18T13:35:08.631Z"
4491#
4492# }
4493#
4494# }
4495# }
4496trigger(id: ID!): Trigger
4497
4498# Retrieve triggers
4499# Example:
4500# Request:
4501# query {
4502#
4503# triggers {
4504#
4505# id
4506#
4507# }
4508# }
4509# Response:
4510# {
4511#
4512# "data": {
4513#
4514# "triggers": [
4515#
4516# {
4517#
4518# "id": "2998"
4519#
4520# }
4521#
4522# ]
4523#
4524# }
4525# }
4526triggers: [Trigger]
4527
4528# Fetch all saved searches that the current user has made
4529# Fetch all saved searches that have been shared with
4530# the current users organization
4531# Include any saved searches that the user has created
4532# Example:
4533# Request:
4534# query {
4535#
4536# savedSearches {
4537#
4538# records {
4539#
4540# id
4541#
4542# name
4543#
4544# }
4545#
4546# }
4547# }
4548# Response:
4549# {
4550#
4551# "data": {
4552#
4553# "savedSearches": {
4554#
4555# "records": [
4556#
4557# {
4558#
4559# "id": "3aa9fecb-d3cb-4fa5-a11b-20e02ae494b9",
4560#
4561# "name": "example"
4562#
4563# }
4564#
4565# ]
4566#
4567# }
4568#
4569# }
4570# }
4571savedSearches(
4572offset: Int,
4573limit: Int,
4574includeShared: Boolean,
4575filterByName: String,
4576orderBy: SavedSearchOrderBy,
4577orderDirection: OrderDirection
4578): SavedSearchList!
4579
4580# Retrieve a list of export requests
4581# Example:
4582# Request:
4583# query {
4584#
4585# exportRequests(limit: 2) {
4586#
4587# records {
4588#
4589# id
4590#
4591# organizationId
4592#
4593# }
4594#
4595# }
4596# }
4597# Response:
4598# {
4599#
4600# "data": {
4601#
4602# "exportRequests": {
4603#
4604# "records": [
4605#
4606# {
4607#
4608# "id": "938b2d64-6df1-486b-b6ea-29d33dee49ad",
4609#
4610# "organizationId": "35521"
4611#
4612# }
4613#
4614# ]
4615#
4616# }
4617#
4618# }
4619# }
4620#
4621# Arguments
4622# id: Provide an ID to retrieve a single export request
4623# offset: Provide an offset to skip to a certain element in the
4624# result, for paging.
4625# limit: Specify maximum number of results to retrieve in this
4626# result. Page size.
4627# status: Provide a list of status options to filter by status
4628# event: Provide an event to retrieve export request. Should be
4629# 'exportRequest' or 'mentionExportRequest'
4630# Default value is 'exportRequest'
4631exportRequests(
4632id: ID,
4633offset: Int,
4634limit: Int,
4635status: [ExportRequestStatus!],
4636event: ExportRequestEvent
4637): ExportRequestList!
4638
4639# Retrieve a single export request by id
4640# Example:
4641# Request:
4642# query {
4643#
4644# exportRequest(id: "938b2d64-6df1-486b-b6ea-29d33dee49ad") {
4645#
4646# id
4647#
4648# organizationId
4649#
4650# requestorId
4651#
4652# status
4653#
4654# }
4655# }
4656# Response:
4657# {
4658#
4659# "data": {
4660#
4661# "exportRequest": {
4662#
4663# "id": "938b2d64-6df1-486b-b6ea-29d33dee49ad",
4664#
4665# "organizationId": "35521",
4666#
4667# "requestorId": "59cb4e74-7c31-4267-b91e-d4600bc08008",
4668#
4669# "status": "complete"
4670#
4671# }
4672#
4673# }
4674# }
4675#
4676# Arguments
4677# event: Provide an event to retrieve export request. Should be
4678# 'exportRequest' or 'mentionExportRequest'
4679# Default value is 'exportRequest'
4680exportRequest(id: ID!, event: ExportRequestEvent): ExportRequest!
4681
4682# Retrieve a event by id
4683# Example:
4684# Request:
4685# query {
4686#
4687# event(id: "55fc7c51-1521-4043-902f-f0f3a357da6d") {
4688#
4689# eventName
4690#
4691# eventType
4692#
4693# description
4694#
4695# }
4696# }
4697# Response:
4698# {
4699#
4700# "data": {
4701#
4702# "event": {
4703#
4704# "eventName": "example",
4705#
4706# "eventType": "example",
4707#
4708# "description": "new example description"
4709#
4710# }
4711#
4712# }
4713# }
4714event(id: ID!): Event
4715
4716# Retrieve a list of events by application
4717# Example:
4718# Request:
4719# query {
4720#
4721# events(
4722#
4723# application: "system",
4724#
4725# limit: 2) {
4726#
4727# records {
4728#
4729# id
4730#
4731# eventName
4732#
4733# }
4734#
4735# }
4736# }
4737# Response:
4738# {
4739#
4740# "data": {
4741#
4742# "events": {
4743#
4744# "records": [
4745#
4746# {
4747#
4748# "id": "8876aa2f-1068-411d-b746-28c867c151cc",
4749#
4750# "eventName": "ActionTokenForbidden"
4751#
4752# },
4753#
4754# {
4755#
4756# "id": "d5082d0e-3c96-4c71-9f27-c679650f2adf",
4757#
4758# "eventName": "ActionUserForbidden"
4759#
4760# }
4761#
4762# ]
4763#
4764# }
4765#
4766# }
4767# }
4768#
4769# Arguments
4770# application: Provide an application to retrieve all its events.
4771# Use 'system' to list all public system events.
4772# offset: Provide an offset to skip to a certain element in the
4773# result, for paging.
4774# limit: Specify maximum number of results to retrieve in this
4775# result. Page size.
4776events(application: String!, offset: Int, limit: Int): EventList!
4777
4778# Retrieve a list of subscriptions by organization
4779# Example:
4780# Request:
4781# query {
4782#
4783# eventSubscriptions(limit: 2) {
4784#
4785# records {
4786#
4787# id
4788#
4789# eventName
4790#
4791# }
4792#
4793# }
4794# }
4795# Response:
4796# {
4797#
4798# "data": {
4799#
4800# "eventSubscriptions": {
4801#
4802# "records": [
4803#
4804# {
4805#
4806# "id": "4a81cdf7-e85b-4dc4-85ce-7c2d300cd194",
4807#
4808# "eventName": "LibraryTrain"
4809#
4810# },
4811#
4812# {
4813#
4814# "id": "c7c4a969-4500-4d7b-b77f-81b1e64bf112",
4815#
4816# "eventName": "LibraryTrain"
4817#
4818# }
4819#
4820# ]
4821#
4822# }
4823#
4824# }
4825# }
4826#
4827# Arguments
4828# ids: The event subscription ids
4829# eventName: The name of the event
4830# eventType: The type of event, such as `mention`, `job`,
4831# `engine`.
4832# offset: Provide an offset to skip to a certain element in the
4833# result, for paging.
4834# limit: Specify maximum number of results to retrieve in this
4835# result. Page size.
4836# orgId: The organization ID with which these event subscriptions
4837# are associated.
4838# appId: The application ID with which these event subscriptions
4839# are associated.
4840# scope: Event subscription scope
4841eventSubscriptions(
4842ids: [ID!],
4843eventName: String,
4844eventType: String,
4845offset: Int,
4846limit: Int,
4847orgId: ID,
4848appId: ID,
4849scope: EventSubscriptionScope
4850): EventSubscriptionList!
4851
4852# Retrieve a subscription by id
4853# Example:
4854# Request:
4855# query {
4856#
4857# eventSubscription(id: "4a81cdf7-e85b-4dc4-85ce-7c2d300cd194") {
4858#
4859# id
4860#
4861# organizationId
4862#
4863# eventName
4864#
4865# targetName
4866#
4867# }
4868# }
4869# Response:
4870# {
4871#
4872# "data": {
4873#
4874# "eventSubscription": {
4875#
4876# "id": "4a81cdf7-e85b-4dc4-85ce-7c2d300cd194",
4877#
4878# "organizationId": "35521",
4879#
4880# "eventName": "LibraryTrain",
4881#
4882# "targetName": "NotificationMailbox"
4883#
4884# }
4885#
4886# }
4887# }
4888eventSubscription(id: ID!): EventSubscription!
4889
4890# Example:
4891# Request:
4892# query {
4893#
4894# eventActionTemplate(id: "d02522d7-ef5f-448f-981a-d2cfc7603d92") {
4895#
4896# organizationId
4897#
4898# actionType
4899#
4900# name
4901#
4902# }
4903# }
4904# Response:
4905# {
4906#
4907# "data": {
4908#
4909# "eventActionTemplate": {
4910#
4911# "organizationId": "35521",
4912#
4913# "actionType": "job",
4914#
4915# "name": "example"
4916#
4917# }
4918#
4919# }
4920# }
4921eventActionTemplate(id: ID!): EventActionTemplate
4922
4923# Example:
4924# Request:
4925# query {
4926#
4927# eventActionTemplates(
4928#
4929# inputType: event,
4930#
4931# actionType: job
4932#
4933# limit:2) {
4934#
4935# records {
4936#
4937# id
4938#
4939# name
4940#
4941# }
4942#
4943# }
4944# }
4945# Response:
4946# {
4947#
4948# "data": {
4949#
4950# "eventActionTemplates": {
4951#
4952# "records": [
4953#
4954# {
4955#
4956# "id": "d02522d7-ef5f-448f-981a-d2cfc7603d92",
4957#
4958# "name": "example"
4959#
4960# },
4961#
4962# {
4963#
4964# "id": "49d28375-b6b2-418e-b965-8e939d1189ae",
4965#
4966# "name": "example"
4967#
4968# }
4969#
4970# ]
4971#
4972# }
4973#
4974# }
4975# }
4976#
4977# Arguments
4978# ownerApplicationId: The application id
4979# inputType: use "event" for now. In the future, we allow
4980# additional input_type types. For example, a schedule or a tweet.
4981# actionType: Either "job", "webhook", "sms", "email". Future
4982# action_type could be "gql" where action is purely a function call.
4983# offset: Provide an offset to skip to a certain element in the
4984# result, for paging.
4985# limit: Specify maximum number of results to retrieve in this
4986# result. Page size.
4987eventActionTemplates(
4988ownerApplicationId: ID,
4989inputType: EventActionTemplateInputType,
4990actionType: EventActionTemplateActionType,
4991offset: Int,
4992limit: Int
4993): EventActionTemplateList!
4994
4995# Example:
4996# Request:
4997# query {
4998#
4999# eventCustomRule(id: "c2c1ee13-37d2-4f92-9156-5cb1a3c59ed5") {
5000#
5001# name
5002#
5003# eventName
5004#
5005# description
5006#
5007# }
5008# }
5009# Response:
5010# {
5011#
5012# "data": {
5013#
5014# "eventCustomRule": {
5015#
5016# "name": "example",
5017#
5018# "eventName": "example",
5019#
5020# "description": "example description"
5021#
5022# }
5023#
5024# }
5025# }
5026eventCustomRule(id: ID!): EventCustomRule
5027
5028# Example:
5029# Request:
5030# query {
5031#
5032# eventCustomRules(limit: 2) {
5033#
5034# records {
5035#
5036# id
5037#
5038# name
5039#
5040# }
5041#
5042# }
5043# }
5044# Response:
5045# {
5046#
5047# "data": {
5048#
5049# "eventCustomRules": {
5050#
5051# "records": [
5052#
5053# {
5054#
5055# "id": "c2c1ee13-37d2-4f92-9156-5cb1a3c59ed5",
5056#
5057# "name": "example"
5058#
5059# }
5060#
5061# ]
5062#
5063# }
5064#
5065# }
5066# }
5067#
5068# Arguments
5069# offset: the offset to skip to a certain element in the result
5070# limit: the maximum number of rows in the results
5071eventCustomRules(offset: Int, limit: Int): EventCustomRuleList!
5072
5073# This query returns information about time zones recognized by this
5074#
5075# server. The information is static and does not change.
5076#
5077# Example:
5078#
5079# Request:
5080#
5081# query {
5082#
5083# timeZones {
5084#
5085# name
5086#
5087# abbreviations{
5088#
5089# name
5090#
5091# }
5092#
5093# }
5094# }
5095# Response:
5096# {
5097#
5098# "data": {
5099#
5100# "timeZones": [
5101#
5102# {
5103#
5104# "name": "Africa/Abidjan",
5105#
5106# "abbreviations": [
5107#
5108# {
5109#
5110# "name": "GMT"
5111#
5112# }
5113#
5114# ]
5115#
5116# },
5117#
5118# {
5119#
5120# "name": "Africa/Accra",
5121#
5122# "abbreviations": [
5123#
5124# {
5125#
5126# "name": "GMT"
5127#
5128# },
5129#
5130# {
5131#
5132# "name": "+0020"
5133#
5134# }
5135#
5136# ]
5137#
5138# },
5139#
5140# {
5141#
5142# "name": "Africa/Lagos",
5143#
5144# "abbreviations": [
5145#
5146# {
5147#
5148# "name": "WAT"
5149#
5150# }
5151#
5152# ]
5153#
5154# },
5155#
5156# ...
5157#
5158# ...
5159#
5160# ]
5161#
5162# }
5163#
5164# ]
5165#
5166# }
5167timeZones: [TimeZone!]!
5168
5169# Examine entries from the audit log. All operations that modify data are
5170# written to the audit log. Only entries for the user's own organization
5171# can be queried.
5172# All queries are bracketed by a time window. A default time window is applied
5173# if the `toDateTime` and/or `fromDateTime` parameters are not provided.
5174# The maximum time window length is 30 days.
5175# Only Veritone and organization administrators can use this query.
5176# Example:
5177# Request:
5178# query {
5179#
5180# auditLog(limit: 2) {
5181#
5182# records {
5183#
5184# id
5185#
5186# objectId
5187#
5188# description
5189#
5190# }
5191#
5192# }
5193# }
5194# Response:
5195# {
5196#
5197# "data": {
5198#
5199# "auditLog": {
5200#
5201# "records": [
5202#
5203# {
5204#
5205# "id": "735915311",
5206#
5207# "objectId": "*********",
5208#
5209# "description": "Changed password"
5210#
5211# },
5212#
5213# {
5214#
5215# "id": "735915307",
5216#
5217# "objectId": "********",
5218#
5219# "description": "Changed password"
5220#
5221# }
5222#
5223# ]
5224#
5225# }
5226#
5227# }
5228# }
5229#
5230# Arguments
5231# toDateTime: Date/time up to which entries will be returned. In
5232# other words, the
5233# end of the query time window.
5234# Defaults to the current time.
5235# fromDateTime: Date/time from which entries will be returned. In
5236# other words, the
5237# start of the query time window.
5238# Defaults to the `toDateTime` minus 7 days.
5239# organizationId: Organization ID to query records for. This
5240# value can only be used by
5241# Veritone administrators. Any value provided by user administrators will
5242# be ignored.
5243# userName: User name on audit entry. Must be exact match.
5244# clientIpAddress: IP address of the client that generated the
5245# audit action. Must be exact match.
5246# clientUserAgent: HTTP user agent of the client that generated
5247# the audit action. Must be exact match.
5248# eventType: The event type, such as `Create`, `Update`, or
5249# `Delete`.
5250# Must be exact match.
5251# objectId: The ID of the object involved in the audit action.
5252# The format of this ID
5253# varies by object type. Must be exact match.
5254# objectType: The type of the object involved in the audit
5255# action, such as `Watchlist`
5256# or `TemporalDataObject`. Must be exact match.
5257# success: Whether or not the action was successful.
5258# id: The unique ID of an audit log entry. Multiple values can be
5259# provided.
5260# offset: Offset into result set, for paging.
5261# limit: Limit on result size, for paging (page size). Audit
5262# queries are
5263# lightweight so the default of 100 is higher than the default offset
5264# used elsewhere in the API.
5265# orderBy: Order information. Default is order by
5266# `createdDateTime` descending.
5267auditLog(
5268toDateTime: DateTime,
5269fromDateTime: DateTime,
5270organizationId: ID,
5271userName: String,
5272clientIpAddress: String,
5273clientUserAgent: String,
5274eventType: String,
5275objectId: ID,
5276objectType: String,
5277success: Boolean,
5278id: [ID!],
5279offset: Int,
5280limit: Int,
5281orderBy: [AuditLogOrderBy!]
5282): AuditLogEntryList! @deprecated( reason: "No longer supported." )
5283
5284# Get the media share by media shareId
5285mediaShare(id: ID!): MediaShare!
5286
5287# Retrieve a shared collection
5288#
5289# Arguments
5290# shareId: share token
5291sharedCollection(shareId: ID!): SharedCollection
5292
5293# Retrieve shared collection history records
5294# Example:
5295# Request:
5296# query {
5297#
5298# sharedCollectionHistory(limit: 2,
5299#
5300# folderId: "d551fbd6-7354-4b0e-abfb-654ab8583be2") {
5301#
5302# records {
5303#
5304# id
5305#
5306# status
5307#
5308# shareId
5309#
5310# }
5311#
5312# }
5313# }
5314# Response:
5315# {
5316#
5317# "data": {
5318#
5319# "sharedCollectionHistory": {
5320#
5321# "records": []
5322#
5323# }
5324#
5325# }
5326# }
5327#
5328# Arguments
5329# ids: Provide an ID to retrieve a single history record
5330# folderId: Provide a folder ID to filter by collection
5331# shareId: Provide a share ID to filter by share ID
5332# offset: Specify maximum number of results to retrieve in this
5333# result. Page size.
5334# limit: Specify maximum number of results to retrieve in this
5335# result.
5336sharedCollectionHistory(
5337ids: [ID!],
5338folderId: ID,
5339shareId: String,
5340offset: Int,
5341limit: Int
5342): SharedCollectionHistoryList!
5343
5344# Get list process templates by id or current organizationId
5345# Example:
5346# Request:
5347# query {
5348#
5349# processTemplates(limit: 2) {
5350#
5351# records {
5352#
5353# id
5354#
5355# organizationId
5356#
5357# name
5358#
5359# }
5360#
5361# }
5362# }
5363# Response:
5364# {
5365#
5366# "data": {
5367#
5368# "processTemplates": {
5369#
5370# "records": [
5371#
5372# {
5373#
5374# "id": "762",
5375#
5376# "organizationId": "35521",
5377#
5378# "name": "example"
5379#
5380# }
5381#
5382# ]
5383#
5384# }
5385#
5386# }
5387# }
5388processTemplates(id: ID, offset: Int, limit: Int): ProcessTemplateList!
5389
5390# Get process templates by id
5391# Example:
5392# Request:
5393# query {
5394#
5395# processTemplate(id: "762") {
5396#
5397# name
5398#
5399# organizationId
5400#
5401# }
5402# }
5403# Response:
5404# {
5405#
5406# "data": {
5407#
5408# "processTemplate": {
5409#
5410# "name": "example",
5411#
5412# "organizationId": "35521"
5413#
5414# }
5415#
5416# }
5417# }
5418processTemplate(id: ID!): ProcessTemplate!
5419
5420# Get creative by id with current organizationId
5421# Example:
5422# Request:
5423# query {
5424#
5425# creative(id: "25209") {
5426#
5427# organizationId
5428#
5429# brandId
5430#
5431# }
5432# }
5433# Response:
5434# {
5435#
5436# "data": {
5437#
5438# "creative": {
5439#
5440# "organizationId": "35521",
5441#
5442# "brandId": null
5443#
5444# }
5445#
5446# }
5447# }
5448creative(id: ID!): Creative!
5449
5450# Retrieve list of engine classes
5451# Example:
5452# Request:
5453# query {
5454#
5455# engineClasses(limit: 2) {
5456#
5457# records {
5458#
5459# id
5460#
5461# name
5462#
5463# description
5464#
5465# }
5466#
5467# }
5468# }
5469# Response:
5470# {
5471#
5472# "data": {
5473#
5474# "engineClasses": {
5475#
5476# "records": [
5477#
5478# {
5479#
5480# "id": "e0283fdf-7f85-472e-b367-59cc8d205ba7",
5481#
5482# "name": "audio",
5483#
5484# "description": "The input to engines in the Audio class is an audio or video
5485# file or stream. If your engine processes human speech or voice, it likely
5486# belongs in the Speech class instead. Audio engines may recognize a specific
5487# audio segment, such as an advertisement, identify sounds like that of a crying
5488# baby or detect the presence of audio or music in an audio or video file, for
5489# example."
5490#
5491# },
5492#
5493# {
5494#
5495# "id": "1bcfdd35-1e9b-4694-8273-00b19510d164",
5496#
5497# "name": "biometrics",
5498#
5499# "description": "The input to engines in the Biometrics class may be an image,
5500# speech or other audio or video file or stream. By definition, the Biometrics
5501# class covers cognitive analysis related to data points from the human body.
5502# Biometrics engines may detect or recognize faces, identify face attributes to
5503# estimate a person's age or ethnicity or verify a person based on their unique
5504# iris, for example."
5505#
5506# }
5507#
5508# ]
5509#
5510# }
5511#
5512# }
5513# }
5514#
5515# Arguments
5516# id: Provide an ID to retrieve a single specific engine class.
5517# name: Provide a name, or part of one, to search by class name
5518# offset: Specify maximum number of results to retrieve in this
5519# result. Page size.
5520# limit: Specify maximum number of results to retrieve in this
5521# result.
5522engineClasses(id: ID, name: String, offset: Int, limit: Int): EngineClassList
5523
5524# Retrieve a specific engine class
5525# Example:
5526# Request:
5527# query {
5528#
5529# engineClass(id: "e0283fdf-7f85-472e-b367-59cc8d205ba7") {
5530#
5531# id
5532#
5533# name
5534#
5535# description
5536#
5537# }
5538# }
5539# Response:
5540# {
5541#
5542# "data": {
5543#
5544# "engineClass": {
5545#
5546# "id": "e0283fdf-7f85-472e-b367-59cc8d205ba7",
5547#
5548# "name": "audio",
5549#
5550# "description": "The input to engines in the Audio class is an audio or video
5551# file or stream. If your engine processes human speech or voice, it likely
5552# belongs in the Speech class instead. Audio engines may recognize a specific
5553# audio segment, such as an advertisement, identify sounds like that of a crying
5554# baby or detect the presence of audio or music in an audio or video file, for
5555# example."
5556#
5557# }
5558#
5559# }
5560# }
5561#
5562# Arguments
5563# id: Supply the ID of the engine class to retrieve
5564engineClass(id: ID!): EngineClass
5565
5566# Retrieve list entity tags where tag key contains user input
5567# Example:
5568# Request:
5569# query {
5570#
5571# matchEntityTags(input: { tagKey: "test"}) {
5572#
5573# records {
5574#
5575# tagKey
5576#
5577# tagValue
5578#
5579# }
5580#
5581# }
5582# }
5583# Response:
5584# {
5585#
5586# "data": {
5587#
5588# "matchEntityTags": {
5589#
5590# "records": [
5591#
5592# {
5593#
5594# "tagKey": "test-tag",
5595#
5596# "tagValue": "test-value"
5597#
5598# },
5599#
5600# {
5601#
5602# "tagKey": "another-testtag",
5603#
5604# "tagValue": ""
5605#
5606# },
5607#
5608# ]
5609#
5610# }
5611#
5612# }
5613# }
5614#
5615# Arguments
5616# input: User provided text and entity type input.
5617# offset: Specify maximum number of results to retrieve in this
5618# result. Page size.
5619# limit: Specify maximum number of results to retrieve in this
5620# result.
5621matchEntityTags(input: MatchEntityTagInput!, offset: Int, limit: Int): MatchedEntityTagsList
5622
5623# Returns all custom dashboards created by user
5624# Example:
5625# Request:
5626# query {
5627#
5628# customDashboards {
5629#
5630# records {
5631#
5632# id
5633#
5634# description
5635#
5636# hostAppId
5637#
5638# }
5639#
5640# }
5641# }
5642# Response:
5643# {
5644#
5645# "data": {
5646#
5647# "customDashboards": {
5648#
5649# "records": [
5650#
5651# {
5652#
5653# "id": "a20ae938-e827-4b0b-a62a-6c9af0b98cc9",
5654#
5655# "description": "example",
5656#
5657# "hostAppId": "80354999-d633-4595-9578-d82f59a5134f"
5658#
5659# }
5660#
5661# ]
5662#
5663# }
5664#
5665# }
5666# }
5667#
5668# Arguments
5669# offset: Provide an offset to skip to a certain element in the
5670# result, for paging.
5671# limit: Specify maximum number of results to retrieve in this
5672# result. Page size.
5673# hostAppId: Include only dashboards created by specific
5674# host_app_id
5675customDashboards(offset: Int, limit: Int, hostAppId: ID): CustomDashboardList
5676
5677# Returns custom dashboard by id
5678# Example:
5679# Request:
5680# query {
5681#
5682# customDashboard(id: "a20ae938-e827-4b0b-a62a-6c9af0b98cc9") {
5683#
5684# hostAppId
5685#
5686# name
5687#
5688# }
5689# }
5690# Response:
5691# {
5692#
5693# "data": {
5694#
5695# "customDashboard": {
5696#
5697# "hostAppId": "80354999-d633-4595-9578-d82f59a5134f",
5698#
5699# "name": "example"
5700#
5701# }
5702#
5703# }
5704# }
5705customDashboard(id: ID!): CustomDashboard
5706
5707# Gets engine usage for an organization based on their billing type.
5708# Example:
5709# Request:
5710# query {
5711#
5712# getUsageByTaskType {
5713#
5714# totalDuration
5715#
5716# totalCost
5717#
5718# }
5719# }
5720# Response:
5721# {
5722#
5723# "data": {
5724#
5725# "getUsageByTaskType": {
5726#
5727# "totalDuration": 0,
5728#
5729# "totalCost": "0"
5730#
5731# }
5732#
5733# }
5734# }
5735getUsageByTaskType: UsageByTaskType!
5736
5737# Retrives the specific Dataset
5738#
5739# Arguments
5740# id: Supply the ID of the Dataset to retrieve
5741dataset(id: ID!): Dataset
5742
5743# Retrieve list of Datasets
5744# Example:
5745# Request:
5746# query {
5747#
5748# datasets(limit:2, filter: {operation:OR}) {
5749#
5750# records {
5751#
5752# datasetId
5753#
5754# name
5755#
5756# }
5757#
5758# }
5759# }
5760# Response:
5761# {
5762#
5763# "data": {
5764#
5765# "datasets": {
5766#
5767# "records": []
5768#
5769# }
5770#
5771# }
5772# }
5773#
5774# Arguments
5775# offset: Provide an offset to skip to a certain element in the
5776# result, for paging.
5777# limit: Specify maximum number of results to retrieve in this
5778# result. Page size.
5779# filter: Filters for Dataset attributes
5780datasets(offset: Int, limit: Int, filter: DatasetFilter): DatasetList
5781
5782# Arguments
5783# datasetId: Supply the ID of the Dataset to retrieve
5784# offset: Provide an offset to skip to a certain element in the
5785# result, for paging.
5786# limit: Specify maximum number of results to retrieve in this
5787# result. Page size.
5788# filter: Query to filter SDO. Supports operations such as and,
5789# or, eq, gt, lt, etc.
5790# TODO link to syntax documentation
5791# orderBy: Order by
5792datasetDataQuery(
5793datasetId: ID!,
5794offset: Int,
5795limit: Int,
5796filter: JSONData,
5797orderBy: [StructuredDataOrderBy!]
5798): DatasetEntryList!
5799
5800# Retrive list of Engine Replacement
5801# Example:
5802# Request:
5803# query {
5804#
5805# taskReplacementEngines {
5806#
5807# records {
5808#
5809# sourceEngineId
5810#
5811# replacementEngineId
5812#
5813# }
5814#
5815# }
5816# }
5817# Response:
5818# {
5819#
5820# "data": {
5821#
5822# "taskReplacementEngines": {
5823#
5824# "records": [
5825#
5826# {
5827#
5828# "sourceEngineId": "1",
5829#
5830# "replacementEngineId": "2"
5831#
5832# }
5833#
5834# ]
5835#
5836# }
5837#
5838# }
5839# }
5840#
5841# Arguments
5842# organizationId: Only superadmin can get engine replacement of
5843# other orgs
5844# engineId: Filter by the source engineId
5845# offset: Provide an offset to skip to a certain element in the
5846# result, for paging.
5847# limit: Specify maximum number of results to retrieve in this
5848# result. Page size.
5849taskReplacementEngines(
5850organizationId: ID,
5851engineId: ID,
5852offset: Int,
5853limit: Int
5854): TaskReplacementEngineList
5855
5856# Retrive Notification Mailboxes by list of mailboxIds
5857# Example:
5858# Request:
5859# query {
5860#
5861# notificationMailboxes {
5862#
5863# id
5864#
5865# name
5866#
5867# }
5868# }
5869# Response:
5870# {
5871#
5872# "data": {
5873#
5874# "notificationMailboxes": [
5875#
5876# {
5877#
5878# "id": "6fda80b5-3d1a-4eb8-bd32-277be5104149",
5879#
5880# "name": "example"
5881#
5882# },
5883#
5884# {
5885#
5886# "id": "d20e9f37-a887-41bb-aed0-3268884ecebc",
5887#
5888# "name": "Library training mailbox"
5889#
5890# },
5891#
5892# {
5893#
5894# "id": "2d29533b-560e-4354-b794-84f823d33205",
5895#
5896# "name": "Library training mailbox"
5897#
5898# }
5899#
5900# ]
5901#
5902# }
5903# }
5904notificationMailboxes(ids: [ID!], name: String): [NotificationMailbox!]
5905
5906# Retrive Notification Templates
5907# Example:
5908# Request:
5909# query {
5910#
5911# notificationTemplates(limit: 2) {
5912#
5913# records {
5914#
5915# id
5916#
5917# eventName
5918#
5919# }
5920#
5921# }
5922# }
5923# Response:
5924# {
5925#
5926# "data": {
5927#
5928# "notificationTemplates": {
5929#
5930# "records": [
5931#
5932# {
5933#
5934# "id": "3947b833-2be4-4415-8272-2cee62fbca23",
5935#
5936# "eventName": "example"
5937#
5938# }
5939#
5940# ]
5941#
5942# }
5943#
5944# }
5945# }
5946#
5947# Arguments
5948# ids: Get by array of ids
5949# eventName: Get by eventName
5950# eventType: Get by eventType
5951# application: Get by application
5952# mailboxId: Get by mailboxId
5953# ownerOrganizationId: Only super-admin or orgless token can get
5954# templates by ownerOrganizationId
5955# offset: Provide an offset to skip to a certain element in the
5956# result, for paging.
5957# limit: Specify maximum number of results to retrieve in this
5958# result. Page size.
5959notificationTemplates(
5960ids: [ID],
5961eventName: String,
5962eventType: String,
5963application: String,
5964mailboxId: ID,
5965ownerOrganizationId: ID,
5966offset: Int,
5967limit: Int
5968): NotificationTemplateList
5969
5970# Retrieve Notification Actions
5971# Example:
5972# Request:
5973# query {
5974#
5975# notificationActions {
5976#
5977# records {
5978#
5979# id
5980#
5981# actionName
5982#
5983# }
5984#
5985# }
5986# }
5987# Response:
5988# {
5989#
5990# "data": {
5991#
5992# "notificationActions": {
5993#
5994# "records": [
5995#
5996# {
5997#
5998# "id": "866aad9c-9e68-4c33-b523-373bb332aea2",
5999#
6000# "actionName": "example"
6001#
6002# }
6003#
6004# ]
6005#
6006# }
6007#
6008# }
6009# }
6010#
6011# Arguments
6012# ids: Get by array of ids
6013# eventName: Get by eventName
6014# eventType: Get by eventType
6015# application: Get by application
6016# mailboxId: Get by mailboxId
6017# ownerOrganizationId: Only super-admin or orgless token can get
6018# templates by ownerOrganizationId
6019# offset: Provide an offset to skip to a certain element in the
6020# result, for paging.
6021# limit: Specify maximum number of results to retrieve in this
6022# result. Page size.
6023notificationActions(
6024ids: [ID],
6025eventName: String,
6026eventType: String,
6027application: String,
6028mailboxId: ID,
6029ownerOrganizationId: ID,
6030offset: Int,
6031limit: Int
6032): NotificationActionList
6033
6034# Retrieve Application user setting definitions
6035# Example:
6036# Request:
6037# query {
6038#
6039# getUserSettingDefinitions(application: "80354999-d633-4595-9578-d82f59a5134f") {
6040#
6041# key
6042#
6043# value
6044#
6045# }
6046# }
6047# Response:
6048# {
6049#
6050# "data": {
6051#
6052# "getUserSettingDefinitions": [
6053#
6054# {
6055#
6056# "key": "example",
6057#
6058# "value": "example"
6059#
6060# }
6061#
6062# ]
6063#
6064# }
6065# }
6066#
6067# Arguments
6068# application: Specify the applicationId
6069# key: Specify the key of user setting (optional)
6070# organizationGuid: Specify the organizationGuid (require for
6071# internal token)
6072# This can be specified by superadmin to get user setting definitions of other
6073# organization
6074getUserSettingDefinitions(
6075application: ID!,
6076key: String,
6077organizationGuid: ID
6078): [ApplicationSetting]
6079
6080# Retrive User setting
6081# Example:
6082# Request:
6083# query {
6084#
6085# getUserSettings {
6086#
6087# key
6088#
6089# applicationId
6090#
6091# }
6092# }
6093# Response:
6094# {
6095#
6096# "data": {
6097#
6098# "getUserSettings": [
6099#
6100# {
6101#
6102# "key": "example12",
6103#
6104# "applicationId": "80354999-d633-4595-9578-d82f59a5134f"
6105#
6106# }
6107#
6108# ]
6109#
6110# }
6111# }
6112#
6113# Arguments
6114# userId: Filter by userId (optional).
6115# If it's not specified, default is current user
6116# application: Filter by applicationId
6117# keys: Filter by keys
6118getUserSettings(userId: ID, application: ID, keys: [String]): [UserSetting]
6119
6120# Example:
6121# Request:
6122# query {
6123#
6124# staticAppConfig {
6125#
6126# loginUrl
6127#
6128# apiRoot
6129#
6130# }
6131# }
6132# Response:
6133# {
6134#
6135# "data": {
6136#
6137# "staticAppConfig": {
6138#
6139# "loginUrl": "https://login.veritone.com",
6140#
6141# "apiRoot": "https://api.veritone.com"
6142#
6143# }
6144#
6145# }
6146# }
6147staticAppConfig: StaticAppConfig!
6148
6149# Get OpenID Provider by id
6150openIdProvider(id: ID!): OpenIdProvider!
6151
6152# Get OpenID Provides
6153# Example:
6154# Request:
6155# query {
6156#
6157# openIdProviders {
6158#
6159# records {
6160#
6161# id
6162#
6163# isGlobal
6164#
6165# websiteUrl
6166#
6167# }
6168#
6169# }
6170# }
6171# Response:
6172# {
6173#
6174# "data": {
6175#
6176# "openIdProviders": {
6177#
6178# "records": []
6179#
6180# }
6181#
6182# }
6183# }
6184#
6185# Arguments
6186# orgId: Filter Providers by organizationId. This is only used by
6187# superadmin.
6188# If filter with org-admin role, orgId is always the current user org.
6189openIdProviders(
6190ids: [ID],
6191isGlobal: Boolean,
6192orgId: ID,
6193offset: Int,
6194limit: Int
6195): OpenIdProviderList
6196
6197# Arguments
6198# orgId: This returns all packages that the Organization has
6199# access to.
6200#
6201# ___Note: for Super-Admin use only.___
6202# resourceId: This returns packages that have the provided
6203# resource linked to it
6204# resourceAlias: This returns any packages have resources that
6205# have the alias.
6206# primaryResourceId: This returns packages that have the provided
6207# resource as its primary resource
6208# sourceOriginId: This returns the entire lineage of packages
6209# that share the same sourceOriginId.
6210#
6211# This UUID is used to track a package's lineage. This UUID and versions is NOT
6212# guaranteed to be a package ID and should not be used as such.
6213# sourcePackageId: This returns any packages that immediately
6214# derive from the provided ID.
6215#
6216# The sourcePackageId of a package refers to the package that it derived from, if
6217# any.
6218# For example, there is a lineage of packages that contain versions 1.0, 2.0, 3.0,
6219# and 4.0.
6220# If the ID of version 2.0 is provided, this filter will return the package
6221# information for
6222# only version 3.0. This is because version 3.0 is the immediate descendent of
6223# version 2.0.
6224# packageFilter: Fields to filter the results by.
6225# distributionType: This returns packages of a specific
6226# distribution type
6227# distributionTypes: This returns packages of a list of
6228# distribution types
6229# status: This returns packages with a specific status
6230# nameRegexp: Search by package name via regex pattern. By
6231# default, this search is _case sensitive_. To change this behavior,
6232# refer to the `packageFilter.caseSensitive` field.
6233# owned: If true, return only packages owned by the calling org.
6234#
6235# If false, return all packages that the calling org has access to.
6236#
6237# The default behavior when `owned` is not provided assumes `false`.
6238#
6239# __Note__: Superadmin tokens are authorized to change the `orgId` field. If
6240# provided, the above behavior will apply to `orgId` instead of the calling org.
6241# includeDeleted: If true, result includes deleted packages
6242# offset: Provide an offset to skip to a certain element in the
6243# result, for paging.
6244# limit: Specify maximum number of results to retrieve in this
6245# result. Page size.
6246packages(
6247id: ID,
6248ids: [ID!],
6249orgId: ID,
6250resourceId: ID,
6251resourceAlias: String,
6252primaryResourceId: ID,
6253sourceOriginId: ID,
6254sourcePackageId: ID,
6255packageFilter: PackageFilter,
6256distributionType: EngineDistributionType,
6257distributionTypes: [EngineDistributionType!],
6258status: PackageStatus,
6259nameRegexp: String,
6260owned: Boolean,
6261includeDeleted: Boolean,
6262offset: Int,
6263limit: Int,
6264orderBy: [PackageOrderBy!]
6265): PackageList
6266
6267# List existing package grants.
6268# Either packageId or organizationId must be specified.
6269#
6270# The following examples assume that the caller is the owner of the Packages:
6271# packageGrants(id: 123) - Show Grants for Package 123
6272# packageGrants(organizationId: 12) - Show Grants for all Packages to Org 12
6273# packageGrants(id: 123, organizationId: 12) Show Grants for Package 123 to Org 12
6274#
6275# Arguments
6276# id: Package ID. If specified, show all the Grants for this
6277# Package.
6278#
6279# If calling Org is owner of the Package, show all Grants.
6280#
6281# If calling Org is not owner of the Package, only show Grants for the Package to
6282# the calling Org.
6283#
6284# If Super-Admin, show all Grants for the Package.
6285# orgId: Show all Grants to the specified Org.
6286#
6287# If the input organizationId is different from the calling Org, this will show
6288# Grants for Packages
6289# that are owned by the calling Org to the specified Org.
6290#
6291# If the input organizationId is the same as the caller's Org, this will show
6292# Grants for Packages
6293# to the calling Org.
6294#
6295# If Super-Admin, show Grants for all Packages to the specified Org.
6296# includeDeleted: If true, result includes deleted packages
6297# offset: Provide an offset to skip to a certain element in the
6298# result, for paging.
6299# limit: Specify maximum number of results to retrieve in this
6300# result. Page size.
6301packageGrants(
6302id: ID,
6303orgId: ID,
6304includeDeleted: Boolean,
6305offset: Int,
6306limit: Int,
6307packageFilter: PackageGrantFilter
6308): PackageGrantList
6309
6310# Retrieve the basic user information.
6311# The caller and the queried user are required to be members of the same
6312# organization,
6313# unless the caller is superadmin user.
6314# Example:
6315# Request:
6316# query {
6317#
6318# basicUserInfo(id: "267de7e1-efb2-444a-a524-210328b78503") {
6319#
6320# id
6321#
6322# name
6323#
6324# firstName
6325#
6326# lastName
6327#
6328# email
6329#
6330# imageUrl
6331#
6332# }
6333# }
6334# Response:
6335# {
6336#
6337# "data": {
6338#
6339# "basicUserInfo": {
6340#
6341# "id": "267de7e1-efb2-444a-a524-210328b78503",
6342#
6343# "name": "username",
6344#
6345# "firstName": "first",
6346#
6347# "lastName": "last",
6348#
6349# "email": "email@test.com",
6350#
6351# "imageUrl": null
6352#
6353# }
6354#
6355# }
6356# }
6357#
6358# Arguments
6359# id: The user ID.
6360# A user ID is a string in UUID format.
6361basicUserInfo(id: ID!): BasicUserInfo
6362
6363apiTokens: [ApiTokenInfo]!
6364
6365# Gets the most up to date package linked to this automate flow
6366#
6367# Arguments
6368# engineId: Engine Id for the automate flow.
6369automatePackage(engineId: ID!): Package
6370
6371# Retrieve applicationViewers
6372# Example:
6373# Request:
6374# query {
6375# applicationViewers(limit:2) {
6376# records{
6377# id
6378# name
6379# }
6380# }
6381# }
6382# Response:
6383# {
6384# "data": {
6385# "viewers": {
6386# "records": [
6387# {
6388# "id": "2a1a1b58-6983-4002-b9ed-7b7f325f621a",
6389# "name": "Viewer 1"
6390# },
6391# {
6392# "id": "4a2a1b58-6993-4002-b9ed-7b7f325f662c",
6393# "name": "Viewer 2"
6394# }
6395# ]
6396# }
6397# }
6398# }
6399#
6400# Arguments
6401# ids: Provide an ids to retrieve specific viewers.
6402# offset: Specify maximum number of results to retrieve in this
6403# result. Page size.
6404# limit: Specify maximum number of results to retrieve in this
6405# result.
6406# orderBy: Provide a list of ApplicationViewerSortField to sort
6407# by.
6408# isPublic: Filter viewers that are publicly accessible across
6409# all organizations.
6410applicationViewers(
6411ids: [ID!],
6412offset: Int,
6413limit: Int,
6414orderBy: ApplicationViewerSortField,
6415isPublic: Boolean
6416): ApplicationViewerList
6417
6418# Arguments
6419# encryptionKey: Key to decrypt the stored data.
6420# fromAddress: Credential id to look up in the database.
6421platformEmailProvider(
6422encryptionKey: String,
6423fromAddress: String
6424): EmailProviderConfig
6425
6426# Retrieve email template by id.
6427emailTemplateGet(id: ID!, organizationGuid: ID): EmailTemplate
6428
6429# Retrieve a single ingest slug by source ID and fileUri.
6430#
6431# An ingest slug is a record that tracks a file through the ingestion pipeline,
6432# containing metadata about the file and its processing status. Both sourceId and
6433# fileUri are required to uniquely identify a slug.
6434#
6435# Example:
6436# query {
6437#
6438# ingestSlug(sourceId: "100", fileUri: "s3://bucket/videos/sample.mp4") {
6439#
6440# sourceId
6441#
6442# fileUri
6443#
6444# organizationId
6445#
6446# status
6447#
6448# mimeType
6449#
6450# fileSizeBytes
6451#
6452# fileCreatedAt
6453#
6454# fileModifiedAt
6455#
6456# statusMessage
6457#
6458# tdoId
6459#
6460# assetId
6461#
6462# createdAt
6463#
6464# updatedAt
6465#
6466# createdBy
6467#
6468# }
6469# }
6470#
6471# Response:
6472# {
6473#
6474# "data": {
6475#
6476# "ingestSlug": {
6477#
6478# "sourceId": "100",
6479#
6480# "fileUri": "s3://bucket/videos/sample.mp4",
6481#
6482# "organizationId": "35521",
6483#
6484# "status": "ingested",
6485#
6486# "mimeType": "video/mp4",
6487#
6488# "fileSizeBytes": 2147483648,
6489#
6490# "fileCreatedAt": "2024-01-15T10:00:00Z",
6491#
6492# "fileModifiedAt": "2024-01-15T10:30:00Z",
6493#
6494# "statusMessage": "Successfully ingested",
6495#
6496# "tdoId": "1570654874",
6497#
6498# "assetId": "1570654874_4hJtNKSUXD",
6499#
6500# "createdAt": "2024-01-15T09:00:00Z",
6501#
6502# "updatedAt": "2024-01-15T12:00:00Z",
6503#
6504# "createdBy": "550e8400-e29b-41d4-a716-446655440000"
6505#
6506# }
6507#
6508# }
6509# }
6510ingestSlug(sourceId: ID!, fileUri: String!): IngestSlug!
6511
6512# Retrieve a list of ingest slugs with optional filtering and pagination.
6513#
6514# This query supports complex filtering on status, file URIs, time ranges, and
6515# other attributes.
6516# Results are paginated and sorted by createdAt ascending. Default offset is 0 and
6517# limit is 30.
6518# The results are automatically filtered to the user's organization from their
6519# authorization context.
6520#
6521# Filter supports:
6522# - sourceId/sourceIds: Filter by media source
6523# - status: Filter by ingestion status (pending, uploaded, ingested, failed, etc.)
6524# - fileUriExact: Match exact file URIs
6525# - fileUriPrefix: Match file URIs by prefix (case-insensitive)
6526# - bundleKey: Group files by bundle identifier
6527# - batchFileUri: Associated batch file URI
6528# - tdoId/assetId: Filter by associated temporal data object or asset
6529# - mimeType: Filter by file MIME type
6530# - updatedFromTime/updatedToTime: Filter by update time range
6531# - updatedFromTimeExclusive/updatedToTimeExclusive: Use exclusive comparison
6532# operators
6533#
6534# Example 1: Get all pending ingest slugs for a specific source:
6535# query {
6536#
6537# ingestSlugs(
6538#
6539# filter: {
6540#
6541# sourceId: "100"
6542#
6543# status: ["pending"]
6544#
6545# }
6546#
6547# offset: 0
6548#
6549# limit: 10
6550#
6551# ) {
6552#
6553# records {
6554#
6555# fileUri
6556#
6557# status
6558#
6559# statusMessage
6560#
6561# fileSizeBytes
6562#
6563# mimeType
6564#
6565# bundleKey
6566#
6567# }
6568#
6569# offset
6570#
6571# limit
6572#
6573# count
6574#
6575# }
6576# }
6577#
6578# Example 2: Search for files by URI prefix and filter by time range:
6579# query {
6580#
6581# ingestSlugs(
6582#
6583# filter: {
6584#
6585# fileUriPrefix: ["s3://bucket/archive/2024-01"]
6586#
6587# updatedFromTime: "2024-01-01T00:00:00Z"
6588#
6589# updatedToTime: "2024-01-31T23:59:59Z"
6590#
6591# status: ["ingested"]
6592#
6593# }
6594#
6595# offset: 0
6596#
6597# limit: 50
6598#
6599# ) {
6600#
6601# records {
6602#
6603# sourceId
6604#
6605# fileUri
6606#
6607# organizationId
6608#
6609# status
6610#
6611# tdoId
6612#
6613# assetId
6614#
6615# updatedAt
6616#
6617# }
6618#
6619# count
6620#
6621# }
6622# }
6623#
6624# Example 3: Get ingest slugs with TDO associations:
6625# query {
6626#
6627# ingestSlugs(
6628#
6629# filter: {
6630#
6631# status: ["ingested"]
6632#
6633# tdoId: ["1570654874"]
6634#
6635# }
6636#
6637# limit: 20
6638#
6639# ) {
6640#
6641# records {
6642#
6643# sourceId
6644#
6645# fileUri
6646#
6647# status
6648#
6649# tdoId
6650#
6651# assetId
6652#
6653# tdo {
6654#
6655# id
6656#
6657# name
6658#
6659# startDateTime
6660#
6661# }
6662#
6663# }
6664#
6665# }
6666# }
6667ingestSlugs(filter: IngestSlugFilter, offset: Int, limit: Int): IngestSlugList!
6668
6669# Retrieve a single processing project by ID.
6670processingProject(id: ID!): ProcessingProject
6671
6672# Retrieve a list of processing projects with filtering and pagination.
6673processingProjects(
6674offset: Int,
6675limit: Int,
6676filter: ProcessingProjectFilter
6677): ProcessingProjectList
6678
6679# Retrieve a single processing deliverable by ID.
6680processingDeliverable(project_id: ID!, id: ID!): ProcessingDeliverable
6681
6682# Retrieve a list of processing deliverables with filtering and pagination.
6683processingDeliverables(
6684projectId: ID!,
6685offset: Int,
6686limit: Int,
6687filter: ProcessingDeliverableFilter
6688): ProcessingDeliverableList
6689
6690}

link Required by

This element is not required by anyone