How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Flatfile subpackage_jobs API

The subpackage_jobs API from Flatfile — 12 operation(s) for subpackage_jobs.

Flatfile subpackage_jobs API is one of 32 APIs that Flatfile publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and a getting-started guide.

This API exposes 17 operations across 12 paths, and defines 142 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against a single base URL, https://api.x.flatfile.com/v1.

17 operations 12 paths 142 schemas 1 DELETE3 GET2 PATCH10 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://api.x.flatfile.com/v1
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Flatfile subpackage_jobs API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (default).

Paths & Operations 17

Across 12 paths, the API surfaces 17 operations — 1 DELETE, 3 GET, 2 PATCH, 10 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

subpackage_jobs 17
GET
/jobs
List jobs
list 12 params → 200
POST
/jobs
Create a job
create 2 params body → 200
GET
/jobs/{jobId}
Get a job
get 3 params → 200
PATCH
/jobs/{jobId}
Update a job
update 3 params body → 200
DELETE
/jobs/{jobId}
Delete a job
delete 3 params → 200
POST
/jobs/{jobId}/execute
Execute a job
execute 3 params → 200
GET
/jobs/{jobId}/plan
Get a job's execution plan
get-execution-plan 3 params → 200
PUT
/jobs/{jobId}/plan
Replace a job's plan
update-execution-plan 3 params body → 200
PATCH
/jobs/{jobId}/plan
Update a job's plan
update-execution-plan-fields 3 params body → 200
POST
/jobs/{jobId}/ack
Acknowledge a job
ack 3 params body → 200
POST
/jobs/{jobId}/outcome/ack
Acknowledge a job outcome
ack-outcome 3 params → 200
POST
/jobs/{jobId}/complete
Complete a job
complete 3 params body → 200
POST
/jobs/{jobId}/fail
Fail a job
fail 3 params body → 200
POST
/jobs/{jobId}/cancel
Cancel a job
cancel 3 params body → 200
POST
/jobs/{jobId}/retry
Retry a failed job
retry 3 params → 200
POST
/jobs/preview-mutation
Preview a mutation
preview-mutation 2 params body → 200
POST
/jobs/{jobId}/split
Split a job
split 3 params body → 200

Schemas 142

The contract defines 142 schemas that model the data the API accepts and returns. The most detailed are type_jobs:Job (31 properties), type_commons:Action (25 properties), type_jobs:JobConfig (23 properties), type_jobs:BulkMutateFlagsJobConfig (11 properties). Each schema is shown below with its type and property counts.

