Fail a job

POST

Fail a job and return the job

Path parameters

jobIdstringRequired

ID of job to return

Headers

X-Disable-Hooks"true"Required

Request

This endpoint expects an optional object.

outcomeobjectOptional

Outcome summary of a job

infostringOptional

Response

This endpoint returns an object.

dataobject

A single unit of work that will execute asynchronously

POST

1 curl -X POST https://api.x.flatfile.com/v1/jobs/us_jb_YOUR_ID/fail \
2      -H "X-Disable-Hooks: true" \
3      -H "Authorization: Bearer <token>" \
4      -H "Content-Type: application/json" \
5      -d '{
6   "outcome": {
7     "acknowledge": true,
8     "buttonText": "Acknowledge",
9     "next": {
10       "type": "id",
11       "id": "us_jb_YOUR_ID"
12     },
13     "heading": "Failed",
14     "message": "Job failed"
15   },
16   "info": "Job was failed"
17 }'

200Example0

1 {
2   "data": {
3     "createdAt": "2023-10-30T20:04:28.556Z",
4     "id": "us_jb_YOUR_ID",
5     "operation": "submitAction",
6     "source": "us_wb_YOUR_ID",
7     "type": "workbook",
8     "updatedAt": "2023-10-30T20:04:32.075Z",
9     "config": {},
10     "destination": "us_wb_YOUR_ID",
11     "environmentId": "us_env_YOUR_ID",
12     "fileId": "us_fl_YOUR_ID",
13     "finishedAt": "2023-10-30T20:04:32.074Z",
14     "info": "Starting job to submit action to webhook.site",
15     "input": {},
16     "managed": true,
17     "mode": "foreground",
18     "outcome": {
19       "message": "Data was successfully submitted to Webhook.site. Go check it out at https://example.site/example."
20     },
21     "progress": 100,
22     "startedAt": "2023-10-30T20:04:29.453Z",
23     "status": "complete",
24     "subject": {
25       "type": "resource",
26       "id": "us_wb_YOUR_ID"
27     },
28     "trigger": "immediate"
29   }
30 }

Built with

1	curl -X POST https://api.x.flatfile.com/v1/jobs/us_jb_YOUR_ID/fail \
2	-H "X-Disable-Hooks: true" \
3	-H "Authorization: Bearer <token>" \
4	-H "Content-Type: application/json" \
5	-d '{
6	"outcome": {
7	"acknowledge": true,
8	"buttonText": "Acknowledge",
9	"next": {
10	"type": "id",
11	"id": "us_jb_YOUR_ID"
12	},
13	"heading": "Failed",
14	"message": "Job failed"
15	},
16	"info": "Job was failed"
17	}'

1	{
2	"data": {
3	"createdAt": "2023-10-30T20:04:28.556Z",
4	"id": "us_jb_YOUR_ID",
5	"operation": "submitAction",
6	"source": "us_wb_YOUR_ID",
7	"type": "workbook",
8	"updatedAt": "2023-10-30T20:04:32.075Z",
9	"config": {},
10	"destination": "us_wb_YOUR_ID",
11	"environmentId": "us_env_YOUR_ID",
12	"fileId": "us_fl_YOUR_ID",
13	"finishedAt": "2023-10-30T20:04:32.074Z",
14	"info": "Starting job to submit action to webhook.site",
15	"input": {},
16	"managed": true,
17	"mode": "foreground",
18	"outcome": {
19	"message": "Data was successfully submitted to Webhook.site. Go check it out at https://example.site/example."
20	},
21	"progress": 100,
22	"startedAt": "2023-10-30T20:04:29.453Z",
23	"status": "complete",
24	"subject": {
25	"type": "resource",
26	"id": "us_wb_YOUR_ID"
27	},
28	"trigger": "immediate"
29	}
30	}