> ## Documentation Index > Fetch the complete documentation index at: https://docs.extole.com/llms.txt > Use this file to discover all available pages before exploring further. # Get a task > Returns the task for the specified id. ## OpenAPI ````yaml /api-reference/management.json get /v6/jobs/{jobId}/tasks/{taskId} openapi: 3.0.1 info: description: >- Configuration endpoints for the Extole platform: campaigns, components, audiences, persons, rewards, reporting, integrations setup, and administrative tooling. title: Management API version: '1.0' servers: - description: Production url: https://api.extole.io security: - HEADER: [] - QUERY: [] - COOKIE: [] tags: - name: Audiences - name: Authentication - name: Batch Jobs - name: Blocks - name: Campaigns - name: Components - name: Components Operations - name: Components Settings - name: Domains - name: Email - name: Erasure - name: Event Streams - name: File Validation Monitors - name: Optout - name: Profiles - name: Promotion Links - name: Report Schedules - name: Report Types - name: Reports - name: Reward Suppliers - name: Security Keys - name: Settings - name: User Notifications - name: User Subscriptions - name: Users - name: Webhooks paths: /v6/jobs/{jobId}/tasks/{taskId}: get: tags: - File Validation Monitors summary: Get a task description: Returns the task for the specified id. operationId: getTask parameters: - description: >- The unique identifier of the job that owns the task. Use the reserved value `unattached` to address tasks that are not attached to any job, which happens when a component defines a task whose `parent_job_id` expression evaluates to nothing. in: path name: jobId required: true schema: type: string - in: path name: taskId required: true schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/TaskResponse' description: Successful response '400': content: application/json: examples: binding_error: $ref: '#/components/examples/binding_error' invalid_json: $ref: '#/components/examples/invalid_json' invalid_parameter: $ref: '#/components/examples/invalid_parameter' missing_request_body: $ref: '#/components/examples/missing_request_body' task_order_out_of_range: $ref: '#/components/examples/task_order_out_of_range' task_type_mismatch: $ref: '#/components/examples/task_type_mismatch' schema: $ref: '#/components/schemas/RestExceptionResponse' description: Bad Request '401': content: application/json: examples: method_unauthorized: $ref: '#/components/examples/method_unauthorized' schema: $ref: '#/components/schemas/RestExceptionResponse' description: Unauthorized '402': content: application/json: examples: payment_required: $ref: '#/components/examples/payment_required' schema: $ref: '#/components/schemas/RestExceptionResponse' description: Payment Required '403': content: application/json: examples: access_denied: $ref: '#/components/examples/access_denied' method_unauthorized: $ref: '#/components/examples/method_unauthorized' missing_access_token: $ref: '#/components/examples/missing_access_token' schema: $ref: '#/components/schemas/RestExceptionResponse' description: Forbidden '415': content: application/json: examples: unsupported_media_type: $ref: '#/components/examples/unsupported_media_type' schema: $ref: '#/components/schemas/RestExceptionResponse' description: Unsupported Media Type '429': content: application/json: examples: too_many_requests: $ref: '#/components/examples/too_many_requests' schema: $ref: '#/components/schemas/RestExceptionResponse' description: Too Many Requests components: schemas: TaskResponse: description: >- Stored task definition. Field `order` is unevaluated and appears in buildtime-evaluatable form. discriminator: mapping: FILE_HEADER_VALIDATOR: $ref: '#/components/schemas/FileHeaderValidatorTaskResponse' START_AUDIENCE_OPERATION: $ref: '#/components/schemas/StartAudienceOperationTaskResponse' START_BATCH_JOB: $ref: '#/components/schemas/StartBatchJobTaskResponse' propertyName: task_type oneOf: - $ref: '#/components/schemas/FileHeaderValidatorTaskResponse' - $ref: '#/components/schemas/StartAudienceOperationTaskResponse' - $ref: '#/components/schemas/StartBatchJobTaskResponse' required: - component_ids - component_references - id - order - parent_job_id - task_type RestExceptionResponse: description: Represents the API error response properties: code: description: Specific error code for this error type, documented per endpoint type: string http_status_code: description: >- HTTP status code that was returned with this error, useful if client get response code format: int32 type: integer message: description: User readable English description of the error type: string parameters: additionalProperties: description: >- Attributes related to the error, varies be error code, documented per endpoint type: object description: >- Attributes related to the error, varies be error code, documented per endpoint type: object unique_id: description: >- Unique id associated with this error, useful for discussions with Extole type: string required: - code - http_status_code - message - parameters - unique_id type: object FileHeaderValidatorTaskResponse: allOf: - $ref: '#/components/schemas/TaskResponseBase' - properties: expected_headers: $ref: >- #/components/schemas/ExpectedHeadersInFileHeaderValidatorTaskResponse match_mode: enum: - EXACT_SET - ORDERED - SUBSET type: string on_mismatch: $ref: '#/components/schemas/OnMismatchInFileHeaderValidatorTaskResponse' task_type: enum: - FILE_HEADER_VALIDATOR type: string type: object description: >- Stored file header validator task definition. Fields `order`, `expected_headers`, and `on_mismatch` are unevaluated and appear in buildtime-evaluatable form. required: - component_ids - component_references - expected_headers - id - match_mode - on_mismatch - order - parent_job_id - task_type type: object StartAudienceOperationTaskResponse: allOf: - $ref: '#/components/schemas/TaskResponseBase' - properties: task_type: enum: - START_AUDIENCE_OPERATION type: string description: >- Stored start audience operation task definition. Field `order` is unevaluated and appears in buildtime-evaluatable form. required: - component_ids - component_references - id - order - parent_job_id - task_type type: object StartBatchJobTaskResponse: allOf: - $ref: '#/components/schemas/TaskResponseBase' - properties: data_source_type: enum: - AUDIENCE_LIST - FILE_ASSET - REPORT type: string event_name: $ref: '#/components/schemas/EventNameInStartBatchJobTaskResponse' task_type: enum: - START_BATCH_JOB type: string type: object description: >- Stored start batch job task definition. Fields `order` and `event_name` are unevaluated and appear in buildtime-evaluatable form. required: - component_ids - component_references - data_source_type - event_name - id - order - parent_job_id - task_type type: object TaskResponseBase: properties: component_ids: items: type: string type: array component_references: items: $ref: '#/components/schemas/ComponentReferenceResponse' type: array id: description: Unique id of the task. readOnly: true type: string order: $ref: '#/components/schemas/OrderInTaskResponse' parent_job_id: $ref: '#/components/schemas/ParentJobIdInTaskResponse' task_type: enum: - FILE_HEADER_VALIDATOR - START_AUDIENCE_OPERATION - START_BATCH_JOB type: string type: object ExpectedHeadersInFileHeaderValidatorTaskResponse: description: >- Headers the validated file is expected to contain. A literal value or a buildtime expression resolved from component references when the task is saved. Buildtime expressions use [JobBuildtimeContext](https://github.com/extole/extole-specification/blob/main/openapi/expression-context/com/extole/api/jobs/built/JobBuildtimeContext.d.ts). externalDocs: description: JobBuildtimeContext url: >- https://github.com/extole/extole-specification/blob/main/openapi/expression-context/com/extole/api/jobs/built/JobBuildtimeContext.d.ts oneOf: - description: Literal expected headers items: description: >- Headers the validated file is expected to contain. A literal value or a buildtime expression resolved from component references when the task is saved. type: string title: Static Value type: array - description: >- Handlebars expression with [JobBuildtimeContext](https://github.com/extole/extole-specification/blob/main/openapi/expression-context/com/extole/api/jobs/built/JobBuildtimeContext.d.ts). example: handlebars@buildtime:{{expectedHeaders}} externalDocs: description: JobBuildtimeContext url: >- https://github.com/extole/extole-specification/blob/main/openapi/expression-context/com/extole/api/jobs/built/JobBuildtimeContext.d.ts pattern: ^handlebars@buildtime:.* title: Buildtime - Handlebars type: string - description: >- Javascript expression with [JobBuildtimeContext](https://github.com/extole/extole-specification/blob/main/openapi/expression-context/com/extole/api/jobs/built/JobBuildtimeContext.d.ts). example: >- javascript@buildtime:function() { return context.getVariableContext().get('expectedHeaders');} externalDocs: description: JobBuildtimeContext url: >- https://github.com/extole/extole-specification/blob/main/openapi/expression-context/com/extole/api/jobs/built/JobBuildtimeContext.d.ts pattern: ^javascript@buildtime:.* title: Buildtime - Javascript type: string OnMismatchInFileHeaderValidatorTaskResponse: description: >- Action taken when the headers do not match. A literal value or a buildtime expression resolved from component references when the task is saved. Buildtime expressions use [JobBuildtimeContext](https://github.com/extole/extole-specification/blob/main/openapi/expression-context/com/extole/api/jobs/built/JobBuildtimeContext.d.ts). externalDocs: description: JobBuildtimeContext url: >- https://github.com/extole/extole-specification/blob/main/openapi/expression-context/com/extole/api/jobs/built/JobBuildtimeContext.d.ts oneOf: - description: Literal on mismatch enum: - FAIL - WARN title: Static Value type: string - description: >- Handlebars expression with [JobBuildtimeContext](https://github.com/extole/extole-specification/blob/main/openapi/expression-context/com/extole/api/jobs/built/JobBuildtimeContext.d.ts). example: handlebars@buildtime:{{onMismatch}} externalDocs: description: JobBuildtimeContext url: >- https://github.com/extole/extole-specification/blob/main/openapi/expression-context/com/extole/api/jobs/built/JobBuildtimeContext.d.ts pattern: ^handlebars@buildtime:.* title: Buildtime - Handlebars type: string - description: >- Javascript expression with [JobBuildtimeContext](https://github.com/extole/extole-specification/blob/main/openapi/expression-context/com/extole/api/jobs/built/JobBuildtimeContext.d.ts). example: >- javascript@buildtime:function() { return context.getVariableContext().get('onMismatch');} externalDocs: description: JobBuildtimeContext url: >- https://github.com/extole/extole-specification/blob/main/openapi/expression-context/com/extole/api/jobs/built/JobBuildtimeContext.d.ts pattern: ^javascript@buildtime:.* title: Buildtime - Javascript type: string EventNameInStartBatchJobTaskResponse: description: >- Name of the event dispatched for every row the batch job consumes. A literal value or a buildtime expression resolved from component references when the task is saved. Absent for a batch job that takes the event per row from its data source instead. Buildtime expressions use [JobBuildtimeContext](https://github.com/extole/extole-specification/blob/main/openapi/expression-context/com/extole/api/jobs/built/JobBuildtimeContext.d.ts). externalDocs: description: JobBuildtimeContext url: >- https://github.com/extole/extole-specification/blob/main/openapi/expression-context/com/extole/api/jobs/built/JobBuildtimeContext.d.ts oneOf: - allOf: - type: string - not: anyOf: - pattern: ^handlebars@buildtime:.* type: string - pattern: ^javascript@buildtime:.* type: string type: string description: Literal event name title: Static Value - description: >- Handlebars expression with [JobBuildtimeContext](https://github.com/extole/extole-specification/blob/main/openapi/expression-context/com/extole/api/jobs/built/JobBuildtimeContext.d.ts). example: handlebars@buildtime:{{eventName}} externalDocs: description: JobBuildtimeContext url: >- https://github.com/extole/extole-specification/blob/main/openapi/expression-context/com/extole/api/jobs/built/JobBuildtimeContext.d.ts pattern: ^handlebars@buildtime:.* title: Buildtime - Handlebars type: string - description: >- Javascript expression with [JobBuildtimeContext](https://github.com/extole/extole-specification/blob/main/openapi/expression-context/com/extole/api/jobs/built/JobBuildtimeContext.d.ts). example: >- javascript@buildtime:function() { return context.getVariableContext().get('eventName');} externalDocs: description: JobBuildtimeContext url: >- https://github.com/extole/extole-specification/blob/main/openapi/expression-context/com/extole/api/jobs/built/JobBuildtimeContext.d.ts pattern: ^javascript@buildtime:.* title: Buildtime - Javascript type: string ComponentReferenceResponse: properties: component_id: type: string socket_names: items: type: string type: array type: object OrderInTaskResponse: description: >- Position of this task in the job, as the buildtime expression or literal that was saved. Re-evaluated on campaign publish to determine the task's resolved execution order. Buildtime expressions use [JobBuildtimeContext](https://github.com/extole/extole-specification/blob/main/openapi/expression-context/com/extole/api/jobs/built/JobBuildtimeContext.d.ts). externalDocs: description: JobBuildtimeContext url: >- https://github.com/extole/extole-specification/blob/main/openapi/expression-context/com/extole/api/jobs/built/JobBuildtimeContext.d.ts oneOf: - description: Literal order format: int32 title: Static Value type: integer - description: >- Handlebars expression with [JobBuildtimeContext](https://github.com/extole/extole-specification/blob/main/openapi/expression-context/com/extole/api/jobs/built/JobBuildtimeContext.d.ts). example: handlebars@buildtime:{{order}} externalDocs: description: JobBuildtimeContext url: >- https://github.com/extole/extole-specification/blob/main/openapi/expression-context/com/extole/api/jobs/built/JobBuildtimeContext.d.ts pattern: ^handlebars@buildtime:.* title: Buildtime - Handlebars type: string - description: >- Javascript expression with [JobBuildtimeContext](https://github.com/extole/extole-specification/blob/main/openapi/expression-context/com/extole/api/jobs/built/JobBuildtimeContext.d.ts). example: >- javascript@buildtime:function() { return context.getVariableContext().get('order');} externalDocs: description: JobBuildtimeContext url: >- https://github.com/extole/extole-specification/blob/main/openapi/expression-context/com/extole/api/jobs/built/JobBuildtimeContext.d.ts pattern: ^javascript@buildtime:.* title: Buildtime - Javascript type: string ParentJobIdInTaskResponse: description: >- Id of the job this task belongs to, as the buildtime expression or literal that was saved. Buildtime expressions use [JobBuildtimeContext](https://github.com/extole/extole-specification/blob/main/openapi/expression-context/com/extole/api/jobs/built/JobBuildtimeContext.d.ts). externalDocs: description: JobBuildtimeContext url: >- https://github.com/extole/extole-specification/blob/main/openapi/expression-context/com/extole/api/jobs/built/JobBuildtimeContext.d.ts oneOf: - description: Literal parent job id title: Static Value type: string - description: >- Handlebars expression with [JobBuildtimeContext](https://github.com/extole/extole-specification/blob/main/openapi/expression-context/com/extole/api/jobs/built/JobBuildtimeContext.d.ts). example: handlebars@buildtime:{{parentJobId}} externalDocs: description: JobBuildtimeContext url: >- https://github.com/extole/extole-specification/blob/main/openapi/expression-context/com/extole/api/jobs/built/JobBuildtimeContext.d.ts pattern: ^handlebars@buildtime:.* title: Buildtime - Handlebars type: string - description: >- Javascript expression with [JobBuildtimeContext](https://github.com/extole/extole-specification/blob/main/openapi/expression-context/com/extole/api/jobs/built/JobBuildtimeContext.d.ts). example: >- javascript@buildtime:function() { return context.getVariableContext().get('parentJobId');} externalDocs: description: JobBuildtimeContext url: >- https://github.com/extole/extole-specification/blob/main/openapi/expression-context/com/extole/api/jobs/built/JobBuildtimeContext.d.ts pattern: ^javascript@buildtime:.* title: Buildtime - Javascript type: string examples: binding_error: summary: binding_error value: code: binding_error http_status_code: 400 message: Argument is not of the expected type parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 invalid_json: summary: invalid_json value: code: invalid_json http_status_code: 400 message: JSON is invalid parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 invalid_parameter: summary: invalid_parameter value: code: invalid_parameter http_status_code: 400 message: Parameter is invalid. parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 missing_request_body: summary: missing_request_body value: code: missing_request_body http_status_code: 400 message: Missing request body parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 task_order_out_of_range: summary: task_order_out_of_range value: code: task_order_out_of_range http_status_code: 400 message: Task order is out of range parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 task_type_mismatch: summary: task_type_mismatch value: code: task_type_mismatch http_status_code: 400 message: Task type does not match the stored task parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 method_unauthorized: summary: method_unauthorized value: code: method_unauthorized http_status_code: 401 message: Unauthorized access to this endpoint parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 payment_required: summary: payment_required value: code: payment_required http_status_code: 402 message: The access_token provided is associated with an unpaid account. parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 access_denied: summary: access_denied value: code: access_denied http_status_code: 403 message: >- The access_token provided is not permitted to access the specified resource. parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 missing_access_token: summary: missing_access_token value: code: missing_access_token http_status_code: 403 message: No access_token was provided with this request. parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 unsupported_media_type: summary: unsupported_media_type value: code: unsupported_media_type http_status_code: 415 message: Request had an unsupported or no media type parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 too_many_requests: summary: too_many_requests value: code: too_many_requests http_status_code: 429 message: >- The server is unable to process your request at the moment, please retry later. parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 securitySchemes: HEADER: in: header name: Authorization type: apiKey x-bearer-format: bearer QUERY: in: query name: access_token type: apiKey COOKIE: in: cookie name: extole_token type: apiKey ````