Skip to content

Commit fe6f5ed

Browse files
shortcutsshortcuts
authored
feat(specs): add v2 endpoints for ingestion (#3410)
1 parent a317528 commit fe6f5ed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

46 files changed

+595
-114
lines changed

‎specs/ingestion/common/schemas/task.yml

Lines changed: 93 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,48 @@
11
Task:
22
type: object
33
additionalProperties: false
4+
properties:
5+
taskID:
6+
$ref: './common.yml#/taskID'
7+
sourceID:
8+
$ref: './common.yml#/sourceID'
9+
destinationID:
10+
$ref: './common.yml#/destinationID'
11+
cron:
12+
$ref: '#/Cron'
13+
lastRun:
14+
$ref: '#/LastRun'
15+
nextRun:
16+
$ref: '#/NextRun'
17+
input:
18+
$ref: '#/TaskInput'
19+
enabled:
20+
type: boolean
21+
default: true
22+
description: Whether the task is enabled.
23+
failureThreshold:
24+
$ref: '#/failureThreshold'
25+
action:
26+
$ref: '#/ActionType'
27+
cursor:
28+
$ref: './common.yml#/cursor'
29+
createdAt:
30+
$ref: './common.yml#/createdAt'
31+
updatedAt:
32+
$ref: './common.yml#/updatedAt'
33+
required:
34+
- taskID
35+
- sourceID
36+
- destinationID
37+
- enabled
38+
- action
39+
- createdAt
40+
41+
TaskV1:
42+
type: object
43+
additionalProperties: false
44+
deprecated: true
45+
description: The V1 task object, please use methods and types that don't contain the V1 suffix.
446
properties:
547
taskID:
648
$ref: './common.yml#/taskID'
@@ -47,6 +89,34 @@ TaskCreate:
4789
type: object
4890
additionalProperties: false
4991
description: API request body for creating a task.
92+
properties:
93+
sourceID:
94+
$ref: './common.yml#/sourceID'
95+
destinationID:
96+
$ref: './common.yml#/destinationID'
97+
action:
98+
$ref: '#/ActionType'
99+
cron:
100+
$ref: '#/Cron'
101+
enabled:
102+
type: boolean
103+
description: Whether the task is enabled.
104+
failureThreshold:
105+
$ref: '#/failureThreshold'
106+
input:
107+
$ref: '#/TaskInput'
108+
cursor:
109+
$ref: './common.yml#/cursor'
110+
required:
111+
- sourceID
112+
- destinationID
113+
- action
114+
115+
TaskCreateV1:
116+
type: object
117+
additionalProperties: false
118+
deprecated: true
119+
description: API request body for creating a task using the V1 shape, please use methods and types that don't contain the V1 suffix.
50120
properties:
51121
sourceID:
52122
$ref: './common.yml#/sourceID'
@@ -95,6 +165,24 @@ TaskUpdate:
95165
type: object
96166
additionalProperties: false
97167
description: API request body for updating a task.
168+
properties:
169+
destinationID:
170+
$ref: './common.yml#/destinationID'
171+
cron:
172+
$ref: '#/Cron'
173+
input:
174+
$ref: '#/TaskInput'
175+
enabled:
176+
type: boolean
177+
description: Whether the task is enabled.
178+
failureThreshold:
179+
$ref: '#/failureThreshold'
180+
181+
TaskUpdateV1:
182+
type: object
183+
additionalProperties: false
184+
deprecated: true
185+
description: API request body for updating a task using the V1 shape, please use methods and types that don't contain the V1 suffix.
98186
properties:
99187
destinationID:
100188
$ref: './common.yml#/destinationID'
@@ -188,6 +276,10 @@ LastRun:
188276
description: The last time the scheduled task ran in RFC 3339 format.
189277
type: string
190278

279+
NextRun:
280+
description: The next scheduled run of the task in RFC 3339 format.
281+
type: string
282+
191283
Cron:
192284
type: string
193285
description: Cron expression for the task's schedule.
@@ -224,8 +316,7 @@ ScheduleTrigger:
224316
lastRun:
225317
$ref: '#/LastRun'
226318
nextRun:
227-
description: The next scheduled run of the task in RFC 3339 format.
228-
type: string
319+
$ref: '#/NextRun'
229320
required:
230321
- type
231322
- cron

‎specs/ingestion/paths/authentications/authentications.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ get:
33
- authentications
44
summary: List authentication resources
55
description: Retrieves a list of all authentication resources.
6-
operationId: getAuthentications
6+
operationId: listAuthentications
77
x-acl:
88
- addObject
99
- deleteIndex

‎specs/ingestion/paths/destinations/destinations.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ get:
33
- destinations
44
summary: List destinations
55
description: Retrieves a list of destinations.
6-
operationId: getDestinations
6+
operationId: listDestinations
77
x-acl:
88
- addObject
99
- deleteIndex

‎specs/ingestion/paths/runs/events/events.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ get:
33
- observability
44
summary: List task run events
55
description: Retrieves a list of events for a task run, identified by it's ID.
6-
operationId: getEvents
6+
operationId: listEvents
77
x-acl:
88
- addObject
99
- deleteIndex

‎specs/ingestion/paths/runs/runs.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ get:
33
- observability
44
summary: List task runs
55
description: Retrieve a list of task runs.
6-
operationId: getRuns
6+
operationId: listRuns
77
x-acl:
88
- addObject
99
- deleteIndex

‎specs/ingestion/paths/sources/sources.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ get:
33
- sources
44
summary: List sources
55
description: Retrieves a list of sources.
6-
operationId: getSources
6+
operationId: listSources
77
x-acl:
88
- addObject
99
- deleteIndex

‎specs/ingestion/paths/tasks/v1/disableTask.yml

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
put:
2+
tags:
3+
- tasks
4+
summary: Disable a task
5+
description: Disables a task using the v1 endpoint, please use `disableTask` instead.
6+
operationId: disableTaskV1
7+
deprecated: true
8+
x-acl:
9+
- addObject
10+
- deleteIndex
11+
- editSettings
12+
parameters:
13+
- $ref: '../../../common/parameters.yml#/pathTaskID'
14+
responses:
15+
'200':
16+
description: OK
17+
content:
18+
application/json:
19+
schema:
20+
$ref: '../../../common/schemas/task.yml#/TaskUpdateResponse'
21+
'400':
22+
$ref: '../../../../common/responses/BadRequest.yml'

‎specs/ingestion/paths/tasks/v1/enableTask.yml

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
put:
2+
tags:
3+
- tasks
4+
summary: Enable a task
5+
description: Enables a task using the v1 endpoint, please use `enableTask` instead.
6+
operationId: enableTaskV1
7+
x-acl:
8+
- addObject
9+
- deleteIndex
10+
- editSettings
11+
parameters:
12+
- $ref: '../../../common/parameters.yml#/pathTaskID'
13+
responses:
14+
'200':
15+
description: OK
16+
content:
17+
application/json:
18+
schema:
19+
$ref: '../../../common/schemas/task.yml#/TaskUpdateResponse'
20+
'400':
21+
$ref: '../../../../common/responses/BadRequest.yml'

‎specs/ingestion/paths/tasks/v1/runTask.yml

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
post:
2+
tags:
3+
- tasks
4+
summary: Run a task
5+
description: Runs a task using the v1 endpoint, please use `runTask` instead. You can check the status of task runs with the observability endpoints.
6+
operationId: runTaskV1
7+
x-acl:
8+
- addObject
9+
- deleteIndex
10+
- editSettings
11+
parameters:
12+
- $ref: '../../../common/parameters.yml#/pathTaskID'
13+
responses:
14+
'200':
15+
description: OK
16+
content:
17+
application/json:
18+
schema:
19+
$ref: '../../../common/schemas/run.yml#/RunResponse'
20+
'400':
21+
$ref: '../../../../common/responses/BadRequest.yml'

‎specs/ingestion/paths/tasks/v1/searchTasks.yml

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
post:
2+
tags:
3+
- tasks
4+
summary: Search for tasks
5+
description: Searches for tasks using the v1 endpoint, please use `searchTasks` instead.
6+
operationId: searchTasksV1
7+
x-acl:
8+
- addObject
9+
- deleteIndex
10+
- editSettings
11+
requestBody:
12+
content:
13+
application/json:
14+
schema:
15+
$ref: '../../../common/schemas/task.yml#/TaskSearch'
16+
required: true
17+
responses:
18+
'200':
19+
description: OK
20+
content:
21+
application/json:
22+
schema:
23+
title: searchTasksResponseV1
24+
type: array
25+
items:
26+
$ref: '../../../common/schemas/task.yml#/TaskV1'
27+
'400':
28+
$ref: '../../../../common/responses/BadRequest.yml'

‎specs/ingestion/paths/tasks/v1/taskID.yml

Lines changed: 64 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,64 @@
1+
get:
2+
tags:
3+
- tasks
4+
summary: Retrieve a task
5+
description: Retrieves a task by its ID using the v1 endpoint, please use `getTask` instead.
6+
operationId: getTaskV1
7+
x-acl:
8+
- addObject
9+
- deleteIndex
10+
- editSettings
11+
parameters:
12+
- $ref: '../../../common/parameters.yml#/pathTaskID'
13+
responses:
14+
'200':
15+
description: OK
16+
content:
17+
application/json:
18+
schema:
19+
$ref: '../../../common/schemas/task.yml#/TaskV1'
20+
'400':
21+
$ref: '../../../../common/responses/BadRequest.yml'
22+
23+
patch:
24+
tags:
25+
- tasks
26+
summary: Update a task
27+
description: Updates a task by its ID using the v1 endpoint, please use `updateTask` instead.
28+
operationId: updateTaskV1
29+
parameters:
30+
- $ref: '../../../common/parameters.yml#/pathTaskID'
31+
x-codegen-request-body-name: taskUpdate
32+
requestBody:
33+
content:
34+
application/json:
35+
schema:
36+
$ref: '../../../common/schemas/task.yml#/TaskUpdateV1'
37+
required: true
38+
responses:
39+
'200':
40+
description: OK
41+
content:
42+
application/json:
43+
schema:
44+
$ref: '../../../common/schemas/task.yml#/TaskUpdateResponse'
45+
'400':
46+
$ref: '../../../../common/responses/BadRequest.yml'
47+
48+
delete:
49+
tags:
50+
- tasks
51+
summary: Delete a task
52+
description: Deletes a task by its ID using the v1 endpoint, please use `deleteTask` instead.
53+
operationId: deleteTaskV1
54+
parameters:
55+
- $ref: '../../../common/parameters.yml#/pathTaskID'
56+
responses:
57+
'200':
58+
description: OK
59+
content:
60+
application/json:
61+
schema:
62+
$ref: '../../../common/schemas/common.yml#/DeleteResponse'
63+
'400':
64+
$ref: '../../../../common/responses/BadRequest.yml'

0 commit comments

Comments
 (0)