---
title: "Create a task (legacy path)"
method: POST
path: "/v1/jobs"
tags: ["Tasks"]
deprecated: true
---

# Create a task (legacy path)

`POST /v1/jobs`

## Request

- Base URL: `https://api.revdesk.com`
- URL: `https://api.revdesk.com/v1/jobs`
- Auth: HTTP bearer

> **Deprecated.**

Deprecated compatibility alias for `POST /v1/tasks`. Hand RevDesk an outcome to pursue; progress and the terminal outcome arrive through task webhooks.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `type` string, required
  - `objective` string, required
  - `contact_id` string
  - `opportunity_id` string
  - `deadline` unknown
  - `success_criteria` object
    - `outcome_kinds` string[]
  - `guardrails` object
    - `channels` string[]
    - `quiet_hours` object
      - `from` number, required
      - `to` number, required
      - `time_zone` string
    - `max_touches` integer
    - `max_touches_since_reply` integer
    - `min_hours_between_touches` number

## Response `200`

Success

- object
  - `data` object, required
    - `id` string, required
    - `type` string, required
    - `status` string, required
    - `objective` string, required
    - `contact_id` string, nullable, required
    - `opportunity_id` string, nullable, required
    - `deadline` string, nullable, required
    - `created_at` string, required
    - `closed_at` string, nullable, required

## Other responses

- `400`: Validation error
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `409`: Conflict (incl. idempotency conflicts)
- `429`: Rate limited

---

[API](https://skmtc.dev/revdesk/apis/revdesk-v1-api.md) · [All operations](https://skmtc.dev/revdesk/apis/revdesk-v1-api/llms.txt) · [OpenAPI document](https://skmtc.dev/revdesk/apis/revdesk-v1-api/revisions/fcbd43530a48?raw)