Create

---

Create a new job

Create a new computing job on ByteNite.

post

/jobs

Authorizations

Body

application/jsonapplication/x-protobuf

jobIdstring

Unique identifier for the job, automatically generated if left blank.

namestring

Mnemonic name for the job.

templateIdstringrequired

Identifier of the application template used for this job.

descriptionstring

Textual description of the job.

dataSourceobject

Configuration for the data source providing input data to the job.

dataDestinationobject

Configuration for the data destination where job output will be sent.

paramsobject

Job-specific configuration parameters for the distributed application.

configobject

Job execution preferences.

Responses

application/jsonapplication/x-protobuf

application/jsonapplication/x-protobuf

application/jsonapplication/x-protobuf

application/jsonapplication/x-protobuf

application/jsonapplication/x-protobuf

application/jsonapplication/x-protobuf

application/jsonapplication/x-protobuf

application/jsonapplication/x-protobuf

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.bytenite.com/v1/customer/jobs' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "My job",
    "templateId": "[email protected]"
  }'

200

400

401

403

404

500

503

default

200

application/json

application/x-protobuf

application/json

{
  "job": {
    "id": "text",
    "templateId": "text",
    "name": "text",
    "config": {
      "taskTimeout": 1,
      "jobTimeout": 1,
      "isTestJob": true
    },
    "priority": "EXECUTION_PRIORITY_UNDEFINED",
    "startAt": "2025-03-15T22:11:12.154Z",
    "submittedAt": "2025-03-15T22:11:12.154Z",
    "startedAt": "2025-03-15T22:11:12.154Z",
    "endedAt": "2025-03-15T22:11:12.154Z",
    "regions": {
      "blacklist": [
        "text"
      ],
      "whitelist": [
        "text"
      ]
    },
    "state": "JOB_STATE_NEW",
    "dataSource": {
      "dataSourceDescriptor": "s3",
      "params": {
        "@type": "text",
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    },
    "params": {
      "preset": "text",
      "partitioner": {},
      "assembler": {},
      "app": {}
    },
    "dataDestination": {
      "dataSourceDescriptor": "s3",
      "params": {
        "@type": "text",
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    },
    "duration": 1,
    "deletedAt": "2025-03-15T22:11:12.154Z",
    "createdAt": "2025-03-15T22:11:12.154Z",
    "paymentAmount": 1,
    "numUnitsEstimation": "text",
    "numChunks": 1,
    "errorMessage": "text",
    "description": "text",
    "stateTimestamps": {
      "ANY_ADDITIONAL_PROPERTY": "2025-03-15T22:11:12.154Z"
    }
  },
  "templateInfo": {
    "id": "text",
    "partitioningEngineId": "text",
    "assemblingEngineId": "text",
    "streamable": true,
    "description": "text",
    "partitioningSchemaId": "text",
    "assemblingSchemaId": "text",
    "appSchemaId": "text",
    "appId": "text",
    "owner": "text"
  }
}

A successful response.