---
title: "POST jobs publish"
method: POST
path: "/api/v1/jobs/{id}/publish"
---

# POST jobs publish

`POST /api/v1/jobs/{id}/publish`

## Request

- Base URL: `https://app.onecodex.com`
- URL: `https://app.onecodex.com/api/v1/jobs/{id}/publish`
- Auth: API key in header `X-API-Key`

## Path parameters

- `id` string, required

## Request body

- object
  - `autorun_on_org_sample_upload` boolean, nullable

## Response `200`

OK

- Jobs
  - `$uri` string, required
  - `analysis_type` string, required: The type of analysis. See [the analysis resource](/api/analysis-resource) for more details.
  - `created_at` string, date-time, required: Timestamp for when the object was created on the One Codex platform, encoded as a [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) timestamp.
  - `draft` boolean, required: Whether the job is an unpublished draft. Draft jobs are only visible to their creator.
  - `job_args_schema` object, required: The JSON schema for the arguments taken by the job (can be an empty object, i.e., `{}`).
  - `name` string, required: The name of the job (this is displayed in the dropdown on the analysis page of the One Codex web application).
  - `public` boolean, required: Whether the job is publicly available. For most jobs this will be `true`. Custom, private jobs are also available, and will only be visible to users whose samples (or samples shared with them) have been analyzed using that job.

## Changes

- **2026-11-03** `3be5a5f9bf7d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/onecodex/apis/one-codex-api-v1/changes/api/v1/jobs/:id/publish/post.md)

---

[API](https://skmtc.dev/onecodex/apis/one-codex-api-v1.md) - [All operations](https://skmtc.dev/onecodex/apis/one-codex-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/onecodex/apis/one-codex-api-v1/revisions/3be5a5f9bf7d?raw)