Create jobs

POST /v1/marketplace/jobs

Hires another org for a piece of work, through a public listing or by a direct offer, and answers 201 with the job — open, waiting for the seller.

It is paid over x402, in two steps on this one call. Sent without payment, the terms are cleared first — principal decides whether the buyer may pay the seller this amount, and a blocked payment, one that waits on the seller's tax form, and one that clears only with tax withheld, which this rail does not withhold, are refused and nothing is opened — and it answers 402 with the terms to sign, for the job resource job:<id>: on PAYMENT-REQUIRED, in the body, and in the message. Sent again with the signed authorization — on PAYMENT-SIGNATURE, or as payment — echoing that resource, the terms are cleared once more, the job is funding, and the rail checks the payment against exactly those terms, checks it stays acceptable until a dispute could last be ruled on, holds it for this job, and sets the amount aside in the buyer's wallet: a wallet that cannot cover it answers 402 insufficient_funds and opens nothing. Nothing is paid until the buyer releases the job, or its review window passes after delivery; a job that ends unpaid returns the amount to the wallet. Any member of the buying org; a platform SuperAdmin inspecting another org cannot spend it.

A hire sent with an attempt — the buyer's own key for it, in the body — is one hire however often it is sent: the same attempt with the same request answers the same job, so a request whose answer was lost is sent again as it was, and opens one job and sets its amount aside once. It answers the quote's terms again while the job is quoted or funding (a quote over its hour is given up and quoted anew), and the job, 201, once it opened. Another request under an attempt already used is refused, 422. The buyer's own jobs list its quotes and those being funded, with their attempts, so an attempt in flight is found there too. Without an attempt, the same terms asked again within the hour answer the same quote, and the same payment sent again answers the job it opened.

Request

13 fields, body application/json (required).

Response

201 body — 38 fields.

Failure carries the platform error shape — see Errors.

Examples

import { Configuration, MarketplaceApi } from 'hanzoai';

const api = new MarketplaceApi(new Configuration({ accessToken: process.env.HANZO_API_KEY }));
const { data } = await api.postMarketplaceJobs({ amount: "<amount>", attempt: "<attempt>" });

from hanzoai.cloud import ApiClient, Configuration
from hanzoai.cloud.api import MarketplaceApi

client = ApiClient(Configuration(access_token=os.environ["HANZO_API_KEY"]))
result = MarketplaceApi(client).post_marketplace_jobs(amount="<amount>", attempt="<attempt>")

cfg := hanzoai.NewConfiguration()
cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY"))
client := hanzoai.NewAPIClient(cfg)

resp, _, err := client.MarketplaceAPI.PostMarketplaceJobs(context.Background()).Execute()
if err != nil {
	return err
}

use hanzo_client::apis::{configuration::Configuration, marketplace_api};

let mut cfg = Configuration::new();
cfg.bearer_access_token = std::env::var("HANZO_API_KEY").ok();

let result = marketplace_api::post_marketplace_jobs(&cfg, Default::default()).await?;

import ai.hanzo.cloud.ApiClient;
import ai.hanzo.cloud.api.MarketplaceApi;

ApiClient client = new ApiClient();
client.setBearerToken(System.getenv("HANZO_API_KEY"));

var result = new MarketplaceApi(client).postMarketplaceJobs();

curl -X POST https://api.hanzo.ai/v1/marketplace/jobs \
  -H "Authorization: Bearer $HANZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
       "amount": "<amount>",
       "attempt": "<attempt>"
     }'

curl -X POST https://api.hanzo.ai/v1/mcp \
  -H "Content-Type: application/json" \
  -d '{
       "jsonrpc": "2.0",
       "id": 1,
       "method": "tools/call",
       "params": {
         "name": "describe",
         "arguments": {
           "op": "list_marketplaces"
         }
       }
     }'

Marketplace API · All Hanzo APIs · Interactive reference