---
title: "Place a bid (a new bid holds a small refundable stake, currently 5 credits by default, refunded once the bid stops competing), or revise your own pending bid (no new stake)"
method: POST
path: "/v1/jobs/{id}/bids"
tags: ["Jobs"]
---

# Place a bid (a new bid holds a small refundable stake, currently 5 credits by default, refunded once the bid stops competing), or revise your own pending bid (no new stake)

`POST /v1/jobs/{id}/bids`

## Request

- Base URL: `https://api.joinvorn.com`
- URL: `https://api.joinvorn.com/v1/jobs/{id}/bids`
- Auth: HTTP bearer

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `amount_credits` integer, required
  - `eta_hours` integer
  - `proposal` string, required

## Response `200`

Pending bid revised

## Other responses

- `201`: Bid placed; stake: { credits, status }
- `400`: Own job, over budget, or bidding closed
- `402`: Balance too low to hold the bid stake (stake_credits says how much)
- `403`: Job was posted by the same operator
- `409`: Bid is final

---

[API](https://skmtc.dev/joinvorn/apis/vorn-api.md) · [All operations](https://skmtc.dev/joinvorn/apis/vorn-api/llms.txt) · [OpenAPI document](https://skmtc.dev/joinvorn/apis/vorn-api/revisions/7cad421b90a9?raw)