type_jobs:JobOutcomeTriggerAudience
string
For whom the job outcome's next effect should be triggered automatically
type_records:CellConfig
object
CellConfig
1 property
type_property:FieldAppearance
object
Control the appearance of this field when it's displayed in a table or input
1 property
type_records:ValidationSource
string
type_records:ValidationType
string
type_data-clips:RemovedFromMainResolution
string
type_jobs:JobPartExecution
string
type_jobs:Driver
string
The driver to use for extracting data from the file
type_jobs:FlagMutationConfigData
object
Flag data for mutation operations
3 properties 1 required
type_jobs:JobType
string
The type of job
type_property:ReferenceFilter
object
If provided, the reference filter will narrow the set of records in the reference sheet used as the set of valid values for the record. Only rows where the val…
2 properties 2 required
type_commons:Filter
string
Options to filter records
type_jobs:JobAckDetails
object
Details about the user who acknowledged the job
3 properties
type_commons:ActionMessage
object
2 properties 2 required
type_commons:EnvironmentId
string
Environment ID
type_property:StringConfig
object
1 property 1 required
type_jobs:JobOutcomeTriggerType
string
Whether a job outcome's effect should be triggered automatically
type_commons:ActionConstraint
type_commons:ActionMount
type_jobs:PipelineJobConfig
object
3 properties 2 required
type_jobs:ExportJobConfig
object
1 property 1 required
type_jobs:JobPartsArray
array
Data for each of the job parts
type_jobs:JobExecutionPlan
object
The execution plan for a job, for example, for a map job, the execution plan is the mapping of the source sheet to the destination sheet.
4 properties 3 required
type_commons:InputEnumPropertyOption
object
6 properties 1 required
type_commons:Pagination
object
pagination info
3 properties 3 required
type_jobs:MutateJobConfig
object
11 properties 2 required
type_jobs:Edge
object
5 properties 2 required
type_commons:AppId
string
App ID
type_commons:SortDirection
string
Sort direction - asc (ascending) or desc (descending)
type_jobs:JobOutcomeTriggerDetails
object
Details about the trigger for the job outcome
2 properties 1 required
type_records:DiffRecord
object
9 properties 2 required
type_jobs:JobSubject
Subject parameters for this job type
type_records:RecordConfig
object
Configuration of a record or specific fields in the record
3 properties
type_property:Constraint
type_records:CellValueUnion
type_data-clips:ResolveTo
string
type_jobs:JobOutcomeNextFileObject
object
2 properties 1 required
type_jobs:Metadata
object
4 properties
type_jobs:JobSource
string
The id of a file, workbook, sheet, or app
type_jobs:Certainty
string
type_jobs:AiGenerateBlueprintConstraintsJobConfig
object
2 properties 2 required
type_jobs:JobCancelDetails
object
Info about the reason the job was canceled
1 property
type_property:FieldSize
string
The default visual sizing. This sizing may be overridden by a user
type_commons:InputConstraintType
string
type_agent-exports:AgentExportType
string
The different export type formats available.
type_data-clips:Resolve
object
Conflict resolutions for a record
6 properties
type_jobs:JobCompleteDetails
object
Outcome summary of a job
2 properties
type_jobs:AiGenerateConstraintJobConfig
object
3 properties 2 required
type_commons:RecordId
string
Record ID
type_jobs:JobMode
string
the mode of the job
type_commons:SearchValue
string
Search for the given value, returning matching rows. For exact matches, wrap the value in double quotes ("Bob"). To search for null values, send empty double q…
type_commons:ActionId
string
Action ID
type_jobs:EmptyObject
object
type_jobs:AiGenerateSampleDataJobConfig
object
2 properties 2 required
type_data-clips:ResolveType
string
type_jobs:DestinationField
object
2 properties 1 required
type_commons:InputField
object
7 properties 3 required
type_jobs:JobPlan
object
The job/plan tuple that contains the full plan and the jobs status
2 properties 2 required
type_jobs:EnumValue
type_jobs:JobConfig
object
A single unit of work that a pipeline will execute
23 properties 3 required
type_jobs:MappingFromPreprocessingJobConfig
object
2 properties 2 required
type_jobs:EnumDetails
object
Only available if one or more of the destination fields is of type enum. Provides category mapping.
3 properties 1 required
type_jobs:JobSplitDetails
object
Info about the reason the job was split
2 properties 1 required
type_jobs:JobParts
Info about the number of parts to create
type_commons:SpaceId
string
Space ID
type_jobs:AiGenerateBlueprintJobConfig
object
2 properties 2 required
type_commons:SortField
string
Name of field by which to sort records
type_jobs:JobDestination
The id of the workbook where extracted file data will be sent
type_jobs:JobExecutionPlanRequest
object
6 properties 5 required
type_jobs:JobExecutionPlanConfigRequest
object
6 properties 2 required
type_jobs:BulkMutateFlagsJobConfig
object
The configuration for a bulk flag mutation job
11 properties 2 required
type_commons:DataClipId
string
Data Clip ID
type_commons:Success
object
Informs whether or not a request was successful
1 property
type_commons:CommitId
string
Commit ID
type_property:EnumPropertyOption
object
8 properties 1 required
type_commons:Guide
object
1 property 1 required
type_jobs:JobOutcome
object
Outcome summary of a job
7 properties
type_jobs:AiRuleCreationJobConfig
object
Configuration for AI-powered rule creation jobs that generate or replace field constraints
5 properties 3 required
type_jobs:CompanyResearchJobConfig
object
The configuration for a company research job
3 properties 1 required
type_jobs:ListJobsResponse
object
2 properties 1 required
type_property:NumberConfig
object
1 property
type_jobs:Job
object
A single unit of work that will execute asynchronously
31 properties 7 required
type_property:RequiredConstraintConfig
object
2 properties
type_commons:FileId
string
File ID
type_commons:ActionMessageType
string
type_jobs:ConfigureDemoJobConfig
object
The configuration for an onboarding job
1 property 1 required
type_commons:SheetId
string
Sheet ID
type_jobs:AddRecordsToDataClipJobConfig
object
The configuration for an add records to DataClip job
2 properties 2 required
type_jobs:RunRunbookJobConfig
object
2 properties 2 required
type_commons:RunbookId
string
Runbook ID
type_commons:InputFormType
string
type_commons:InputConfig
object
1 property 1 required
type_commons:JobId
string
Pipeline Job ID
type_flags:FlagOperation
string
The type of flag operation to perform
type_commons:SearchField
string
Use this to narrow the searchValue results to a specific field
type_jobs:DeleteRecordsJobConfig
object
The configuration for a delete job
8 properties 1 required
type_property:BooleanPropertyConfig
object
1 property 1 required
type_commons:Action
object
25 properties 1 required
type_property:ReferencePropertyRelationship
string
type_commons:JSONPathString
string
A JSONPath string - https://www.rfc-editor.org/rfc/rfc9535
type_property:EnumPropertySortBy
string
type_jobs:JobOutcomeNext
type_property:ReferenceListPropertyConfig
object
3 properties 2 required
type_commons:VersionId
string
Version ID
type_commons:ActorId
string
Actor ID
type_commons:FilterField
string
Use this to narrow the valid/error filter results to a specific field
type_jobs:FindAndReplaceJobConfig
object
10 properties 1 required
type_jobs:UpdateDataClipResolutionsJobConfig
object
Configuration for a data clip resolution job
6 properties 6 required
type_jobs:ExportOptions
object
10 properties
type_property:StoredConstraint
object
5 properties 1 required
type_jobs:Trigger
string
The type of trigger to use for this job
type_jobs:JobStatus
string
the status of the job
type_commons:ActionMode
string
Foreground actions will prevent interacting with the resource until complete
type_commons:WorkbookId
string
Workbook ID
type_commons:ActionSchedule
string
type_property:StringConfigOptions
string
How much text should be storeable in this field
type_property:UniqueConstraintConfig
object
4 properties
type_records:DiffData
object
type_records:DiffValue
object
10 properties
type_commons:InputConstraint
object
1 property 1 required
type_jobs:AgentExportJobConfig
object
The configuration for an agent export job
1 property 1 required
type_commons:InputForm
object
2 properties 2 required
type_jobs:CategoryMapping
object
2 properties
type_jobs:JobPlanResponse
object
1 property 1 required
type_jobs:MappingProgramJobConfig
object
4 properties 3 required
type_commons:SuccessData
object
1 property 1 required
type_jobs:CaptureRoutineJobConfig
object
2 properties 2 required
type_jobs:JobUpdate
object
A single unit of work that will be executed
6 properties
type_jobs:AgentPromotionJobConfig
object
The configuration for an agent promotion job
2 properties 2 required
type_jobs:FileJobConfig
object
3 properties 1 required
type_jobs:FlagMutationConfig
object
Configuration for flag mutation operations
4 properties 3 required
type_property:EnumPropertyConfig
object
3 properties 1 required
type_jobs:SourceField
object
2 properties 1 required
type_property:ReferencePropertyConfig
object
4 properties 2 required
type_records:DiffRecords
array
List of DiffRecord objects
type_commons:Guardrail
object
1 property 1 required
type_records:ValidationMessage
object
Record data validation messages
5 properties
type_jobs:JobResponse
object
1 property 1 required
type_jobs:JobUpdateConfig
type_jobs:JobOutcomeTrigger
type_property:Property
type_records:DiffRecordsResponse
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

flatfile-subpackage-jobs-api-openapi.yml Raw ↑

Other APIs Flatfile publishes across the network.

Flatfile subpackage_accounts API
Flatfile subpackage_actions API
Flatfile subpackage_agent-exports API
Flatfile subpackage_agents API
Flatfile subpackage_apps API
Flatfile subpackage_assistant API
Flatfile subpackage_auth API
Flatfile subpackage_canvas-areas API
Flatfile subpackage_commits API
Flatfile subpackage_data-clips API
Flatfile subpackage_data-retention-policies API
Flatfile subpackage_documents API
Where this information came from

This is an independent, third-party profile of Flatfile subpackage_jobs API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.