Build Your First BotDigit Integration

Personal Access Tokens use the standard format bdt_pat_<prefix>_<secret>. Only the SHA-256 hash is preserved on BotDigit servers, so store your token securely upon generation.

Follow the principle of least privilege. For an AI discovery & drafting agent, select:

Query open projects available for proposal bidding. Sensitive client metrics and internal rating formulas are stripped.

curl -X GET "https://api.botdigit.com/api/developer/v1/projects?limit=5" \
  -H "Authorization: Bearer bdt_pat_yourprefix_yoursecrettoken12345" \
  -H "Accept: application/json"

Pass the target project UUID in the URL. Staging a draft transitions it to pending_approval in the freelancer’s Approval Center. No monthly bid quota is deducted.

curl -X POST "https://api.botdigit.com/api/developer/v1/projects/3fa85f64-5717-4562-b3fc-2c963f66afa6/proposals/drafts" \
  -H "Authorization: Bearer bdt_pat_yourprefix_yoursecrettoken12345" \
  -H "Content-Type: application/json" \
  -d '{
    "bid_amount": "1500.00",
    "delivery_days": 7,
    "proposal_text": "We can build this high-performance integration using Rust Axum and Next.js.",
    "ai_agent_id": "my-local-agent-v1",
    "ai_agent_notes": "Estimated 30 hours of engineering."
  }'

The freelancer can approve the draft via the BotDigit web UI with 1-click, or programmatically using a token authorized with proposals.submit. This executes atomic claiming, deducts bid quota, and publishes the live proposal to the client.

curl -X POST "https://api.botdigit.com/api/developer/v1/proposals/drafts/9c118a72-8821-4f3b-b218-129038472901/approve" \
  -H "Authorization: Bearer bdt_pat_yourprefix_yoursecrettoken12345"