Looking for legacy software product & theme license activations?

Legacy Licensing API (`/api/v1/licensing/*`)

Developer Platform API Reference v1.0

Interactive reference for BotDigit marketplace queries, proposal staging, contract monitoring, message drafting, and webhook configurations. All endpoints reside under the dedicated /api/developer/v1/* namespace.

Showing 29 endpoints

GET/api/developer/v1/projects

scope: projects.read

Discover open marketplace projects. Excludes internal scoring and private client data.

Request (CURL)

curl -X GET "https://api.botdigit.com/api/developer/v1/projects" \
  -H "Authorization: Bearer bdt_pat_yourTokenHere" \
  -H "Accept: application/json"

200 OK Response

{
  "success": true,
  "status": "ok"
}

GET/api/developer/v1/projects/{project_id}

scope: projects.read

Get Sanitized Project Details

Request (CURL)

curl -X GET "https://api.botdigit.com/api/developer/v1/projects/{project_id}" \
  -H "Authorization: Bearer bdt_pat_yourTokenHere" \
  -H "Accept: application/json"

200 OK Response

{
  "success": true,
  "status": "ok"
}

POST/api/developer/v1/projects/{project_id}/proposals/drafts

scope: proposals.draft

Stages a proposal draft for human review. Consumes 0 bid quota. Supports 'Idempotency-Key' header.

Request (CURL)

curl -X POST "https://api.botdigit.com/api/developer/v1/projects/{project_id}/proposals/drafts" \
  -H "Authorization: Bearer bdt_pat_yourTokenHere" \
  -H "Content-Type: application/json" \
  -d '{}'

200 OK Response

{
  "success": true,
  "status": "ok"
}

GET/api/developer/v1/proposals/drafts

scope: proposals.draft

List proposal drafts created by AI agents for the authenticated freelancer.

Request (CURL)

curl -X GET "https://api.botdigit.com/api/developer/v1/proposals/drafts" \
  -H "Authorization: Bearer bdt_pat_yourTokenHere" \
  -H "Accept: application/json"

200 OK Response

{
  "success": true,
  "status": "ok"
}

POST/api/developer/v1/proposals/drafts/{draft_id}/approve

scope: proposals.submit Human Gated

Human approves the draft, triggering domain validation, KYC check, quota deduction, and client notification.

Request (CURL)

curl -X POST "https://api.botdigit.com/api/developer/v1/proposals/drafts/{draft_id}/approve" \
  -H "Authorization: Bearer bdt_pat_yourTokenHere" \
  -H "Content-Type: application/json" \
  -d '{}'

200 OK Response

{
  "success": true,
  "status": "ok"
}

POST/api/developer/v1/proposals/drafts/{draft_id}/reject

scope: proposals.draft

Reject Proposal Draft

Request (CURL)

curl -X POST "https://api.botdigit.com/api/developer/v1/proposals/drafts/{draft_id}/reject" \
  -H "Authorization: Bearer bdt_pat_yourTokenHere" \
  -H "Content-Type: application/json" \
  -d '{}'

200 OK Response

{
  "success": true,
  "status": "ok"
}

GET/api/developer/v1/messages/threads

scope: messages.read

List conversation threads the authenticated developer/freelancer is a participant in.

Request (CURL)

curl -X GET "https://api.botdigit.com/api/developer/v1/messages/threads" \
  -H "Authorization: Bearer bdt_pat_yourTokenHere" \
  -H "Accept: application/json"

200 OK Response

{
  "success": true,
  "status": "ok"
}

GET/api/developer/v1/messages/threads/{thread_id}

scope: messages.read

Get Messages in Thread

Request (CURL)

curl -X GET "https://api.botdigit.com/api/developer/v1/messages/threads/{thread_id}" \
  -H "Authorization: Bearer bdt_pat_yourTokenHere" \
  -H "Accept: application/json"

200 OK Response

{
  "success": true,
  "status": "ok"
}

POST/api/developer/v1/messages/threads/{thread_id}/drafts

scope: messages.draft

Stages a message draft for client conversation awaiting human approval.

Request (CURL)

curl -X POST "https://api.botdigit.com/api/developer/v1/messages/threads/{thread_id}/drafts" \
  -H "Authorization: Bearer bdt_pat_yourTokenHere" \
  -H "Content-Type: application/json" \
  -d '{}'

200 OK Response

{
  "success": true,
  "status": "ok"
}

POST/api/developer/v1/messages/drafts/{draft_id}/approve

scope: messages.send Human Gated

Human Approve and Send Message Draft

Request (CURL)

curl -X POST "https://api.botdigit.com/api/developer/v1/messages/drafts/{draft_id}/approve" \
  -H "Authorization: Bearer bdt_pat_yourTokenHere" \
  -H "Content-Type: application/json" \
  -d '{}'

200 OK Response

{
  "success": true,
  "status": "ok"
}

GET/api/developer/v1/contracts

scope: contracts.read

List contracts where the authenticated user is either freelancer or client (IDOR safe).

Request (CURL)

curl -X GET "https://api.botdigit.com/api/developer/v1/contracts" \
  -H "Authorization: Bearer bdt_pat_yourTokenHere" \
  -H "Accept: application/json"

200 OK Response

{
  "success": true,
  "status": "ok"
}

GET/api/developer/v1/contracts/{contract_id}

scope: contracts.read

Get Contract Details

Request (CURL)

curl -X GET "https://api.botdigit.com/api/developer/v1/contracts/{contract_id}" \
  -H "Authorization: Bearer bdt_pat_yourTokenHere" \
  -H "Accept: application/json"

200 OK Response

{
  "success": true,
  "status": "ok"
}

GET/api/developer/v1/contracts/{contract_id}/milestones

scope: contracts.read

List Milestones for Contract

Request (CURL)

curl -X GET "https://api.botdigit.com/api/developer/v1/contracts/{contract_id}/milestones" \
  -H "Authorization: Bearer bdt_pat_yourTokenHere" \
  -H "Accept: application/json"

200 OK Response

{
  "success": true,
  "status": "ok"
}

POST/api/developer/v1/contracts/milestones/{milestone_id}/delivery-drafts

scope: deliveries.draft

Allows an AI agent to stage completed milestone work and attachments for freelancer review prior to formal submission.

Request (CURL)

curl -X POST "https://api.botdigit.com/api/developer/v1/contracts/milestones/{milestone_id}/delivery-drafts" \
  -H "Authorization: Bearer bdt_pat_yourTokenHere" \
  -H "Content-Type: application/json" \
  -d '{}'

200 OK Response

{
  "success": true,
  "status": "ok"
}

GET/api/developer/v1/contracts/delivery-drafts

scope: contracts.read

List Staged Delivery Drafts

Request (CURL)

curl -X GET "https://api.botdigit.com/api/developer/v1/contracts/delivery-drafts" \
  -H "Authorization: Bearer bdt_pat_yourTokenHere" \
  -H "Accept: application/json"

200 OK Response

{
  "success": true,
  "status": "ok"
}

POST/api/developer/v1/contracts/delivery-drafts/{draft_id}/approve

scope: deliveries.submit Human Gated

Submits milestone work to client, marks milestone status submitted, and notifies client.

Request (CURL)

curl -X POST "https://api.botdigit.com/api/developer/v1/contracts/delivery-drafts/{draft_id}/approve" \
  -H "Authorization: Bearer bdt_pat_yourTokenHere" \
  -H "Content-Type: application/json" \
  -d '{}'

200 OK Response

{
  "success": true,
  "status": "ok"
}

POST/api/developer/v1/contracts/delivery-drafts/{draft_id}/reject

scope: deliveries.draft

Reject Staged Delivery Draft

Request (CURL)

curl -X POST "https://api.botdigit.com/api/developer/v1/contracts/delivery-drafts/{draft_id}/reject" \
  -H "Authorization: Bearer bdt_pat_yourTokenHere" \
  -H "Content-Type: application/json" \
  -d '{}'

200 OK Response

{
  "success": true,
  "status": "ok"
}

GET/api/developer/v1/workspaces

scope: workspaces.read

List Workspaces (Agency & Enterprise)

Request (CURL)

curl -X GET "https://api.botdigit.com/api/developer/v1/workspaces" \
  -H "Authorization: Bearer bdt_pat_yourTokenHere" \
  -H "Accept: application/json"

200 OK Response

{
  "success": true,
  "status": "ok"
}

GET/api/developer/v1/workspaces/{workspace_id}

scope: workspaces.read

Get Workspace Details

Request (CURL)

curl -X GET "https://api.botdigit.com/api/developer/v1/workspaces/{workspace_id}" \
  -H "Authorization: Bearer bdt_pat_yourTokenHere" \
  -H "Accept: application/json"

200 OK Response

{
  "success": true,
  "status": "ok"
}

GET/api/developer/v1/workspaces/{workspace_id}/members

scope: workspaces.read

List Workspace Team Members & Seats

Request (CURL)

curl -X GET "https://api.botdigit.com/api/developer/v1/workspaces/{workspace_id}/members" \
  -H "Authorization: Bearer bdt_pat_yourTokenHere" \
  -H "Accept: application/json"

200 OK Response

{
  "success": true,
  "status": "ok"
}

GET/api/developer/v1/workspaces/{workspace_id}/projects

scope: projects.read

List Projects in Workspace

Request (CURL)

curl -X GET "https://api.botdigit.com/api/developer/v1/workspaces/{workspace_id}/projects" \
  -H "Authorization: Bearer bdt_pat_yourTokenHere" \
  -H "Accept: application/json"

200 OK Response

{
  "success": true,
  "status": "ok"
}

GET/api/developer/v1/webhooks

scope: webhooks.manage

List Webhook Subscriptions

Request (CURL)

curl -X GET "https://api.botdigit.com/api/developer/v1/webhooks" \
  -H "Authorization: Bearer bdt_pat_yourTokenHere" \
  -H "Accept: application/json"

200 OK Response

{
  "success": true,
  "status": "ok"
}

POST/api/developer/v1/webhooks

scope: webhooks.manage

Registers a new webhook destination with SSRF protection and unique HMAC-SHA256 signing secret.

Request (CURL)

curl -X POST "https://api.botdigit.com/api/developer/v1/webhooks" \
  -H "Authorization: Bearer bdt_pat_yourTokenHere" \
  -H "Content-Type: application/json" \
  -d '{}'

200 OK Response

{
  "success": true,
  "status": "ok"
}

DELETE/api/developer/v1/webhooks/{webhook_id}

scope: webhooks.manage

Delete Webhook Subscription

Request (CURL)

curl -X DELETE "https://api.botdigit.com/api/developer/v1/webhooks/{webhook_id}" \
  -H "Authorization: Bearer bdt_pat_yourTokenHere" \
  -H "Content-Type: application/json" \
  -d '{}'

200 OK Response

{
  "success": true,
  "status": "ok"
}

POST/api/developer/v1/webhooks/test-ping

scope: webhooks.manage

Dispatch Test Webhook Ping

Request (CURL)

curl -X POST "https://api.botdigit.com/api/developer/v1/webhooks/test-ping" \
  -H "Authorization: Bearer bdt_pat_yourTokenHere" \
  -H "Content-Type: application/json" \
  -d '{}'

200 OK Response

{
  "success": true,
  "status": "ok"
}

GET/api/developer/v1/proposals/bids

scope: proposals.read

Returns all active marketplace bids submitted by the authenticated freelancer.

Request (CURL)

curl -X GET "https://api.botdigit.com/api/developer/v1/proposals/bids" \
  -H "Authorization: Bearer bdt_pat_yourTokenHere" \
  -H "Accept: application/json"

200 OK Response

{
  "success": true,
  "status": "ok"
}

GET/api/developer/v1/proposals/bids/{project_id}

scope: proposals.read

Fetch the authenticated freelancer active bid for a specific project.

Request (CURL)

curl -X GET "https://api.botdigit.com/api/developer/v1/proposals/bids/{project_id}" \
  -H "Authorization: Bearer bdt_pat_yourTokenHere" \
  -H "Accept: application/json"

200 OK Response

{
  "success": true,
  "status": "ok"
}

GET/api/developer/v1/messages/drafts

scope: messages.read

Lists message drafts staged by AI agents awaiting human approval before dispatch.

Request (CURL)

curl -X GET "https://api.botdigit.com/api/developer/v1/messages/drafts" \
  -H "Authorization: Bearer bdt_pat_yourTokenHere" \
  -H "Accept: application/json"

200 OK Response

{
  "success": true,
  "status": "ok"
}

POST/api/developer/v1/messages/drafts/{draft_id}/reject

scope: messages.draft

Rejects and archives a staged AI message draft without dispatching to the client.

Request (CURL)

curl -X POST "https://api.botdigit.com/api/developer/v1/messages/drafts/{draft_id}/reject" \
  -H "Authorization: Bearer bdt_pat_yourTokenHere" \
  -H "Content-Type: application/json" \
  -d '{}'

200 OK Response

{
  "success": true,
  "status": "ok"
}

Was this page helpful?