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. The same terms asked again within the hour answer the same quote. Sent again with the signed authorization — on PAYMENT-SIGNATURE, or as payment — echoing that resource, the terms are cleared once more, and the rail checks it 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.

Request

12 fields, body application/json (required).

Response

201 body — 37 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>", brief: "<brief>" });

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>", brief="<brief>")

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>",
       "brief": "<brief>"
     }'

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": "get_marketplace"
         }
       }
     }'

Marketplace API · All Hanzo APIs · Interactive reference