---
title: "POST /v1/jobs"
method: POST
path: "/v1/jobs"
tags: ["jobs"]
---

# POST /v1/jobs

`POST /v1/jobs`

Creates a job and returns it.

## Query parameters

- `onBehalfOfContentOwner` string

## Request body

- Job — A job creating reports of a specific type.
  - `expireTime` string, google-datetime — The date/time when this job will expire/expired. After a job expired, no new reports are generated.
  - `reportTypeId` string — The type of reports this job creates. Corresponds to the ID of a ReportType.
  - `id` string — The server-generated ID of the job (max. 40 characters).
  - `createTime` string, google-datetime — The creation date/time of the job.
  - `systemManaged` boolean — True if this a system-managed job that cannot be modified by the user; otherwise false.
  - `name` string — The name of the job (max. 100 characters).

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/youtubereporting.md) · [All operations](https://skmtc.net/google/apis/youtubereporting/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/youtubereporting/revisions/041025f06b97/schema)