The JobRuns API from Agco — 2 operation(s) for jobruns.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/agco-jobruns-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
version: v1
title: Job Runs API
servers:
- url: https://secure.agco-ats.com
tags:
- name: JobRuns
paths:
/api/v2/jobRuns:
get:
tags:
- JobRuns
summary: Get JobRuns
description: 'Gets a collection of JobRuns. When successful, the response is a PagedResponse of JobRuns.
If unsuccessful, an appropriate ApiError is returned.'
operationId: JobRuns_GetJobRuns
parameters:
- name: limit
in: query
description: Optional. The page limit. If not specified, the default page limit is 10.
required: false
schema:
type: integer
format: int32
- name: offset
in: query
description: Optional. The page offset. If not specified, the default page offset is 0.
required: false
schema:
type: integer
format: int32
- name: includeActivityRunDetails
in: query
description: Optional. Indicates whether to include ActivityRun details. Defaults to false.
required: false
schema:
type: boolean
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/API.PagedResponse_BuildSystem.Shared.DTO.JobRun'
text/json:
schema:
$ref: '#/components/schemas/API.PagedResponse_BuildSystem.Shared.DTO.JobRun'
default:
description: API Error Response
content:
application/json:
schema:
$ref: '#/components/schemas/API.Models.ApiError'
text/json:
schema:
$ref: '#/components/schemas/API.Models.ApiError'
deprecated: false
post:
tags:
- JobRuns
summary: Create a JobRun
description: 'Creates a JobRun. The body of the POST is the JobRun to create. The JobRunID will be assigned on
creation of the JobRun. When successful, the response is the JobRunID. If unsuccessful, an
appropriate ApiError is returned.'
operationId: JobRuns_PostJobRun
responses:
'200':
description: OK
content:
application/json:
schema:
format: int32
type: integer
text/json:
schema:
format: int32
type: integer
application/xml:
schema:
format: int32
type: integer
text/xml:
schema:
format: int32
type: integer
default:
description: API Error Response
content:
application/json:
schema:
$ref: '#/components/schemas/API.Models.ApiError'
text/json:
schema:
$ref: '#/components/schemas/API.Models.ApiError'
application/xml:
schema:
$ref: '#/components/schemas/API.Models.ApiError'
text/xml:
schema:
$ref: '#/components/schemas/API.Models.ApiError'
deprecated: false
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/BuildSystem.Shared.DTO.JobRun'
text/json:
schema:
$ref: '#/components/schemas/BuildSystem.Shared.DTO.JobRun'
application/xml:
schema:
$ref: '#/components/schemas/BuildSystem.Shared.DTO.JobRun'
text/xml:
schema:
$ref: '#/components/schemas/BuildSystem.Shared.DTO.JobRun'
application/x-www-form-urlencoded:
schema:
$ref: '#/components/schemas/BuildSystem.Shared.DTO.JobRun'
description: The JobRun to create. The JobRunID will be assigned on creation of the JobRun.
required: true
/api/v2/jobRuns/{jobRunID}:
get:
tags:
- JobRuns
summary: Get a JobRun by ID
description: 'Gets a JobRun by ID. When successful, the response is the requested JobRun.
If unsuccessful, an appropriate ApiError is returned.'
operationId: JobRuns_GetJobRun
parameters:
- name: jobRunID
in: path
description: The ID of the JobRun to get.
required: true
schema:
type: integer
format: int32
- name: includeActivityRunDetails
in: query
description: Optional. Indicates whether to include ActivityRun details. Defaults to false.
required: false
schema:
type: boolean
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/BuildSystem.Shared.DTO.JobRun'
text/json:
schema:
$ref: '#/components/schemas/BuildSystem.Shared.DTO.JobRun'
application/xml:
schema:
$ref: '#/components/schemas/BuildSystem.Shared.DTO.JobRun'
text/xml:
schema:
$ref: '#/components/schemas/BuildSystem.Shared.DTO.JobRun'
default:
description: API Error Response
content:
application/json:
schema:
$ref: '#/components/schemas/API.Models.ApiError'
text/json:
schema:
$ref: '#/components/schemas/API.Models.ApiError'
application/xml:
schema:
$ref: '#/components/schemas/API.Models.ApiError'
text/xml:
schema:
$ref: '#/components/schemas/API.Models.ApiError'
deprecated: false
put:
tags:
- JobRuns
summary: Update a JobRun
description: '///
Updates a JobRun. The body of the PUT is the updated JobRun.
When successful, the response is empty. If unsuccessful, an appropriate ApiError is returned.'
operationId: JobRuns_PutJobRun
parameters:
- name: jobRunID
in: path
description: The id of the JobRun to update
required: true
schema:
type: integer
format: int32
responses:
'204':
description: No Content
default:
description: API Error Response
content:
application/json:
schema:
$ref: '#/components/schemas/API.Models.ApiError'
deprecated: false
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/BuildSystem.Shared.DTO.JobRun'
text/json:
schema:
$ref: '#/components/schemas/BuildSystem.Shared.DTO.JobRun'
application/xml:
schema:
$ref: '#/components/schemas/BuildSystem.Shared.DTO.JobRun'
text/xml:
schema:
$ref: '#/components/schemas/BuildSystem.Shared.DTO.JobRun'
application/x-www-form-urlencoded:
schema:
$ref: '#/components/schemas/BuildSystem.Shared.DTO.JobRun'
description: The updated JobRun
required: true
delete:
tags:
- JobRuns
summary: Delete a JobRun
description: 'Deletes a JobRun. When successful, the response is empty. If unsuccessful, an appropriate
ApiError is returned.'
operationId: JobRuns_DeleteJobRun
parameters:
- name: jobRunID
in: path
description: The id of the JobRun to delete
required: true
schema:
type: integer
format: int32
responses:
'204':
description: No Content
default:
description: API Error Response
content:
application/json:
schema:
$ref: '#/components/schemas/API.Models.ApiError'
deprecated: false
components:
schemas:
BuildSystem.Shared.DTO.ActivityRun:
description: A DTO for an IActivityRun
required:
- Status
type: object
properties:
ActivityRunID:
format: int32
description: The identifier for the ActivityRun
type: integer
JobActivityID:
format: int32
description: Read Only. The ID of the Job Activity that defines this activity run
type: integer
JobRunID:
format: int32
description: Read Only. The ID of the JobRun under which this ActivityRun is executing
type: integer
Parameters:
description: The parameters used for this run of the activity. Parameters cannot be added or removed, but output parameter values may be updated.
type: array
items:
$ref: '#/components/schemas/BuildSystem.Shared.DTO.ParameterValue'
readOnly: true
Status:
$ref: '#/components/schemas/BuildSystem.Shared.DTO.ActivityRunStatus'
description: The status of this ActivityRun
Steps:
description: Read Only. The steps to be executed for the activity. These steps come from the relationship through JobActivity down to ActivityStep
type: array
items:
$ref: '#/components/schemas/BuildSystem.Shared.DTO.ActivityStep'
readOnly: true
StartDate:
format: date-time
description: Read Only. The UTC date and time when the activity started
type: string
EndDate:
format: date-time
description: Read Only. The UTC date and time when the activity completed
type: string
BuildSystem.Shared.DTO.ParameterMapping:
description: A DTO for an IParameterMapping
type: object
properties:
Name:
description: The name of the parameter this mapping applies to
type: string
SourceType:
description: The source type used for supplying the parameter
enum:
- Constant
- Variable
type: string
Source:
description: The source of the value. The meaning of this value is determined by the source type. When the source type is “Constant” then source is the value formatted as a string. When the source type is “Variable” then the source is the name of the variable
type: string
BuildSystem.Shared.DTO.ActivityStep:
description: A DTO for an IActivityStep
type: object
properties:
ActivityStepID:
format: int32
description: The id of this activity step
type: integer
ActivityID:
format: int32
description: The id of the activity this activity step belongs to
type: integer
StepID:
format: int32
description: The id of the step
type: integer
RunOrder:
format: int32
description: The order of this activity step relative to other activity steps
type: integer
UseConfig:
description: Indicates the configuration for the ActivityStep to use at runtime. The build agent must provide this configuration
type: string
StepName:
description: The name of the step
type: string
ImplementationID:
description: The implementation id which is used to look up the step implementation
type: string
ParameterMappings:
description: The mapping of values from a source to be used for the step parameters
type: array
items:
$ref: '#/components/schemas/BuildSystem.Shared.DTO.ParameterMapping'
readOnly: true
API.PagedResponseMetadata:
description: Metadata for the paged response
required:
- TotalCount
- Limit
- Offset
type: object
properties:
TotalCount:
format: int32
description: The total number of entities matching the request.
type: integer
readOnly: true
Limit:
format: int32
description: The number of entities this paged response is limited to.
type: integer
readOnly: true
Offset:
format: int32
description: The number of entities prior to this page of items.
type: integer
readOnly: true
API.Models.ApiError:
type: object
properties:
DeveloperMessage:
type: string
UserMessage:
type: string
ErrorCode:
format: int32
type: integer
MoreInfo:
type: string
API.PagedResponse_BuildSystem.Shared.DTO.JobRun:
description: A response containing a page of results and metadata concerning the results
required:
- Metadata
- Entities
type: object
properties:
Metadata:
$ref: '#/components/schemas/API.PagedResponseMetadata'
description: Metadata about this paged response
readOnly: true
Entities:
description: The set of entities that make up this page.
type: array
items:
$ref: '#/components/schemas/BuildSystem.Shared.DTO.JobRun'
readOnly: true
BuildSystem.Shared.DTO.ParameterValue:
description: A DTO for an IParameterValue
type: object
properties:
Name:
description: The name of the parameter this value is for
type: string
Value:
description: The parameter value in string representation
type: string
Direction:
description: The parameter direction (Input or Output)
enum:
- Input
- Output
type: string
BuildSystem.Shared.DTO.JobRun:
description: A DTO for an IJobRun
type: object
properties:
JobRunID:
format: int32
description: The ID of this JobRun
type: integer
JobID:
format: int32
description: The ID of the job that defines the run
type: integer
Parameters:
description: The parameters used for this run of the job
type: array
items:
$ref: '#/components/schemas/BuildSystem.Shared.DTO.ParameterValue'
readOnly: true
Status:
description: The status of this JobRun
enum:
- Ready
- InProgress
- Succeeded
- Cancelled
- Failed
type: string
ActivityRuns:
description: The activity runs belonging to this JobRun
type: array
items:
$ref: '#/components/schemas/BuildSystem.Shared.DTO.ActivityRun'
readOnly: true
StartDate:
format: date-time
description: The UTC date and time when the job started
type: string
EndDate:
format: date-time
description: The UTC date and time when the job completed
type: string
BuildSystem.Shared.DTO.ActivityRunStatus:
description: A DTO for an IActivityRunStatus
type: object
properties:
Status:
description: The status of the ActivityRun
enum:
- Ready
- InProgress
- Succeeded
- Cancelled
- Failed
type: string
CurrentStep:
format: int32
description: The activity step currently executing, indicated by numeric order
type: integer
StepStatus:
description: The status text from the currently executing step
type: string
StepProgress:
format: int32
description: The percent progress from the currently executing step. This value shall be null if progress is not available
type: integer