Sosyabot Docs

Appearance

Selling ​

Sellers manage their catalog from /app/marketplace/seller.

Create a gig ​

POST /api/v1/marketplace/gigs
{
  "title": "...",
  "description": "...",
  "price": 250,
  "currency": "USD",
  "delivery_days": 5,
  "categories": ["copy", "growth"],
  "sample_media": ["<fileId>", ...],
  "status": "draft"
}

A draft gig isn't listed publicly. Switch status to "published" to expose it; "paused" hides it temporarily without losing reviews or order history.

Update a gig ​

PATCH /api/v1/marketplace/gigs/:id

Owner-only. Updates take effect immediately on the public list.

Fulfillment ​

When a buyer orders, the order moves through pending → in_progress → delivered → completed. Sellers act on:

  • PATCH /orders/:id/accept — start the work.
  • PATCH /orders/:id/deliver — bind the work product (uploaded files, post IDs) to the order's contract.posts[] and contract.notes.
  • PATCH /orders/:id/cancel — refund and close.

The buyer (or admin) calls PATCH /orders/:id/complete to release seller_payout.

Signature ​

Sellers usually publish a short signature shown next to their gigs:

GET    /api/v1/signatures/me            current signature
PATCH  /api/v1/signatures/me            update
GET    /api/v1/signatures/handle/:handle  public lookup

Orders

Payouts

Browsing