naftiko: 1.0.0-alpha2 info: label: Microsoft Azure BatchServiceClient — Tasks description: 'Microsoft Azure BatchServiceClient — Tasks. 9 operations. Lead operation: Microsoft Azure Adds A Collection Of Tasks To The Specified Job. Self-contained Naftiko capability covering one Microsoft Azure business surface.' tags: - Microsoft Azure - Tasks created: '2026-05-19' modified: '2026-05-19' binds: - namespace: env keys: MICROSOFT_AZURE_API_KEY: MICROSOFT_AZURE_API_KEY capability: consumes: - type: http namespace: batchserviceclient-tasks baseUri: '' description: Microsoft Azure BatchServiceClient — Tasks business capability. Self-contained, no shared references. resources: - name: jobs-jobId-addtaskcollection path: /jobs/{jobId}/addtaskcollection operations: - name: microsoftazuretaskaddcollection method: POST description: Microsoft Azure Adds A Collection Of Tasks To The Specified Job outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: jobId in: path type: string description: The ID of the Job to which the Task collection is to be added. required: true - name: taskCollection in: body type: string description: The Tasks to be added. required: true - name: timeout in: query type: integer description: The maximum time that the server can spend processing the request, in seconds. The default is 2 minutes. If the value is larger than 120, the default will be us - name: client-request-id in: header type: string description: The caller-generated request identity, in the form of a GUID with no decoration such as curly braces, e.g. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0. - name: return-client-request-id in: header type: boolean description: Whether the server should return the client-request-id in the response. - name: ocp-date in: header type: string description: The time the request was issued. Client libraries typically set this to the current system clock time; set it explicitly if you are calling the REST API directl - name: jobs-jobId-tasks path: /jobs/{jobId}/tasks operations: - name: microsoftazuretaskadd method: POST description: Microsoft Azure Adds A Task To The Specified Job outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: jobId in: path type: string description: The ID of the Job to which the Task is to be added. required: true - name: task in: body type: string description: The Task to be added. required: true - name: timeout in: query type: integer description: The maximum time that the server can spend processing the request, in seconds. The default is 30 seconds. If the value is larger than 30, the default will be us - name: client-request-id in: header type: string description: The caller-generated request identity, in the form of a GUID with no decoration such as curly braces, e.g. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0. - name: return-client-request-id in: header type: boolean description: Whether the server should return the client-request-id in the response. - name: ocp-date in: header type: string description: The time the request was issued. Client libraries typically set this to the current system clock time; set it explicitly if you are calling the REST API directl - name: microsoftazuretasklist method: GET description: Microsoft Azure Lists All Of The Tasks That Are Associated With The Specified Job outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: jobId in: path type: string description: The ID of the Job. required: true - name: $filter in: query type: string description: An OData $filter clause. For more information on constructing this filter, see https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#lis - name: $select in: query type: string description: An OData $select clause. - name: $expand in: query type: string description: An OData $expand clause. - name: maxresults in: query type: integer description: The maximum number of items to return in the response. A maximum of 1000 Tasks can be returned. - name: timeout in: query type: integer description: The maximum time that the server can spend processing the request, in seconds. The default is 30 seconds. If the value is larger than 30, the default will be us - name: client-request-id in: header type: string description: The caller-generated request identity, in the form of a GUID with no decoration such as curly braces, e.g. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0. - name: return-client-request-id in: header type: boolean description: Whether the server should return the client-request-id in the response. - name: ocp-date in: header type: string description: The time the request was issued. Client libraries typically set this to the current system clock time; set it explicitly if you are calling the REST API directl - name: jobs-jobId-tasks-taskId path: /jobs/{jobId}/tasks/{taskId} operations: - name: microsoftazuretaskdelete method: DELETE description: Microsoft Azure Deletes A Task From The Specified Job outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: jobId in: path type: string description: The ID of the Job from which to delete the Task. required: true - name: taskId in: path type: string description: The ID of the Task to delete. required: true - name: timeout in: query type: integer description: The maximum time that the server can spend processing the request, in seconds. The default is 30 seconds. If the value is larger than 30, the default will be us - name: client-request-id in: header type: string description: The caller-generated request identity, in the form of a GUID with no decoration such as curly braces, e.g. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0. - name: return-client-request-id in: header type: boolean description: Whether the server should return the client-request-id in the response. - name: ocp-date in: header type: string description: The time the request was issued. Client libraries typically set this to the current system clock time; set it explicitly if you are calling the REST API directl - name: If-Match in: header type: string description: An ETag value associated with the version of the resource known to the client. The operation will be performed only if the resource's current ETag on the servic - name: If-None-Match in: header type: string description: An ETag value associated with the version of the resource known to the client. The operation will be performed only if the resource's current ETag on the servic - name: If-Modified-Since in: header type: string description: 'A timestamp indicating the last modified time of the resource known to the client. The operation will be performed only if the resource on the service has been ' - name: If-Unmodified-Since in: header type: string description: A timestamp indicating the last modified time of the resource known to the client. The operation will be performed only if the resource on the service has not b - name: microsoftazuretaskget method: GET description: Microsoft Azure Gets Information About The Specified Task outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: jobId in: path type: string description: The ID of the Job that contains the Task. required: true - name: taskId in: path type: string description: The ID of the Task to get information about. required: true - name: $select in: query type: string description: An OData $select clause. - name: $expand in: query type: string description: An OData $expand clause. - name: timeout in: query type: integer description: The maximum time that the server can spend processing the request, in seconds. The default is 30 seconds. If the value is larger than 30, the default will be us - name: client-request-id in: header type: string description: The caller-generated request identity, in the form of a GUID with no decoration such as curly braces, e.g. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0. - name: return-client-request-id in: header type: boolean description: Whether the server should return the client-request-id in the response. - name: ocp-date in: header type: string description: The time the request was issued. Client libraries typically set this to the current system clock time; set it explicitly if you are calling the REST API directl - name: If-Match in: header type: string description: An ETag value associated with the version of the resource known to the client. The operation will be performed only if the resource's current ETag on the servic - name: If-None-Match in: header type: string description: An ETag value associated with the version of the resource known to the client. The operation will be performed only if the resource's current ETag on the servic - name: If-Modified-Since in: header type: string description: 'A timestamp indicating the last modified time of the resource known to the client. The operation will be performed only if the resource on the service has been ' - name: If-Unmodified-Since in: header type: string description: A timestamp indicating the last modified time of the resource known to the client. The operation will be performed only if the resource on the service has not b - name: microsoftazuretaskupdate method: PUT description: Microsoft Azure Put Jobs Jobid Tasks Taskid outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: jobId in: path type: string description: The ID of the Job containing the Task. required: true - name: taskId in: path type: string description: The ID of the Task to update. required: true - name: taskUpdateParameter in: body type: string description: The parameters for the request. required: true - name: timeout in: query type: integer description: The maximum time that the server can spend processing the request, in seconds. The default is 30 seconds. If the value is larger than 30, the default will be us - name: client-request-id in: header type: string description: The caller-generated request identity, in the form of a GUID with no decoration such as curly braces, e.g. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0. - name: return-client-request-id in: header type: boolean description: Whether the server should return the client-request-id in the response. - name: ocp-date in: header type: string description: The time the request was issued. Client libraries typically set this to the current system clock time; set it explicitly if you are calling the REST API directl - name: If-Match in: header type: string description: An ETag value associated with the version of the resource known to the client. The operation will be performed only if the resource's current ETag on the servic - name: If-None-Match in: header type: string description: An ETag value associated with the version of the resource known to the client. The operation will be performed only if the resource's current ETag on the servic - name: If-Modified-Since in: header type: string description: 'A timestamp indicating the last modified time of the resource known to the client. The operation will be performed only if the resource on the service has been ' - name: If-Unmodified-Since in: header type: string description: A timestamp indicating the last modified time of the resource known to the client. The operation will be performed only if the resource on the service has not b - name: jobs-jobId-tasks-taskId-reactivate path: /jobs/{jobId}/tasks/{taskId}/reactivate operations: - name: microsoftazuretaskreactivate method: POST description: Microsoft Azure Reactivates A Task, Allowing It To Run Again Even If Its Retry Count Has Been Exhausted outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: jobId in: path type: string description: The ID of the Job containing the Task. required: true - name: taskId in: path type: string description: The ID of the Task to reactivate. required: true - name: timeout in: query type: integer description: The maximum time that the server can spend processing the request, in seconds. The default is 30 seconds. If the value is larger than 30, the default will be us - name: client-request-id in: header type: string description: The caller-generated request identity, in the form of a GUID with no decoration such as curly braces, e.g. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0. - name: return-client-request-id in: header type: boolean description: Whether the server should return the client-request-id in the response. - name: ocp-date in: header type: string description: The time the request was issued. Client libraries typically set this to the current system clock time; set it explicitly if you are calling the REST API directl - name: If-Match in: header type: string description: An ETag value associated with the version of the resource known to the client. The operation will be performed only if the resource's current ETag on the servic - name: If-None-Match in: header type: string description: An ETag value associated with the version of the resource known to the client. The operation will be performed only if the resource's current ETag on the servic - name: If-Modified-Since in: header type: string description: 'A timestamp indicating the last modified time of the resource known to the client. The operation will be performed only if the resource on the service has been ' - name: If-Unmodified-Since in: header type: string description: A timestamp indicating the last modified time of the resource known to the client. The operation will be performed only if the resource on the service has not b - name: jobs-jobId-tasks-taskId-subtasksinfo path: /jobs/{jobId}/tasks/{taskId}/subtasksinfo operations: - name: microsoftazuretasklistsubtasks method: GET description: Microsoft Azure Lists All Of The Subtasks That Are Associated With The Specified Multi Instance Task outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: jobId in: path type: string description: The ID of the Job. required: true - name: taskId in: path type: string description: The ID of the Task. required: true - name: $select in: query type: string description: An OData $select clause. - name: timeout in: query type: integer description: The maximum time that the server can spend processing the request, in seconds. The default is 30 seconds. If the value is larger than 30, the default will be us - name: client-request-id in: header type: string description: The caller-generated request identity, in the form of a GUID with no decoration such as curly braces, e.g. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0. - name: return-client-request-id in: header type: boolean description: Whether the server should return the client-request-id in the response. - name: ocp-date in: header type: string description: The time the request was issued. Client libraries typically set this to the current system clock time; set it explicitly if you are calling the REST API directl - name: jobs-jobId-tasks-taskId-terminate path: /jobs/{jobId}/tasks/{taskId}/terminate operations: - name: microsoftazuretaskterminate method: POST description: Microsoft Azure Terminates The Specified Task outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: jobId in: path type: string description: The ID of the Job containing the Task. required: true - name: taskId in: path type: string description: The ID of the Task to terminate. required: true - name: timeout in: query type: integer description: The maximum time that the server can spend processing the request, in seconds. The default is 30 seconds. If the value is larger than 30, the default will be us - name: client-request-id in: header type: string description: The caller-generated request identity, in the form of a GUID with no decoration such as curly braces, e.g. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0. - name: return-client-request-id in: header type: boolean description: Whether the server should return the client-request-id in the response. - name: ocp-date in: header type: string description: The time the request was issued. Client libraries typically set this to the current system clock time; set it explicitly if you are calling the REST API directl - name: If-Match in: header type: string description: An ETag value associated with the version of the resource known to the client. The operation will be performed only if the resource's current ETag on the servic - name: If-None-Match in: header type: string description: An ETag value associated with the version of the resource known to the client. The operation will be performed only if the resource's current ETag on the servic - name: If-Modified-Since in: header type: string description: 'A timestamp indicating the last modified time of the resource known to the client. The operation will be performed only if the resource on the service has been ' - name: If-Unmodified-Since in: header type: string description: A timestamp indicating the last modified time of the resource known to the client. The operation will be performed only if the resource on the service has not b exposes: - type: rest namespace: batchserviceclient-tasks-rest port: 8080 description: REST adapter for Microsoft Azure BatchServiceClient — Tasks. One Spectral-compliant resource per consumed operation, prefixed with /v1. resources: - path: /v1/jobs/{jobid}/addtaskcollection name: jobs-jobid-addtaskcollection description: REST surface for jobs-jobId-addtaskcollection. operations: - method: POST name: microsoftazuretaskaddcollection description: Microsoft Azure Adds A Collection Of Tasks To The Specified Job call: batchserviceclient-tasks.microsoftazuretaskaddcollection with: jobId: rest.jobId taskCollection: rest.taskCollection timeout: rest.timeout client-request-id: rest.client-request-id return-client-request-id: rest.return-client-request-id ocp-date: rest.ocp-date outputParameters: - type: object mapping: $. - path: /v1/jobs/{jobid}/tasks name: jobs-jobid-tasks description: REST surface for jobs-jobId-tasks. operations: - method: POST name: microsoftazuretaskadd description: Microsoft Azure Adds A Task To The Specified Job call: batchserviceclient-tasks.microsoftazuretaskadd with: jobId: rest.jobId task: rest.task timeout: rest.timeout client-request-id: rest.client-request-id return-client-request-id: rest.return-client-request-id ocp-date: rest.ocp-date outputParameters: - type: object mapping: $. - method: GET name: microsoftazuretasklist description: Microsoft Azure Lists All Of The Tasks That Are Associated With The Specified Job call: batchserviceclient-tasks.microsoftazuretasklist with: jobId: rest.jobId $filter: rest.$filter $select: rest.$select $expand: rest.$expand maxresults: rest.maxresults timeout: rest.timeout client-request-id: rest.client-request-id return-client-request-id: rest.return-client-request-id ocp-date: rest.ocp-date outputParameters: - type: object mapping: $. - path: /v1/jobs/{jobid}/tasks/{taskid} name: jobs-jobid-tasks-taskid description: REST surface for jobs-jobId-tasks-taskId. operations: - method: DELETE name: microsoftazuretaskdelete description: Microsoft Azure Deletes A Task From The Specified Job call: batchserviceclient-tasks.microsoftazuretaskdelete with: jobId: rest.jobId taskId: rest.taskId timeout: rest.timeout client-request-id: rest.client-request-id return-client-request-id: rest.return-client-request-id ocp-date: rest.ocp-date If-Match: rest.If-Match If-None-Match: rest.If-None-Match If-Modified-Since: rest.If-Modified-Since If-Unmodified-Since: rest.If-Unmodified-Since outputParameters: - type: object mapping: $. - method: GET name: microsoftazuretaskget description: Microsoft Azure Gets Information About The Specified Task call: batchserviceclient-tasks.microsoftazuretaskget with: jobId: rest.jobId taskId: rest.taskId $select: rest.$select $expand: rest.$expand timeout: rest.timeout client-request-id: rest.client-request-id return-client-request-id: rest.return-client-request-id ocp-date: rest.ocp-date If-Match: rest.If-Match If-None-Match: rest.If-None-Match If-Modified-Since: rest.If-Modified-Since If-Unmodified-Since: rest.If-Unmodified-Since outputParameters: - type: object mapping: $. - method: PUT name: microsoftazuretaskupdate description: Microsoft Azure Put Jobs Jobid Tasks Taskid call: batchserviceclient-tasks.microsoftazuretaskupdate with: jobId: rest.jobId taskId: rest.taskId taskUpdateParameter: rest.taskUpdateParameter timeout: rest.timeout client-request-id: rest.client-request-id return-client-request-id: rest.return-client-request-id ocp-date: rest.ocp-date If-Match: rest.If-Match If-None-Match: rest.If-None-Match If-Modified-Since: rest.If-Modified-Since If-Unmodified-Since: rest.If-Unmodified-Since outputParameters: - type: object mapping: $. - path: /v1/jobs/{jobid}/tasks/{taskid}/reactivate name: jobs-jobid-tasks-taskid-reactivate description: REST surface for jobs-jobId-tasks-taskId-reactivate. operations: - method: POST name: microsoftazuretaskreactivate description: Microsoft Azure Reactivates A Task, Allowing It To Run Again Even If Its Retry Count Has Been Exhausted call: batchserviceclient-tasks.microsoftazuretaskreactivate with: jobId: rest.jobId taskId: rest.taskId timeout: rest.timeout client-request-id: rest.client-request-id return-client-request-id: rest.return-client-request-id ocp-date: rest.ocp-date If-Match: rest.If-Match If-None-Match: rest.If-None-Match If-Modified-Since: rest.If-Modified-Since If-Unmodified-Since: rest.If-Unmodified-Since outputParameters: - type: object mapping: $. - path: /v1/jobs/{jobid}/tasks/{taskid}/subtasksinfo name: jobs-jobid-tasks-taskid-subtasksinfo description: REST surface for jobs-jobId-tasks-taskId-subtasksinfo. operations: - method: GET name: microsoftazuretasklistsubtasks description: Microsoft Azure Lists All Of The Subtasks That Are Associated With The Specified Multi Instance Task call: batchserviceclient-tasks.microsoftazuretasklistsubtasks with: jobId: rest.jobId taskId: rest.taskId $select: rest.$select timeout: rest.timeout client-request-id: rest.client-request-id return-client-request-id: rest.return-client-request-id ocp-date: rest.ocp-date outputParameters: - type: object mapping: $. - path: /v1/jobs/{jobid}/tasks/{taskid}/terminate name: jobs-jobid-tasks-taskid-terminate description: REST surface for jobs-jobId-tasks-taskId-terminate. operations: - method: POST name: microsoftazuretaskterminate description: Microsoft Azure Terminates The Specified Task call: batchserviceclient-tasks.microsoftazuretaskterminate with: jobId: rest.jobId taskId: rest.taskId timeout: rest.timeout client-request-id: rest.client-request-id return-client-request-id: rest.return-client-request-id ocp-date: rest.ocp-date If-Match: rest.If-Match If-None-Match: rest.If-None-Match If-Modified-Since: rest.If-Modified-Since If-Unmodified-Since: rest.If-Unmodified-Since outputParameters: - type: object mapping: $. - type: mcp namespace: batchserviceclient-tasks-mcp port: 9090 transport: http description: MCP adapter for Microsoft Azure BatchServiceClient — Tasks. One tool per consumed operation, routed inline through this capability's consumes block. tools: - name: microsoft-azure-adds-collection-tasks description: Microsoft Azure Adds A Collection Of Tasks To The Specified Job hints: readOnly: false destructive: false idempotent: false call: batchserviceclient-tasks.microsoftazuretaskaddcollection with: jobId: tools.jobId taskCollection: tools.taskCollection timeout: tools.timeout client-request-id: tools.client-request-id return-client-request-id: tools.return-client-request-id ocp-date: tools.ocp-date outputParameters: - type: object mapping: $. - name: microsoft-azure-adds-task-specified description: Microsoft Azure Adds A Task To The Specified Job hints: readOnly: false destructive: false idempotent: false call: batchserviceclient-tasks.microsoftazuretaskadd with: jobId: tools.jobId task: tools.task timeout: tools.timeout client-request-id: tools.client-request-id return-client-request-id: tools.return-client-request-id ocp-date: tools.ocp-date outputParameters: - type: object mapping: $. - name: microsoft-azure-lists-all-tasks description: Microsoft Azure Lists All Of The Tasks That Are Associated With The Specified Job hints: readOnly: true destructive: false idempotent: true call: batchserviceclient-tasks.microsoftazuretasklist with: jobId: tools.jobId $filter: tools.$filter $select: tools.$select $expand: tools.$expand maxresults: tools.maxresults timeout: tools.timeout client-request-id: tools.client-request-id return-client-request-id: tools.return-client-request-id ocp-date: tools.ocp-date outputParameters: - type: object mapping: $. - name: microsoft-azure-deletes-task-specified description: Microsoft Azure Deletes A Task From The Specified Job hints: readOnly: false destructive: true idempotent: true call: batchserviceclient-tasks.microsoftazuretaskdelete with: jobId: tools.jobId taskId: tools.taskId timeout: tools.timeout client-request-id: tools.client-request-id return-client-request-id: tools.return-client-request-id ocp-date: tools.ocp-date If-Match: tools.If-Match If-None-Match: tools.If-None-Match If-Modified-Since: tools.If-Modified-Since If-Unmodified-Since: tools.If-Unmodified-Since outputParameters: - type: object mapping: $. - name: microsoft-azure-gets-information-about description: Microsoft Azure Gets Information About The Specified Task hints: readOnly: true destructive: false idempotent: true call: batchserviceclient-tasks.microsoftazuretaskget with: jobId: tools.jobId taskId: tools.taskId $select: tools.$select $expand: tools.$expand timeout: tools.timeout client-request-id: tools.client-request-id return-client-request-id: tools.return-client-request-id ocp-date: tools.ocp-date If-Match: tools.If-Match If-None-Match: tools.If-None-Match If-Modified-Since: tools.If-Modified-Since If-Unmodified-Since: tools.If-Unmodified-Since outputParameters: - type: object mapping: $. - name: microsoft-azure-put-jobs-jobid description: Microsoft Azure Put Jobs Jobid Tasks Taskid hints: readOnly: false destructive: false idempotent: true call: batchserviceclient-tasks.microsoftazuretaskupdate with: jobId: tools.jobId taskId: tools.taskId taskUpdateParameter: tools.taskUpdateParameter timeout: tools.timeout client-request-id: tools.client-request-id return-client-request-id: tools.return-client-request-id ocp-date: tools.ocp-date If-Match: tools.If-Match If-None-Match: tools.If-None-Match If-Modified-Since: tools.If-Modified-Since If-Unmodified-Since: tools.If-Unmodified-Since outputParameters: - type: object mapping: $. - name: microsoft-azure-reactivates-task-allowing description: Microsoft Azure Reactivates A Task, Allowing It To Run Again Even If Its Retry Count Has Been Exhausted hints: readOnly: false destructive: false idempotent: false call: batchserviceclient-tasks.microsoftazuretaskreactivate with: jobId: tools.jobId taskId: tools.taskId timeout: tools.timeout client-request-id: tools.client-request-id return-client-request-id: tools.return-client-request-id ocp-date: tools.ocp-date If-Match: tools.If-Match If-None-Match: tools.If-None-Match If-Modified-Since: tools.If-Modified-Since If-Unmodified-Since: tools.If-Unmodified-Since outputParameters: - type: object mapping: $. - name: microsoft-azure-lists-all-subtasks description: Microsoft Azure Lists All Of The Subtasks That Are Associated With The Specified Multi Instance Task hints: readOnly: true destructive: false idempotent: true call: batchserviceclient-tasks.microsoftazuretasklistsubtasks with: jobId: tools.jobId taskId: tools.taskId $select: tools.$select timeout: tools.timeout client-request-id: tools.client-request-id return-client-request-id: tools.return-client-request-id ocp-date: tools.ocp-date outputParameters: - type: object mapping: $. - name: microsoft-azure-terminates-specified-task description: Microsoft Azure Terminates The Specified Task hints: readOnly: false destructive: false idempotent: false call: batchserviceclient-tasks.microsoftazuretaskterminate with: jobId: tools.jobId taskId: tools.taskId timeout: tools.timeout client-request-id: tools.client-request-id return-client-request-id: tools.return-client-request-id ocp-date: tools.ocp-date If-Match: tools.If-Match If-None-Match: tools.If-None-Match If-Modified-Since: tools.If-Modified-Since If-Unmodified-Since: tools.If-Unmodified-Since outputParameters: - type: object mapping: $.