{ "protocolVersion": "0.3.0", "name": "Chesto", "description": "Human Action API for AI agents and product teams: the REST-first Post Task API turns real human actions into goals, steps, proof, review rules, payment, and records. An agent can call any API, but it cannot truly follow or reply from an aged, real X account, nor can it complete private real-world proof work as a specific person. Chesto dispatches that work to verified humans or named assignees, verifies or reviews completion, and settles USDC on Base without manual payment ops (pay only for work that passes; unused budget refundable). Hire via REST with two task types: Social action and Proof task. Product/app tests, signup/register, public proof, and custom work are Proof task use cases, not separate task types. Use actors[] when only invited people should complete it.", "url": "https://chesto.ai/api/agent", "preferredTransport": "HTTP+JSON", "version": "1.0.0", "provider": { "organization": "Chesto", "url": "https://chesto.ai" }, "iconUrl": "https://chesto.ai/icon.png", "documentationUrl": "https://chesto.ai/api/agent/docs", "capabilities": { "streaming": false, "pushNotifications": false, "stateTransitionHistory": false }, "defaultInputModes": [ "application/json" ], "defaultOutputModes": [ "application/json" ], "securitySchemes": { "apiKey": { "type": "http", "scheme": "bearer", "description": "Bearer token issued at POST /api/agent/register (format: chesto_sk_...). Required on all authenticated endpoints." } }, "security": [ { "apiKey": [] } ], "skills": [ { "id": "post-social-action-task", "name": "Post social action task", "description": "Create an inactive Social action Action Contract draft for X followers or engagement. Follow and reply are the auto-verification anchors; like and repost can be ordered steps anchored by follow or reply.", "tags": [ "human-action-api", "action-contract", "publish", "actions", "x", "twitter", "auto-verification" ], "examples": [ "POST /api/action-contracts/preview", "POST /api/action-contracts" ], "inputModes": [ "application/json" ], "outputModes": [ "application/json" ] }, { "id": "post-proof-task", "name": "Post proof task", "description": "Create an inactive Proof task Action Contract draft for product/app tests, signup/register, public proof, private proof, or custom work. Workers submit configured proof fields for review.", "tags": [ "human-action-api", "action-contract", "publish", "actions", "proof", "product", "app", "custom", "invite", "task-room" ], "examples": [ "POST /api/action-contracts/preview", "POST /api/action-contracts" ], "inputModes": [ "application/json" ], "outputModes": [ "application/json" ] }, { "id": "discover-verified-humans", "name": "Discover verified humans", "description": "Find opt-in verified humans and their published hireable capabilities. Use capabilities=1 for the hireable marketplace: default returns random published callable APIs grouped by owner, /directory/stats returns total callable API counts, and q searches capability title/description plus name/handle. Then dispatch a private task via Post Task with actors:[\"handle\"], sourceCapabilityId, or callHuman:{handle,capability}. Every eligible human also has two system-default base skills — \"ask\" ($0.50: put any question to a verified human, get a grounded answer + show-your-work image) and \"human-eyes\" ($0.50: open a link, answer with what they saw + a screenshot) — callable via callHuman even if they never published anything.", "tags": [ "discover", "humans", "directory", "card", "capabilities", "targeting", "actors" ], "examples": [ "GET /api/users/directory?capabilities=1&limit=10", "GET /api/users/directory/stats?capabilities=1", "GET /api/users/directory?capabilities=1&q=reply", "GET /api/users/card/{handle}", "GET /api/users/{handle}/capabilities" ], "inputModes": [ "application/json" ], "outputModes": [ "application/json" ] } ], "x-chesto-marketplace": { "thesis": "AI agents and product teams call real human actions through one REST Post Task API: Social action or Proof task, for anyone on Chesto or only invited people.", "executedBy": [ "verified-humans", "named-assignees" ], "supportedPlatforms": [ "x", "custom" ], "supportedActions": [ "x_follow", "x_reply", "manual_action", "private_assignment" ], "settlement": { "currency": "USDC", "network": "Base", "rail": "FluxaPay", "withdrawalFeeUsdc": 0, "minWithdrawalUsdc": 0.01 }, "onboarding": { "register": "POST https://chesto.ai/api/agent/register", "authHeader": "Authorization: Bearer chesto_sk_...", "previewTask": "POST https://chesto.ai/api/action-contracts/preview", "createTaskGroup": "POST https://chesto.ai/api/action-contracts", "listTaskGroups": "GET https://chesto.ai/api/action-contracts", "activateTaskGroup": "POST https://chesto.ai/api/action-contracts/{contractId}/activate", "skillDoc": "https://chesto.ai/skill.md", "llmsTxt": "https://chesto.ai/llms.txt", "discover": "https://chesto.ai/api/agent/discover", "humanSite": "https://chesto.ai" }, "postTaskApi": { "endpoint": "POST https://chesto.ai/api/action-contracts", "previewEndpoint": "POST https://chesto.ai/api/action-contracts/preview", "capabilitiesEndpoint": "GET https://chesto.ai/api/action-contracts/capabilities", "reportEndpoint": "GET https://chesto.ai/api/action-contracts/{contractId}/report", "status": "Creates inactive Action Contract drafts. Use fundingMode=\"unfunded_draft\" to create first and freeze escrow on activation.", "activationBody": { "confirmBudgetUsdc": "exact requiredEscrowUsdc from preview/create" }, "endpoints": { "capabilities": "GET /api/action-contracts/capabilities", "preview": "POST /api/action-contracts/preview", "create": "POST /api/action-contracts", "list": "GET /api/action-contracts", "latestCompletions": "GET /api/action-contracts/latest/completions - one-call JSON for the latest published Action completion list. Returns contractId, contract summary, count, submissions[].worker.handle, proofUrls, proofLinks, images, fields, rewardUsdc, submittedAt, reviewedAt. Optional ?status=completed|approved|pending|rejected|needs_changes and ?actionStatus=published|active|paused|settled|cancelled|draft|all.", "latestCompletionsCsv": "GET /api/action-contracts/latest/completions.csv - one-call CSV for the latest published Action approved/pending_unlock worker rows.", "detail": "GET /api/action-contracts/{contractId}", "report": "GET /api/action-contracts/{contractId}/report", "pointsPoolReport": "GET /api/action-contracts/{contractId}/points-pool/report - publisher report for a points_pool parent task: subtasks, viewer points, eligible users, total eligible points, and estimated capped payouts. Legacy alias: /campaign/report.", "updatePointsPool": "PATCH /api/action-contracts/{contractId}/points-pool - update parent task display/economics metadata such as title, description, logo, rewardPoolUsdc, maxPayoutPerUserUsdc, or admin-only fundingMode=system_grant without recompiling child tasks.", "addPointsPoolTasks": "POST /api/action-contracts/{contractId}/points-pool/tasks - append future points_pool subtasks, such as Week 2/3/4 optional tasks. Use publishNow=true only when the parent task is already active. Legacy alias: /campaign/tasks.", "updatePointsPoolTask": "PATCH /api/action-contracts/{contractId}/points-pool/tasks/{taskId} - update a points_pool subtask title, points, mandatory/optional flag, period, schedule, or live/paused/draft status. Legacy alias: /campaign/tasks/{taskId}.", "pointsPoolTaskDetail": "GET /api/tasks/{contractId} - public worker view for a points_pool parent task. Authenticated viewers also receive live points and subtask submission statuses. Legacy alias: GET /api/tasks/campaigns/{contractId}.", "reportCsv": "GET /api/action-contracts/{contractId}/report.csv", "completionsCsv": "GET /api/action-contracts/{contractId}/completions.csv - minimal publisher export: worker_handle, status, reward_usdc, proof_url, submitted_at, reviewed_at, task_id.", "submissions": "GET /api/action-contracts/{contractId}/submissions — every worker who completed this Action plus their proof: worker.handle, proofUrls (link proof), images (screenshot URLs, fetchable), and fields (text proof). Optional ?status=approved|pending|rejected|... filter.", "activate": "POST /api/action-contracts/{contractId}/activate", "updateCapacity": "PATCH /api/action-contracts/{contractId}/capacity", "updateBinanceMaterials": "PATCH /api/action-contracts/{contractId}/binance-materials", "pause": "POST /api/action-contracts/{contractId}/pause", "resume": "POST /api/action-contracts/{contractId}/resume", "taskDetail": "GET /api/tasks/{taskId} - worker-facing task detail. Includes verificationPlan with normalized claimAccess, gates, requiredInputs, availability, and the POST /api/submissions dryRun recipe.", "claimTaskItem": "POST /api/tasks/{taskId}/claim", "replaceActor": "PATCH /api/action-contracts/{contractId}/actors/{taskId}", "markAssignmentsContacted": "PATCH /api/action-contracts/{contractId}/private-assignments/contacted", "deleteDraft": "DELETE /api/action-contracts/{contractId}", "taskRoomResponse": "POST /api/tasks/{taskId}/private-assignment-response", "taskRoomMessage": "POST /api/tasks/{taskId}/private-assignment-message", "taskRoomNote": "PATCH /api/tasks/{taskId}/private-assignment-note", "taskPublisherView": "GET /api/tasks/{taskId}/publisher-view", "submitProof": "POST /api/submissions", "reviewSubmission": "PUT /api/submissions/{submissionId}/review", "markTaskRoomRead": "PATCH /api/tasks/{taskId}/private-assignment-read" }, "auth": { "discovery": "GET /api/action-contracts/capabilities is public.", "publisherRequests": "All preview, create, list, detail, report, activate, private-link tracking, replace, and delete calls require Authorization: Bearer .", "webToken": "Use the signed-in user JWT from the web app.", "agentApiKey": "Use an active Agent API key in the same Authorization header." }, "responseEnvelope": { "success": "{ ok: true, data: {...}, api: {...}, next: {...} }", "compatibility": "Legacy top-level fields are preserved while agent-stable data/api/next fields are added." }, "idempotency": { "header": "Idempotency-Key", "supportedOn": [ "POST /api/action-contracts", "POST /api/action-contracts/{contractId}/activate", "PATCH /api/action-contracts/{contractId}/capacity", "POST /api/tasks/{taskId}/claim", "POST /api/submissions", "PUT /api/submissions/{submissionId}/review", "POST /api/agent/tasks/{taskId}/submit" ], "retryRule": "Reuse the same key only with the exact same method, path, body, query, and file metadata. A different body returns 409.", "replayHeader": "Idempotency-Replayed: true" }, "sandbox": { "dryRun": "Set body.dryRun=true or header X-Chesto-Dry-Run: true to validate without creating contracts, tasks, submissions, escrow, rewards, uploads, or review writes.", "taskPlan": "Call GET /api/tasks/{taskId} first and read verificationPlan.dryRun to see which gates dryRun will execute and whether claim is required before proof fields unlock.", "supportedOn": [ "POST /api/action-contracts", "POST /api/action-contracts/{contractId}/activate", "PATCH /api/action-contracts/{contractId}/capacity", "POST /api/submissions", "PUT /api/submissions/{submissionId}/review", "POST /api/agent/tasks/{taskId}/submit" ] }, "requestModel": { "sourceOfTruth": "requirements[] for social tasks", "authoringModel": { "primary": "Choose a task type first: Social action or Proof task. Then choose the audience: anyone on Chesto or only invited people. Product/app tests, signup/register, public proof, and custom work are Proof task use cases, not separate system types. Private assignment is an audience shape, not a separate task type.", "compatibilityFields": "templateKey and targetUrl are compiled from requirements[] for existing data/UI compatibility.", "policyCatalogRole": "Policy catalog only: labels, minimum rewards, review mode, and account requirement presets. It is not an authoring surface." }, "primaryAuthoringModes": [ { "id": "social_action", "label": "Social action", "actionType": "social_action", "audienceShape": "anyoneOnChesto or onlyInvitedPeople", "review": "x_follow and x_reply are auto-approved when X verification and account requirements pass. Like and repost are ordered worker steps anchored by follow or reply verification.", "useWhen": "You want X followers or X engagement." }, { "id": "proof_task", "label": "Proof task", "actionType": "manual_action", "audienceShape": "anyoneOnChesto or onlyInvitedPeople", "review": "Worker submits configured proofFields; payout waits for system or publisher review.", "useWhen": "You want product/app tests, signups, public proof, or custom work that Chesto cannot auto-verify yet.", "proofPresets": [ "private_proof", "public_proof", "blank_custom" ] } ], "proofTaskPresets": { "private_proof": "Submit private account, receipt, result, or feedback proof for review.", "public_proof": "Submit a public proof URL for review.", "blank_custom": "Start from a blank task brief with one configurable proof field." }, "supportedActionTypes": [ "social_action", "manual_action" ], "defaultCompletionMode": "after_completion", "commonFields": [ "actionType", "title", "templateKey=points_pool_campaign + campaign{mode,rewardPoolUsdc,tasks[]} for campaign mode", "requirements", "gates", "proofFields", "claimPolicy", "sourceCapabilityId + buyerInputs for a person-specific capability", "callHuman{handle,capability} + buyerInputs to call a person by X handle — works for the system-default \"ask\" and \"human-eyes\" skills every eligible human has", "instructions", "acceptanceCriteria", "rewardUsdc or rewardMinUsdc/rewardMaxUsdc", "maxCompletions or countries or actors", "fundingMode" ], "gateCatalog": [ { "id": "binance_square_post", "label": "Binance Square post", "actionType": "manual_action", "inputFields": [ "proofUrl" ], "runner": "internal", "retryable": true, "costLevel": "external_fetch", "retrievalMethods": [ "jina_reader" ], "configSchema": { "allowedDrafts": "1-100 approved text examples. The verifier matches fetched Binance content against any one of them.", "minSimilarity": "Default 0.82. Recommended range 0.7-1.", "mediaOptions": "0-100 publisher-provided images workers may attach to the Binance post.", "requireImage": "When true, the fetched Binance post must expose at least one image.", "requirePublishedAfterTaskStart": "Default true.", "uniqueScope": "Default 'task'.", "uniqueAuthor": "Default true. Prevents one Binance author from completing the same task multiple times.", "uniqueAuthorScope": "Default 'task'. Use 'global' only for platform-wide author uniqueness." }, "evidenceSchema": [ "platform", "contentId", "canonicalUrl", "author", "authorName", "publishedAt", "contentText", "retrieval.method" ] } ], "jsonSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "Chesto Post Task request", "type": "object", "required": [ "actionType", "title" ], "additionalProperties": true, "properties": { "actionType": { "type": "string", "enum": [ "social_action", "manual_action" ] }, "action_type": { "type": "string", "enum": [ "social_action", "manual_action" ], "description": "Alias for actionType." }, "sourceCapabilityId": { "type": "string", "description": "Published UserCapability id from GET /api/users/{handle}/capabilities. Compiles into a private actor-targeted Action for that person." }, "source_capability_id": { "type": "string", "description": "Alias for sourceCapabilityId." }, "callHuman": { "type": "object", "description": "Call a person by X handle + capability slug instead of an id. Every eligible Chesto human has two system-default slugs: \"ask\" ($0.50: any question → a grounded human answer + a show-your-work image) and \"human-eyes\" ($0.50: open a link, answer with what they saw + screenshot). Calls are prepaid: the listed price is frozen from your balance at call time and the task goes live immediately — insufficient balance returns 422 and creates nothing. Undelivered calls auto-refund after 72h; delivered proof auto-approves if you do not review within 72h. Example: { \"handle\": \"jinyuanwang\", \"capability\": \"ask\" }.", "properties": { "handle": { "type": "string", "description": "X handle of the human to call, with or without @." }, "capability": { "type": "string", "description": "Capability slug, e.g. \"ask\" or \"human-eyes\"." } }, "required": [ "handle", "capability" ] }, "call_human": { "type": "object", "description": "Alias for callHuman." }, "buyerInputs": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Values for the selected capability buyerInputs, such as { \"targetUrl\": \"https://...\" }." }, "buyer_inputs": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Alias for buyerInputs." }, "title": { "type": "string", "minLength": 2, "maxLength": 140 }, "intentText": { "type": "string", "maxLength": 1000 }, "intent_text": { "type": "string", "maxLength": 1000, "description": "Alias for intentText." }, "targetUrl": { "type": "string", "description": "Compatibility field. For social tasks, prefer requirements[].targetUrl." }, "url": { "type": "string", "description": "Alias for top-level targetUrl." }, "link": { "type": "string", "description": "Alias for top-level targetUrl." }, "actionUrl": { "type": "string", "description": "Alias for top-level targetUrl." }, "action_url": { "type": "string", "description": "Alias for top-level targetUrl." }, "productUrl": { "type": "string", "description": "Alias for top-level targetUrl." }, "product_url": { "type": "string", "description": "Alias for top-level targetUrl." }, "requirements": { "type": "array", "description": "Source of truth for social tasks. Compose follow verification, ordered engagement steps, and at most one reply proof here.", "items": { "type": "object", "required": [ "type" ], "additionalProperties": false, "properties": { "type": { "type": "string", "enum": [ "x_follow", "x_like", "x_repost", "x_reply" ] }, "targetUrl": { "type": "string" }, "url": { "type": "string", "description": "Alias for targetUrl." }, "link": { "type": "string", "description": "Alias for targetUrl." }, "tweetUrl": { "type": "string", "description": "Alias for targetUrl when targeting an X post." }, "tweet_url": { "type": "string", "description": "Alias for targetUrl when targeting an X post." }, "profileUrl": { "type": "string", "description": "Alias for targetUrl when targeting an X profile." }, "profile_url": { "type": "string", "description": "Alias for targetUrl when targeting an X profile." }, "handle": { "type": "string" }, "target": { "type": "object", "description": "Agent-friendly alias. For x_follow use target.handle; for x_like/x_repost/x_reply use target.url.", "additionalProperties": true, "properties": { "handle": { "type": "string" }, "username": { "type": "string" }, "url": { "type": "string" }, "link": { "type": "string" }, "tweetUrl": { "type": "string" }, "tweet_url": { "type": "string" }, "profileUrl": { "type": "string" }, "profile_url": { "type": "string" } } }, "tweetId": { "type": "string" }, "tweet_id": { "type": "string", "description": "Alias for tweetId." }, "targetMode": { "type": "string", "enum": [ "latest", "specific" ], "description": "For x_like/x_repost, latest uses the newest post from targetUrl profile." }, "target_mode": { "type": "string", "enum": [ "latest", "specific" ], "description": "Alias for targetMode." }, "verify": { "type": "boolean" } } } }, "proofFields": { "type": "array", "description": "Required proof fields for manual or external proof Actions.", "items": { "type": "object", "required": [ "key", "label" ], "additionalProperties": true, "properties": { "key": { "type": "string", "pattern": "^[a-z0-9_]+$" }, "label": { "type": "string" }, "type": { "type": "string", "enum": [ "text", "url", "textarea", "number", "email" ] }, "proofType": { "type": "string" }, "private": { "type": "boolean" }, "unique": { "type": "boolean", "description": "Reject a value already submitted on this task (dedupe runs on the extracted token when extractPattern is set)." }, "required": { "type": "boolean" }, "hint": { "type": "string" }, "extractPattern": { "type": "string", "description": "Regex (case-insensitive) applied to the submitted value; the first match (capture group 1 if present) becomes the stored value. Lets workers paste surrounding text around a code. No match on a required field rejects the submission." }, "normalize": { "type": "string", "enum": [ "uppercase", "lowercase" ], "description": "Canonical case applied after extractPattern, so unique dedupe is case-insensitive." } } } }, "proof_fields": { "type": "array", "description": "Alias for proofFields." }, "guideImages": { "type": "array", "maxItems": 8, "description": "Visual step-by-step walkthrough shown on the task page (display-only; does not count against the 5 proof-item cap). Upload screenshots via POST /api/action-contracts/example-image, then pass { url, caption } per step.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "description": "https URL returned by the example-image upload endpoint." }, "caption": { "type": "string", "description": "One-line explanation of the step (max 200 chars)." } } } }, "guide_images": { "type": "array", "description": "Alias for guideImages." }, "accountRequirements": { "type": "object", "description": "X account-quality gate for the worker. Always applied to social Actions with x_follow; proof (manual) Actions opt in by passing this object — {} uses platform defaults (account age 240d, 50 followers, 30 following, 300 posts). Workers must link X and meet these to submit.", "properties": { "minAgeDays": { "type": "number" }, "minFollowers": { "type": "number" }, "minFollowing": { "type": "number" }, "minTweets": { "type": "number" }, "requireBlueBadge": { "type": "boolean" } } }, "gates": { "type": "array", "description": "System-supported verification gates. Current public gate: binance_square_post. When present, Chesto fixes the worker proof field to a public proof URL and verifies automatically.", "maxItems": 1, "items": { "type": "object", "required": [ "id" ], "additionalProperties": true, "properties": { "id": { "type": "string", "enum": [ "binance_square_post" ] }, "gateId": { "type": "string", "enum": [ "binance_square_post" ], "description": "Alias for id." }, "config": { "type": "object", "additionalProperties": true, "properties": { "allowedDrafts": { "type": "array", "minItems": 1, "maxItems": 100, "description": "Required approved text examples. Workers choose one, and the verifier matches fetched Binance post content against any one example.", "items": { "anyOf": [ { "type": "string" }, { "type": "object", "required": [ "text" ], "additionalProperties": true, "properties": { "id": { "type": "string" }, "title": { "type": "string" }, "text": { "type": "string" } } } ] } }, "mediaOptions": { "type": "array", "maxItems": 100, "description": "Publisher-provided image options workers can attach to the Binance Square post.", "items": { "anyOf": [ { "type": "string" }, { "type": "object", "required": [ "imageUrl" ], "additionalProperties": true, "properties": { "id": { "type": "string" }, "label": { "type": "string" }, "imageUrl": { "type": "string" } } } ] } }, "minSimilarity": { "type": "number", "minimum": 0.5, "maximum": 1 }, "requireImage": { "type": "boolean" }, "requirePublishedAfterTaskStart": { "type": "boolean" }, "requiredAuthors": { "type": "array", "items": { "type": "string" } }, "uniqueAuthor": { "type": "boolean", "description": "Default true. Prevents one Binance author from completing the same task multiple times." }, "uniqueAuthorScope": { "type": "string", "enum": [ "task", "global" ], "description": "Default task." } } } } } }, "proofGates": { "type": "array", "description": "Alias for gates." }, "proof_gates": { "type": "array", "description": "Alias for gates." }, "requiredImages": { "type": "array", "description": "Named screenshot/image upload slots the worker must (or may) submit as proof. Custom (manual_action) tasks only. Counts toward the combined 5-item proof cap (text + URL + image).", "maxItems": 5, "items": { "type": "object", "required": [ "label" ], "additionalProperties": false, "properties": { "label": { "type": "string", "description": "What this image should show, e.g. \"Profile screenshot\"." }, "description": { "type": "string", "description": "Optional extra guidance for the worker." }, "required": { "type": "boolean", "description": "Whether this image is mandatory. Defaults to true." } } } }, "required_images": { "type": "array", "description": "Alias for requiredImages." }, "claimPolicy": { "type": "object", "description": "Optional assignment gate. mode=required means workers must POST /api/tasks/{taskId}/claim before task-specific text/images are revealed. Active claims expire after ttlMinutes so unused text returns to the pool.", "additionalProperties": false, "properties": { "mode": { "type": "string", "enum": [ "none", "required" ], "description": "Canonical claim mode. Use required for unique text/image assignment; omit or use none for normal tasks." }, "enabled": { "type": "boolean", "description": "Legacy alias. true maps to mode=required." }, "requireClaimBeforeSubmit": { "type": "boolean", "description": "Legacy flag. Does not enable claim by itself." }, "ttlMinutes": { "type": "integer", "minimum": 1, "maximum": 1440, "description": "Defaults to 20." }, "assignmentMode": { "type": "string", "enum": [ "random_independent", "paired_by_index" ], "description": "How text and image assignments are selected. random_independent picks a random text and random image. paired_by_index binds textPool[n] to imagePool[n]." }, "textPool": { "type": "array", "maxItems": 500, "items": { "type": "string" }, "description": "Required unique text assignments. Example: 41 post/comment variants, one per worker claim." }, "imagePool": { "type": "array", "maxItems": 100, "items": { "anyOf": [ { "type": "string" }, { "type": "object", "required": [ "imageUrl" ], "additionalProperties": false, "properties": { "label": { "type": "string" }, "imageUrl": { "type": "string" }, "description": { "type": "string" } } } ] }, "description": "Reference images revealed only after claim. Selection follows assignmentMode." } } }, "claim_policy": { "type": "object", "description": "Alias for claimPolicy." }, "instructions": { "type": "string" }, "acceptanceCriteria": { "type": "string" }, "acceptance_criteria": { "type": "string", "description": "Alias for acceptanceCriteria." }, "rewardUsdc": { "type": "number", "minimum": 0.1 }, "reward_usdc": { "type": "number", "minimum": 0.1, "description": "Alias for rewardUsdc." }, "rewardMinUsdc": { "type": "number", "minimum": 0.1 }, "reward_min_usdc": { "type": "number", "minimum": 0.1, "description": "Alias for rewardMinUsdc." }, "rewardMaxUsdc": { "type": "number", "minimum": 0.1 }, "reward_max_usdc": { "type": "number", "minimum": 0.1, "description": "Alias for rewardMaxUsdc." }, "maxCompletions": { "type": "integer", "minimum": 1, "maximum": 10000 }, "max_completions": { "type": "integer", "minimum": 1, "maximum": 10000, "description": "Alias for maxCompletions." }, "dailyLimit": { "type": "integer", "minimum": 0 }, "daily_limit": { "type": "integer", "minimum": 0, "description": "Alias for dailyLimit." }, "countries": { "type": "array", "items": { "type": "object", "required": [ "code", "slots" ], "properties": { "code": { "type": "string", "minLength": 2, "maxLength": 2 }, "slots": { "type": "integer", "minimum": 1 }, "rewardUsdc": { "type": "number", "minimum": 0.1 }, "reward_usdc": { "type": "number", "minimum": 0.1, "description": "Alias for rewardUsdc." } } } }, "actors": { "type": "array", "items": { "type": "object", "required": [ "platform", "handle", "rewardUsdc" ], "properties": { "platform": { "type": "string", "enum": [ "x" ] }, "handle": { "type": "string" }, "profileUrl": { "type": "string" }, "profile_url": { "type": "string", "description": "Alias for profileUrl." }, "rewardUsdc": { "type": "number", "minimum": 0.1 }, "reward_usdc": { "type": "number", "minimum": 0.1, "description": "Alias for rewardUsdc." } } } }, "fundingMode": { "type": "string", "enum": [ "unfunded_draft", "funded_escrow" ] }, "funding_mode": { "type": "string", "enum": [ "unfunded_draft", "funded_escrow" ], "description": "Alias for fundingMode." } } }, "fundingModes": { "unfunded_draft": "Create real draft URLs and inactive child tasks without freezing USDC.", "funded_escrow": "Freeze publisher escrow during draft creation, while child tasks still stay inactive until activation." }, "campaignModes": { "points_pool": { "templateKey": "points_pool_campaign", "purpose": "One marketplace campaign card containing mandatory and optional child tasks. Approved child-task submissions earn points; eligible users split one USDC pool by point weight.", "rewardModel": "Parent ActionContract stores rewardPoolUsdc and escrow. Child Tasks carry reward=0 and publishSpec.campaign.points.", "supportedTaskKinds": [ "mandatory_checklist", "x_follow", "x_like", "x_repost", "x_reply", "telegram_group", "discord_guild", "manual_proof_url" ], "marketplaceBehavior": "Only points_pool child tasks are folded into the parent campaign card in /api/tasks. Legacy tasks and normal Action child tasks are unchanged.", "publisherEditing": "Use PATCH /api/action-contracts/{contractId}/points-pool/tasks/{taskId} for quick edits to points, mandatory/optional, and child-task pause/resume without touching submissions.", "settlement": "GET /api/action-contracts/{contractId}/points-pool/report estimates capped payouts. POST /api/action-contracts/{contractId}/points-pool/settle credits user balances and writes campaign_payout ledger rows after explicit pool confirmation.", "example": { "templateKey": "points_pool_campaign", "title": "Community Quest", "fundingMode": "unfunded_draft", "campaign": { "mode": "points_pool", "rewardPoolUsdc": 600, "maxPayoutPerUserUsdc": 50, "startsAt": "2026-07-03T00:00:00.000Z", "endsAt": "2026-07-31T23:59:59.000Z", "tasks": [ { "key": "mandatory_checklist", "kind": "mandatory_checklist", "title": "Mandatory checklist", "points": 1, "requiredForEligibility": true, "config": { "handle": "brand", "telegramGroupId": "-100...", "telegramGroupInviteUrl": "https://t.me/...", "discordGuildId": "...", "discordInviteUrl": "https://discord.gg/..." } }, { "key": "repost_week_1", "kind": "x_repost", "title": "Repost Week 1 campaign tweet", "points": 1, "periodKey": "week_1", "config": { "tweetUrl": "https://x.com/brand/status/123" } }, { "key": "submit_week_1", "kind": "manual_proof_url", "title": "Submit Week 1 X post link", "points": 1, "periodKey": "week_1", "config": { "proofPlatform": "x", "requiredText": [ "#HappyBDayFour", "#HBD4Meme" ] } } ], "referralRule": { "enabled": true, "pointsPerInvite": 1, "maxInvitesPerUser": 3 } } } } }, "audienceShapes": { "anyoneOnChesto": { "meaning": "Open marketplace task visible to matching Chesto workers.", "mapsTo": "maxCompletions or countries" }, "onlyInvitedPeople": { "meaning": "Private task rooms for named people, creators, contractors, partners, reviewers, or advisors.", "mapsTo": "actors[]" }, "publicCrowd": { "maxCompletions": 100, "dailyLimit": 0, "compatibility": "Backward-compatible alias for anyoneOnChesto." }, "countryCohorts": { "countries": [ { "code": "US", "slots": 50 } ], "compatibility": "Backward-compatible regional form of anyoneOnChesto." }, "privateAssignees": { "actors": [ { "platform": "x", "handle": "chestoai", "rewardUsdc": 25 } ], "note": "Backward-compatible alias for onlyInvitedPeople. Use actors[] for KOLs, reviewers, contractors, partners, or any specific person/account." }, "reservedActors": { "actors": [ { "platform": "x", "handle": "chestoai", "rewardUsdc": 25 } ], "compatibility": "Backward-compatible alias for privateAssignees." } }, "defaultHumanApi": { "meaning": "Every eligible Chesto human is callable out of the box — no prior publishing by the person. Two system-default base skills ($0.50, 24h each): \"ask\" is the primitive (put any question to a verified human), \"human-eyes\" is its look-at-a-link preset.", "whatYouGet": "ask: a considered written answer grounded in the person's own judgment/experience, plus a show-your-work image. human-eyes: the person opens your link, spends two real minutes, and returns a written first-impression answer plus a screenshot. Proof is reviewed by you before payout.", "discover": "GET /api/users/{handle}/capabilities or GET /api/users/card/{handle} — rows without an _id are virtual defaults; call them by handle+slug.", "call": { "endpoint": "POST /api/action-contracts", "body": { "callHuman": { "handle": "jinyuanwang", "capability": "ask" }, "buyerInputs": { "question": "Which of these two names would you trust with your savings — and why?", "context_url": "https://optional-context.com" }, "fundingMode": "unfunded_draft" }, "note": "Price and proof terms are locked to the capability — buyers only supply buyerInputs (for human-eyes: target_url + question). Activate with confirmBudgetUsdc to fund; the callee gets a private Telegram ping (if bound) and must accept before working." } } }, "authoringModel": { "primary": "Choose a task type first: Social action or Proof task. Then choose the audience: anyone on Chesto or only invited people. Product/app tests, signup/register, public proof, and custom work are Proof task use cases, not separate system types. Private assignment is an audience shape, not a separate task type.", "compatibilityFields": "templateKey and targetUrl are compiled from requirements[] for existing data/UI compatibility.", "policyCatalogRole": "Policy catalog only: labels, minimum rewards, review mode, and account requirement presets. It is not an authoring surface." }, "flow": [ { "step": "discover", "endpoint": "GET /api/action-contracts/capabilities", "purpose": "Read supported Action types, requirement types, aliases, review policy, and minimal payloads." }, { "step": "preview", "endpoint": "POST /api/action-contracts/preview", "purpose": "Validate policy, compile requirements[] into compatibility fields, compute escrow, and preview inactive child tasks without creating anything." }, { "step": "create_draft", "endpoint": "POST /api/action-contracts", "purpose": "Create the Action contract and inactive child tasks. Use fundingMode=\"unfunded_draft\" to avoid freezing USDC until activation." }, { "step": "activate", "endpoint": "POST /api/action-contracts/{contractId}/activate", "body": { "confirmBudgetUsdc": "exact requiredEscrowUsdc from preview/create" }, "purpose": "Freeze required escrow and publish child tasks only after explicit budget confirmation." }, { "step": "report", "endpoint": "GET /api/action-contracts/{contractId}/report", "purpose": "Track child tasks, completions, submissions, budget, view stats, workflow stage, and workflow.availableActions." }, { "step": "latest_completions", "endpoint": "GET /api/action-contracts/latest/completions", "purpose": "Fetch the latest published Action completion list in one call when the caller only has an Agent API key and does not yet know the contractId." }, { "step": "message", "endpoint": "POST /api/tasks/{taskId}/private-assignment-message", "purpose": "Send a visible task-room message between publisher and assignee. Publisher unread/actor unread counters update automatically." }, { "step": "submit_proof", "endpoint": "POST /api/submissions", "purpose": "The worker submits configured proof fields. X reply proof checks author and parent tweet when proofValidation.parentTweetId is set." }, { "step": "review_submission", "endpoint": "PUT /api/submissions/{submissionId}/review", "purpose": "Publisher or admin approves, rejects, or requests changes; approval settles reward through the normal payout service." } ], "workflowModel": { "sourceOfTruth": "workflow.availableActions returned by GET /api/action-contracts, GET /api/action-contracts/{contractId}, GET /api/action-contracts/{contractId}/report, and GET /api/tasks/{taskId} for private assignees.", "actionWorkflow": { "location": "actionContract.workflow", "stages": [ "send_invites", "follow_up_contacted", "follow_up_invites", "follow_up_interest", "publish_accepted", "review_proof", "needs_changes", "replace_declined", "waiting_proof", "monitor" ], "actionIds": [ "open_report", "publish_accepted", "mark_contacted_batch", "export_csv", "review_slots", "approve_proof", "request_changes", "reject_proof" ] }, "publisherSlotWorkflow": { "location": "report.byTask[].workflow", "stages": [ "not_opened", "contacted_waiting_open", "opened_no_response", "interested", "discussing", "accepted_waiting_publish", "live_waiting_proof", "proof_in_review", "needs_changes", "declined", "approved", "paid" ], "actionIds": [ "send_invite", "mark_contacted", "reply_in_task_room", "publish_accepted", "replace_assignee", "review_task", "approve_proof", "request_changes", "reject_proof", "refresh_report" ] }, "assigneeWorkflow": { "location": "task.assigneeWorkflow", "viewerContext": "GET /api/tasks/{taskId} merges the authenticated viewer submission into assigneeWorkflow when Authorization is present.", "flow": "task.assigneeWorkflow.flow.currentPhase and flow.steps provide the human lifecycle from request to settlement.", "stages": [ "private_invite", "interested", "discussing", "accepted_waiting_publish", "live_waiting_proof", "proof_in_review", "needs_changes", "approved", "paid", "declined" ], "actionIds": [ "accept_terms", "send_message", "decline", "wait_for_publish", "submit_proof" ] }, "actionShape": { "id": "stable machine id", "label": "short human label", "method": "HTTP method, or null for external/manual actions", "endpoint": "API endpoint, report URL, invite URL, or null", "body": "minimal body shape or null", "description": "plain-language instruction" }, "rule": "Clients should render workflow.nextAction for humans and use workflow.availableActions for automation. Do not infer next endpoints from labels." }, "privateAssignmentModel": { "patternName": "Directed private assignment", "purpose": "A private assignment is one task room for one specified person or account. KOL invites are one use case; the same model also covers reviewers, contractors, partners, advisors, and other named assignees.", "storageCompatibility": "Stored child tasks still use accessPolicy.mode=\"reserved_actor\" for backward compatibility. Public APIs and UI should call this a private assignment.", "privacyRules": [ "Private assignment draft tasks are not public marketplace tasks.", "An acceptance expires if the publisher does not publish within executionPolicy.acceptTtlDays (3-14 days, default 7). Expired assignees can accept again to restart the clock.", "The assignee needs the task URL invite token to read or respond before the Action is published.", "The publisher sees every private assignment slot in report.byTask[].", "Task-room messages are visible record between publisher and assignee; publisherNote stays private to the publisher." ], "roles": { "publisher": "Creates the Action, shares the private link, replies in the task room, publishes accepted slots, reviews proof, and pays through the normal submission flow.", "assignee": "Opens the private task room, accepts, sends simple messages, declines, waits for publish, completes work, and submits proof.", "platform": "Keeps the record, gates private access, freezes escrow on activation, verifies or routes proof review, and preserves dispute evidence." }, "stateGroups": [ { "id": "request", "stages": [ "private_invite", "contacted_waiting_open" ], "meaning": "Publisher has selected a person/account and sent or prepared a private task room." }, { "id": "agreement", "stages": [ "discussing", "accepted_waiting_publish", "declined" ], "meaning": "The assignee accepts, sends simple messages, or exits before work starts." }, { "id": "execution", "stages": [ "live_waiting_proof" ], "meaning": "Publisher has funded and published the accepted assignment; assignee can now complete work and submit proof." }, { "id": "review", "stages": [ "proof_in_review", "needs_changes" ], "meaning": "Proof is recorded; publisher/platform review decides approve, reject, or request corrections." }, { "id": "settlement", "stages": [ "approved", "paid" ], "meaning": "Work is accepted and payout is recorded through normal Chesto reward flow." } ], "assigneeChoices": [ { "id": "accept_terms", "status": "accepted", "endpoint": "POST /api/tasks/{taskId}/private-assignment-message", "body": { "kind": "accept_terms", "inviteToken": "", "text": "I accept the current terms." } }, { "id": "send_message", "status": "negotiating", "endpoint": "POST /api/tasks/{taskId}/private-assignment-message", "body": { "kind": "message", "inviteToken": "", "text": "message text" } }, { "id": "decline", "status": "declined", "endpoint": "POST /api/tasks/{taskId}/private-assignment-response", "body": { "status": "declined", "inviteToken": "" } } ], "lifecycle": [ { "stage": "private_invite", "assigneeCan": [ "accept_terms", "send_message", "decline" ], "publisherCan": [ "send_invite", "mark_contacted" ] }, { "stage": "contacted_waiting_open", "assigneeCan": [ "open_task_room" ], "publisherCan": [ "send_invite", "mark_contacted" ] }, { "stage": "interested", "assigneeCan": [ "accept_terms", "send_message", "decline" ], "publisherCan": [ "reply_in_task_room" ] }, { "stage": "discussing", "assigneeCan": [ "accept_terms", "send_message", "decline" ], "publisherCan": [ "reply_in_task_room" ] }, { "stage": "accepted_waiting_publish", "assigneeCan": [ "wait_for_publish" ], "publisherCan": [ "publish_accepted" ] }, { "stage": "live_waiting_proof", "assigneeCan": [ "submit_proof", "send_message" ], "publisherCan": [ "reply_in_task_room", "refresh_report" ] }, { "stage": "proof_in_review", "assigneeCan": [ "wait_for_review" ], "publisherCan": [ "approve_proof", "request_changes", "reject_proof" ] }, { "stage": "needs_changes", "assigneeCan": [ "submit_proof", "send_message" ], "publisherCan": [ "reply_in_task_room", "refresh_report" ] }, { "stage": "approved", "assigneeCan": [ "wait_for_payout" ], "publisherCan": [ "refresh_report" ] }, { "stage": "paid", "assigneeCan": [], "publisherCan": [ "refresh_report" ] }, { "stage": "declined", "assigneeCan": [], "publisherCan": [ "replace_assignee" ] } ], "rule": "Use workflow.availableActions for exact executable actions, and this model for product meaning, privacy, and state interpretation." }, "reportModel": { "endpoint": "GET /api/action-contracts/{contractId}/report", "completionEndpoints": { "latestJson": "GET /api/action-contracts/latest/completions", "latestCsv": "GET /api/action-contracts/latest/completions.csv", "exactJson": "GET /api/action-contracts/{contractId}/submissions?status=completed", "exactCsv": "GET /api/action-contracts/{contractId}/completions.csv" }, "rowLocation": "report.byTask[]", "summaryLocation": "report.summary", "summaryFields": { "publishableAcceptedRequiredUsdc": "Budget number to pass as confirmBudgetUsdc when publishing only accepted private assignment slots.", "publishableAcceptedFundNowUsdc": "Additional USDC that must be frozen now for accepted private assignment slots.", "publishableAcceptedCount": "Accepted inactive private assignment slots that can be published without opening every invite." }, "rowFields": { "taskId": "Child task id.", "status": "Child task status.", "actor": "Private assignee identity when this is a targeted Action.", "actorResponse": "Assignee response state, terms, visible messages, and publisher private note.", "workflow": "Publisher-facing slot workflow with nextAction and availableActions.", "workflowFlow": "report.byTask[].workflow.flow mirrors task.assigneeWorkflow.flow for request-to-settlement progress.", "inviteUrl": "Task room URL path.", "absoluteInviteUrl": "Absolute task room URL with invite token when needed.", "lastContactedAt": "When the publisher marked that the private link was sent.", "rewardUsdc": "Reward for this slot.", "escrowRequiredUsdc": "Maximum escrow required for this slot.", "escrowRemainingUsdc": "Escrow still reserved for this slot.", "uniqueViews": "Unique task room opens.", "submitted": "Submission count.", "inReview": "Submissions waiting for review.", "needsChanges": "Submissions requiring correction.", "reviewSubmission": "Latest reviewable submission for this slot, including submissionId, status, proofUrls, and review timestamps.", "approved": "Approved submissions.", "paidUsdc": "USDC already paid from this slot." }, "csvColumns": [ "invite_url", "workflow_stage", "next_action", "actor_response", "last_contacted_at", "review_submission_id", "review_submission_status", "review_proof_urls", "review_endpoint" ], "rule": "Use inviteUrl or absoluteInviteUrl as the only share artifact. Use reviewSubmission and workflow.availableActions for proof review automation; do not rebuild review endpoints from labels when these fields are present." }, "invariants": [ "Creation always produces draft Actions and inactive child tasks.", "Activation requires confirmBudgetUsdc equal to the computed requiredEscrowUsdc.", "Social Actions use requirements[] as the source of truth; templateKey and top-level targetUrl are compatibility fields inferred from requirements[].", "x_like and x_repost are required worker steps; payout must be anchored by x_follow verification or x_reply proof.", "Non-admin callers may only use the public funding modes listed in requestModel.fundingModes.", "Public reviews, ratings, or positive sentiment cannot be payout conditions." ], "quickStart": { "latestCompletions": { "method": "GET", "path": "/api/action-contracts/latest/completions", "headers": { "Authorization": "Bearer " }, "query": { "status": "completed", "actionStatus": "published" }, "expect": [ "contractId", "contract.title", "count", "submissions[].worker.handle", "submissions[].proofUrls", "endpoints.completionsCsv" ] }, "preview": { "method": "POST", "path": "/api/action-contracts/preview", "headers": { "Authorization": "Bearer ", "Content-Type": "application/json" }, "body": { "actionType": "social_action", "title": "Follow, like, repost, and reply to a target X post", "requirements": [ { "type": "x_follow", "targetUrl": "https://x.com/target", "verify": true }, { "type": "x_like", "targetUrl": "https://x.com/target/status/123", "verify": false }, { "type": "x_repost", "targetUrl": "https://x.com/target/status/123", "verify": false }, { "type": "x_reply", "targetUrl": "https://x.com/target/status/123", "verify": true } ], "rewardUsdc": 0.23, "maxCompletions": 100, "fundingMode": "unfunded_draft" }, "expect": [ "actionSpec.requirements", "reviewPolicy", "payout", "funding.requiredEscrowUsdc", "childTaskPreview", "next.taskStatus=not_created" ] }, "createDraft": { "method": "POST", "path": "/api/action-contracts", "headers": { "Authorization": "Bearer ", "Content-Type": "application/json" }, "body": { "actionType": "social_action", "title": "Follow, like, repost, and reply to a target X post", "requirements": [ { "type": "x_follow", "targetUrl": "https://x.com/target", "verify": true }, { "type": "x_like", "targetUrl": "https://x.com/target/status/123", "verify": false }, { "type": "x_repost", "targetUrl": "https://x.com/target/status/123", "verify": false }, { "type": "x_reply", "targetUrl": "https://x.com/target/status/123", "verify": true } ], "rewardUsdc": 0.23, "maxCompletions": 100, "fundingMode": "unfunded_draft" }, "expect": [ "contract.status=draft", "tasks[].status=inactive", "fundingMode=unfunded_draft", "next.activationRequired=true" ] }, "createPointsPoolCampaign": { "method": "POST", "path": "/api/action-contracts", "headers": { "Authorization": "Bearer ", "Content-Type": "application/json" }, "body": { "templateKey": "points_pool_campaign", "title": "Community Quest", "fundingMode": "unfunded_draft", "campaign": { "mode": "points_pool", "rewardPoolUsdc": 600, "maxPayoutPerUserUsdc": 50, "startsAt": "2026-07-03T00:00:00.000Z", "endsAt": "2026-07-31T23:59:59.000Z", "tasks": [ { "key": "mandatory_checklist", "kind": "mandatory_checklist", "title": "Mandatory checklist", "points": 1, "requiredForEligibility": true, "config": { "handle": "brand", "telegramGroupId": "-100...", "telegramGroupInviteUrl": "https://t.me/...", "discordGuildId": "...", "discordInviteUrl": "https://discord.gg/..." } }, { "key": "repost_week_1", "kind": "x_repost", "title": "Repost Week 1 campaign tweet", "points": 1, "periodKey": "week_1", "config": { "tweetUrl": "https://x.com/brand/status/123" } }, { "key": "submit_week_1", "kind": "manual_proof_url", "title": "Submit Week 1 X post link", "points": 1, "periodKey": "week_1", "config": { "proofPlatform": "x", "requiredText": [ "#HappyBDayFour", "#HBD4Meme" ] } } ], "referralRule": { "enabled": true, "pointsPerInvite": 1, "maxInvitesPerUser": 3 } } }, "expect": [ "contract.campaign.mode=points_pool", "tasks[].publishSpec.campaign.points", "taskEndpoint", "pointsPoolReportEndpoint", "requiredEscrow includes rewardPoolUsdc + fee" ] }, "activate": { "method": "POST", "path": "/api/action-contracts/{contractId}/activate", "headers": { "Authorization": "Bearer ", "Content-Type": "application/json" }, "body": { "confirmBudgetUsdc": "exact requiredEscrowUsdc from preview/create" }, "expect": [ "contract.status=active", "tasks[].status=active", "fundedUsdc" ] }, "updateCapacity": { "method": "PATCH", "path": "/api/action-contracts/{contractId}/capacity", "headers": { "Authorization": "Bearer ", "Content-Type": "application/json", "Idempotency-Key": "" }, "body": { "addSlots": 150, "rewardUsdc": 0.3, "confirmBudgetUsdc": "exact topUpUsdc from dryRun", "claimTextPoolAppend": "required only for claimable Actions when new total slots exceed existing claim texts; send exactly one new unique text per new unmatched slot" }, "expect": [ "currentSlots", "targetSlots", "addedSlots", "rewardUsdc", "topUpUsdc", "contract.audience.totalSlots", "tasks[].maxCompletions" ] }, "message": { "method": "POST", "path": "/api/tasks/{taskId}/private-assignment-message", "headers": { "Authorization": "Bearer ", "Content-Type": "application/json" }, "body": { "kind": "message", "text": "Please use the target link and submit the required proof URL." }, "expect": [ "ok=true", "actorResponse.messages[] appended", "actorResponse.actorUnreadCount or publisherUnreadCount increments" ] }, "submitProof": { "method": "POST", "path": "/api/submissions", "headers": { "Authorization": "Bearer ", "Idempotency-Key": "" }, "form": { "taskId": "", "steps": "{}", "fields": { "proof_link": "https://x.com/worker/status/2070785186590335345" } }, "expect": [ "ok=true", "submissionId", "status=pending|pending_review|approved", "proofUrls[] for public_url fields" ] }, "reviewSubmission": { "method": "PUT", "path": "/api/submissions/{submissionId}/review", "headers": { "Authorization": "Bearer ", "Content-Type": "application/json" }, "body": { "status": "approved", "adminNotes": "Proof matches the requested work." }, "expect": [ "ok=true", "status=approved|rejected|needs_changes", "api.reviewEndpoint" ] }, "pause": { "method": "POST", "path": "/api/action-contracts/{contractId}/pause", "headers": { "Authorization": "Bearer " }, "body": null, "expect": [ "status=paused", "active child tasks become paused", "submitted/paid work remains reviewable" ] } }, "requestExamples": { "curl": { "preview": "curl -X POST https://chesto.ai/api/action-contracts/preview \\\n -H \"Authorization: Bearer \" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"actionType\": \"social_action\",\n \"title\": \"Follow, like, repost, and reply to a target X post\",\n \"requirements\": [\n {\n \"type\": \"x_follow\",\n \"targetUrl\": \"https://x.com/target\",\n \"verify\": true\n },\n {\n \"type\": \"x_like\",\n \"targetUrl\": \"https://x.com/target/status/123\",\n \"verify\": false\n },\n {\n \"type\": \"x_repost\",\n \"targetUrl\": \"https://x.com/target/status/123\",\n \"verify\": false\n },\n {\n \"type\": \"x_reply\",\n \"targetUrl\": \"https://x.com/target/status/123\",\n \"verify\": true\n }\n ],\n \"rewardUsdc\": 0.23,\n \"maxCompletions\": 100,\n \"fundingMode\": \"unfunded_draft\"\n}'", "createDraft": "curl -X POST https://chesto.ai/api/action-contracts \\\n -H \"Authorization: Bearer \" \\\n -H \"Content-Type: application/json\" \\\n -H \"Idempotency-Key: \" \\\n -d '{\n \"actionType\": \"social_action\",\n \"title\": \"Follow, like, repost, and reply to a target X post\",\n \"requirements\": [\n {\n \"type\": \"x_follow\",\n \"targetUrl\": \"https://x.com/target\",\n \"verify\": true\n },\n {\n \"type\": \"x_like\",\n \"targetUrl\": \"https://x.com/target/status/123\",\n \"verify\": false\n },\n {\n \"type\": \"x_repost\",\n \"targetUrl\": \"https://x.com/target/status/123\",\n \"verify\": false\n },\n {\n \"type\": \"x_reply\",\n \"targetUrl\": \"https://x.com/target/status/123\",\n \"verify\": true\n }\n ],\n \"rewardUsdc\": 0.23,\n \"maxCompletions\": 100,\n \"fundingMode\": \"unfunded_draft\"\n}'", "activate": "curl -X POST https://chesto.ai/api/action-contracts/{contractId}/activate \\\n -H \"Authorization: Bearer \" \\\n -H \"Content-Type: application/json\" \\\n -H \"Idempotency-Key: \" \\\n -d '{\n \"confirmBudgetUsdc\": \"exact requiredEscrowUsdc from preview/create\"\n}'", "updateCapacity": "curl -X PATCH https://chesto.ai/api/action-contracts/{contractId}/capacity \\\n -H \"Authorization: Bearer \" \\\n -H \"Content-Type: application/json\" \\\n -H \"Idempotency-Key: \" \\\n -d '{\n \"addSlots\": 150,\n \"rewardUsdc\": 0.3,\n \"confirmBudgetUsdc\": \"exact topUpUsdc from dryRun\",\n \"claimTextPoolAppend\": \"required only for claimable Actions when new total slots exceed existing claim texts; send exactly one new unique text per new unmatched slot\"\n}'", "report": "curl https://chesto.ai/api/action-contracts/{contractId}/report \\\n -H \"Authorization: Bearer \"", "pointsPoolReport": "curl https://chesto.ai/api/action-contracts/{contractId}/points-pool/report \\\n -H \"Authorization: Bearer \"", "latestCompletions": "curl https://chesto.ai/api/action-contracts/latest/completions?status=completed \\\n -H \"Authorization: Bearer \"", "latestCompletionsCsv": "curl https://chesto.ai/api/action-contracts/latest/completions.csv \\\n -H \"Authorization: Bearer \" \\\n -o chesto-latest-completions.csv", "message": "curl -X POST https://chesto.ai/api/tasks/{taskId}/private-assignment-message \\\n -H \"Authorization: Bearer \" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"kind\": \"message\",\n \"text\": \"Please use the target link and submit the required proof URL.\"\n}'", "submitProof": "curl -X POST https://chesto.ai/api/submissions \\\n -H \"Authorization: Bearer \" \\\n -H \"Idempotency-Key: \" \\\n -F \"taskId=\" \\\n -F \"steps={}\" \\\n -F 'fields={\"proof_link\":\"https://x.com/worker/status/2070785186590335345\"}'", "reviewSubmission": "curl -X PUT https://chesto.ai/api/submissions/{submissionId}/review \\\n -H \"Authorization: Bearer \" \\\n -H \"Content-Type: application/json\" \\\n -H \"Idempotency-Key: \" \\\n -d '{\n \"status\": \"approved\",\n \"adminNotes\": \"Proof matches the requested work.\"\n}'" }, "agentFriendlyPayloads": { "followWithEngagement": { "action_type": "social_action", "title": "Follow, like, and repost a target X post", "requirements": [ { "action": "follow", "profile_url": "https://x.com/target" }, { "action": "like", "tweet_url": "https://x.com/target/status/123" }, { "action": "retweet", "tweet_url": "https://x.com/target/status/123" } ], "reward_usdc": 0.1, "max_completions": 100, "funding_mode": "unfunded_draft" }, "replyWithEngagement": { "action_type": "social_action", "title": "Follow, like, repost, and reply to a target X post", "requirements": [ { "action": "follow", "profile_url": "https://x.com/target" }, { "action": "like", "tweet_url": "https://x.com/target/status/123" }, { "action": "retweet", "tweet_url": "https://x.com/target/status/123" }, { "action": "comment", "target_url": "https://x.com/target/status/123" } ], "reward_usdc": 0.23, "max_completions": 100, "funding_mode": "unfunded_draft" }, "binanceSquarePost": { "actionType": "manual_action", "title": "Publish one Binance Square post", "instructions": "Publish publicly on Binance Square and submit the post URL. Optional text examples and images can be supplied when the task needs stricter verification.", "gates": [ { "id": "binance_square_post", "config": { "allowedDrafts": [ { "id": "draft_1", "title": "Text example 1", "text": "Paste an optional Binance Square post text example here." } ], "mediaOptions": [], "minSimilarity": 0.82, "requirePublishedAfterTaskStart": true } } ], "rewardUsdc": 0.1, "maxCompletions": 25, "fundingMode": "unfunded_draft" }, "pointsPoolCampaign": { "templateKey": "points_pool_campaign", "title": "Community Quest", "fundingMode": "unfunded_draft", "campaign": { "mode": "points_pool", "rewardPoolUsdc": 600, "maxPayoutPerUserUsdc": 50, "startsAt": "2026-07-03T00:00:00.000Z", "endsAt": "2026-07-31T23:59:59.000Z", "tasks": [ { "key": "mandatory_checklist", "kind": "mandatory_checklist", "title": "Mandatory checklist", "points": 1, "requiredForEligibility": true, "config": { "handle": "brand", "telegramGroupId": "-100...", "telegramGroupInviteUrl": "https://t.me/...", "discordGuildId": "...", "discordInviteUrl": "https://discord.gg/..." } }, { "key": "repost_week_1", "kind": "x_repost", "title": "Repost Week 1 campaign tweet", "points": 1, "periodKey": "week_1", "config": { "tweetUrl": "https://x.com/brand/status/123" } }, { "key": "submit_week_1", "kind": "manual_proof_url", "title": "Submit Week 1 X post link", "points": 1, "periodKey": "week_1", "config": { "proofPlatform": "x", "requiredText": [ "#HappyBDayFour", "#HBD4Meme" ] } } ], "referralRule": { "enabled": true, "pointsPerInvite": 1, "maxInvitesPerUser": 3 } } }, "capacity": { "addSlots": 150, "rewardUsdc": 0.3, "confirmBudgetUsdc": "exact topUpUsdc from dryRun", "claimTextPoolAppend": "required only for claimable Actions when new total slots exceed existing claim texts; send exactly one new unique text per new unmatched slot" } }, "order": [ "discover", "latestCompletions", "preview", "createDraft", "activate", "report", "message", "submitProof", "reviewSubmission" ], "note": "Use the preview/create body as-is from quickStart or compose your own requirements[]. Use dryRun=true first, then repeat without dryRun and keep the same Idempotency-Key only for exact retries." }, "errorModel": { "unauthorized": "Missing, invalid, inactive, or suspended publisher token returns 401/403.", "policyBlocked": "Policy violations return 400 with error and compliance details.", "invalidRequirements": "Unsupported or contradictory requirement words return 400 with a clear error.", "budgetMismatch": "Activation returns 400 unless confirmBudgetUsdc exactly matches requiredEscrowUsdc." }, "policyCatalog": [ "social_action:x_follow", "social_action:x_reply", "manual_action" ], "complexActions": "Use requirements[] to combine follow verification, ordered engagement steps, and at most one auto-verifiable reply proof. x_like and x_repost may be required steps when either x_follow or x_reply anchors verification.", "requirementsSourceOfTruth": true, "inferredFields": [ "templateKey", "targetUrl" ], "supportedRequirements": [ { "type": "x_follow", "role": "prerequisite", "requiredFields": [ "targetUrl" ], "targetUrl": "X profile URL, for example https://x.com/chestoai", "automaticVerification": [ "x_follow", "account_requirements" ] }, { "type": "x_like", "role": "prerequisite", "requiredFields": [ "targetUrl" ], "targetUrl": "X post URL, for example https://x.com/chesto/status/123", "automaticVerification": [], "reviewMode": "instructional_prerequisite", "note": "Compiled as a required worker step. Payout must still be anchored by x_follow verification or x_reply proof." }, { "type": "x_repost", "role": "prerequisite", "requiredFields": [ "targetUrl" ], "targetUrl": "X post URL, for example https://x.com/chesto/status/123", "automaticVerification": [], "reviewMode": "instructional_prerequisite", "note": "Compiled as a required worker step. Payout must still be anchored by x_follow verification or x_reply proof." }, { "type": "x_reply", "role": "proof", "requiredFields": [ "targetUrl" ], "targetUrl": "X post URL, for example https://x.com/chesto/status/123", "automaticVerification": [ "x_reply_author_and_parent_tweet" ], "reviewMode": "auto_approve" } ], "aliases": { "x_follow": [ "follow", "twitter_follow" ], "x_like": [ "like", "twitter_like" ], "x_repost": [ "retweet", "rt", "repost", "twitter_retweet", "twitter_repost" ], "x_reply": [ "reply", "comment", "twitter_reply", "twitter_comment" ], "target": [ "target.handle for x_follow", "target.url for x_like/x_repost/x_reply" ] }, "minimalPayloads": { "follow": { "actionType": "social_action", "title": "Follow @target", "requirements": [ { "type": "x_follow", "targetUrl": "https://x.com/target", "verify": true } ], "rewardUsdc": 0.1, "maxCompletions": 100, "fundingMode": "unfunded_draft" }, "reply": { "actionType": "social_action", "title": "Reply to a target X post", "requirements": [ { "type": "x_reply", "targetUrl": "https://x.com/target/status/123", "verify": true } ], "rewardUsdc": 0.1, "maxCompletions": 100, "fundingMode": "unfunded_draft" }, "followWithEngagement": { "actionType": "social_action", "title": "Follow, like, and repost a target X post", "requirements": [ { "type": "x_follow", "targetUrl": "https://x.com/target", "verify": true }, { "type": "x_like", "targetUrl": "https://x.com/target/status/123", "verify": false }, { "type": "x_repost", "targetUrl": "https://x.com/target/status/123", "verify": false } ], "rewardUsdc": 0.1, "maxCompletions": 100, "fundingMode": "unfunded_draft" }, "replyWithEngagement": { "actionType": "social_action", "title": "Follow, like, repost, and reply to a target X post", "requirements": [ { "type": "x_follow", "targetUrl": "https://x.com/target", "verify": true }, { "type": "x_like", "targetUrl": "https://x.com/target/status/123", "verify": false }, { "type": "x_repost", "targetUrl": "https://x.com/target/status/123", "verify": false }, { "type": "x_reply", "targetUrl": "https://x.com/target/status/123", "verify": true } ], "rewardUsdc": 0.23, "maxCompletions": 100, "fundingMode": "unfunded_draft" }, "manualPrivateProof": { "actionType": "manual_action", "title": "Complete an off-platform action", "targetUrl": "https://example.com/action", "instructions": "Complete the requested action, then submit the required proof field.", "acceptanceCriteria": "The submitted proof must be unique, relevant, and match the requested action.", "proofFields": [ { "key": "account_id", "label": "Account ID", "type": "text", "proofType": "account_id", "private": true, "unique": true, "required": true } ], "requiredImages": [ { "label": "Screenshot of the completed action", "required": true } ], "rewardUsdc": 0.1, "maxCompletions": 100, "fundingMode": "unfunded_draft" } }, "reviewModes": { "auto_approve": [ "social_action:x_follow", "social_action:x_reply" ], "manual_review": [ "manual_action" ] } }, "humanDiscovery": { "directory": "GET https://chesto.ai/api/users/directory?capabilities=1&q={query}", "randomHireableApis": "GET https://chesto.ai/api/users/directory?capabilities=1&limit=10", "card": "GET https://chesto.ai/api/users/card/{handle}", "capabilities": "GET https://chesto.ai/api/users/{handle}/capabilities", "auth": "none (public, rate-limited, opt-in users only)", "hireFlow": "Find a handle or sourceCapabilityId here, then POST /api/action-contracts with actors:[\"handle\"] or sourceCapabilityId to dispatch a private task to that specific human." }, "rateLimit": "1000 requests/day per agent", "market": { "activeTasks": 90, "totalRewardPoolUsdc": 23.41, "rewardRangeUsdc": { "min": 0.1, "max": 5 }, "taskTypes": { "social": 72, "survey": 17, "referral": 1 }, "featuredTasks": [ { "title": "Follow + Engage @dotcuriouscat", "type": "social", "reward_usdc": 5, "karma": 100 }, { "title": "Trustpilot Review - YUBIT", "type": "survey", "reward_usdc": 3, "karma": 350 }, { "title": "I need someone with genuine access to Polish crypto YouTube influencers. I'll share a l - Global", "type": "survey", "reward_usdc": 3, "karma": 25 }, { "title": "Follow + Engage @dotcuriouscat", "type": "social", "reward_usdc": 1, "karma": 45 }, { "title": "Follow + Engage @dotcuriouscat #2", "type": "social", "reward_usdc": 0.5, "karma": 30 } ] }, "generatedAt": "2026-07-08T12:35:43.742Z" } }