Sosyabot Docs

Appearance

Marketplace Overview ​

The marketplace lets workspace users sell social-media services (writing, design, growth audits, account setup) to other Sosyabot users. Gigs are public; orders run through a state machine and money flows via the workspace's configured billing provider.

Endpoints (top-level) ​

GET    /api/v1/marketplace/gigs               list gigs (public)
GET    /api/v1/marketplace/gigs/:id           one (public)
POST   /api/v1/marketplace/gigs               create (auth)
PATCH  /api/v1/marketplace/gigs/:id           update (auth, owner)
DELETE /api/v1/marketplace/gigs/:id           delete (auth, owner)

GET    /api/v1/marketplace/orders             list orders (auth, buyer or seller)
GET    /api/v1/marketplace/orders/:id         one (auth)
POST   /api/v1/marketplace/orders             create (auth, buyer)
PATCH  /api/v1/marketplace/orders/:id/{accept|deliver|complete|cancel}   lifecycle

Authentication is required for everything except listing public gigs.

Lifecycle ​

A gig has status: "draft" | "published" | "paused". An order has status: "pending" | "in_progress" | "delivered" | "completed" | "disputed" | "cancelled" — see Orders.

Browsing Gigs

Selling

Orders

Payouts