---
title: "Create a Job"
method: POST
path: "/api/v2/jobs"
tags: ["Jobs"]
---

# Create a Job

`POST /api/v2/jobs`

## Request

- Base URL: `https://secure.agco-ats.com`
- URL: `https://secure.agco-ats.com/api/v2/jobs`
- Auth: none declared

Creates a Job.  The body of the POST is the Job to create.  The JobID will be assigned on
            creation of the Job.  When successful, the response is the JobID.  If unsuccessful, an 
            appropriate ApiError is returned.

## Request body

- BuildSystemSharedDTOJob: A DTO for an IJob
  - `JobID` integer: The ID of the job
  - `Name` string: The name of the job
  - `Deleted` boolean: Indicates if the job has been deleted.
  - `Parameters` BuildSystemSharedDTOParameter[]: The parameters for the job
    - `Name` string: The name of the parameter
    - `Type` 'String' | 'Boolean' | 'Integer' | 'Float' | 'StringDictionary': The data type of the parameter
    - `Direction` 'Input' | 'Output': The parameter direction (Input or Output)
  - `Activities` BuildSystemSharedDTOJobActivity[]: The activities which are performed for the job
    - `JobActivityID` integer: The ID of this job activity
    - `JobID` integer: The ID of the job this job activity belongs to
    - `ActivityID` integer: The ID of the activity to be run as part of the job
    - `RunOrder` integer: The order of this job activity relative to others in the job
    - `ParameterMappings` BuildSystemSharedDTOParameterMapping[]: The mapping of values from a source to be used for the activity parameters
      - `Name` string: The name of the parameter this mapping applies to
      - `SourceType` 'Constant' | 'Variable': The source type used for supplying the parameter
      - `Source` string: 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

## Response `200`

OK

- integer

## Other responses

- `default`: API Error Response

---

[API](https://skmtc.dev/agco-ats/apis/agco-ats-api.md) - [All operations](https://skmtc.dev/agco-ats/apis/agco-ats-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agco-ats/apis/agco-ats-api/revisions/8b416443df5c?raw)