ReDesk AI › Introduction
ReDesk AI API
The ReDesk AI API exposes the project record: leads, proposals, SOP steps, approvals and invoices. Everything the web app does is available over REST, and every state change emits a webhook.
RESTWebhooksOAuth 2.0Sandbox
What the API covers
ResourceEndpointWhat it's for
project/v1/projectsA project is the record everything hangs off: the customer, the site, the system size and where it is in your SOP.
proposal/v1/proposalsA proposal is a versioned pricing document with the bill of materials attached.
sop_step/v1/sop_stepsAn SOP step is one checkpoint in a project's playbook: who owns it, how long it should take, whether it needs approval and what evidence proves it is done.
milestone/v1/milestonesA milestone is a payment released against a verified step, with its receipt.
Each resource has its own reference page: Projects, Proposals, SOP steps, Milestones.
Base URL and environments
EnvironmentBase URLKeys
Sandboxhttps://api.redesk.ai/v1sk_test_…, data resets never, no real money moves
Livehttps://api.redesk.ai/v1sk_live_…, real customers, real payments
Both environments share one URL — the key you send decides which data you see. A sandbox key can never read or write live records.
Conventions
TopicRule
FormatJSON request and response bodies, UTF-8. Send Content-Type: application/json.
IdsPrefixed by type — prj_, ord_, crw_ — so a stray id in a log tells you what it is.
TimestampsISO 8601 in UTC, e.g. 2026-08-04T04:30:00Z.
MoneyIntegers in the smallest unit (paise for INR) with a separate currency field.
VersioningThe version is in the path (/v1). Additive changes ship without a new version.