---
title: "Create Execution Job"
method: POST
path: "/v1/execution_jobs"
tags: ["execution"]
---

# Create Execution Job

`POST /v1/execution_jobs`

Persist one Python function and its portable arguments as a job.

## Request body

- ExecutionRequest — One Python function plus independently portable arguments.
  - `serialized_function` string, binary, required
  - `serialization_python_version` '3.12' | '3.13' | '3.14', required
  - `environment` Environment, required — A reproducible Python runtime for an execution. Cloudpickle, PyArrow, Pydantic, ``outerproduct-dataframe``, ``outerproduct-hpo``, and ``outerproduct-serialization`` are supplied and versioned by the execution runtime. Environment variables are invocation inputs rather than image inputs, so changing one does not invalidate the dependency image cache. They are ordinary, non-secret values; secret injection is a separate runtime capability.
    - `python_version` '3.12' | '3.13' | '3.14'
    - `pypi_dependencies` string[]
    - `environment_variables` object
  - `resources` Resources — Compute capacity and deadline requested for one execution.
    - `cpu` number, nullable
    - `memory_mib` integer, nullable
    - `gpu` string, nullable
    - `timeout_seconds` integer
  - `arguments` ExecutionArguments
    - `positional` ExecutionValue[]
      - union
        - SerializableValue — One value reconstructed by its owning type inside compute.
          - `module` string, required
          - `qualname` string, required
          - `serialized_value` string, binary, required
          - `kind` 'serialized'
        - LiteralValue — A JSON literal passed through the computation boundary unchanged.
          - `kind` 'literal'
          - `value` unknown, required
    - `keyword` object

## Response `201`

Successful Response

- JobSubmissionResponse
  - `job_id` union, required
    - string, uuid
    - string
  - `status` 'pending' | 'running' | 'completed' | 'failed' | 'cancelled', required
  - `message` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/outerproduct/apis/outerproduct-api.md) · [All operations](https://skmtc.net/outerproduct/apis/outerproduct-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/outerproduct/outerproduct-api/revisions/6c6e81fb3282/schema)