Documentation
/ Start
API-key quickstart
Integrate a partner site with Labored using only keys + env. No shared database required for production.
Full endpoint reference: /documentation/api/
1) Choose your key type
| Goal | Key | Where |
|---|---|---|
| Send leads into Labored | Partner hex key | Admin - requests_api_keys |
| Pull / upload portfolio, reviews, profile | Company lbr_* key |
Dashboard - Company - API keys |
| Both (recommended) | Partner hex and lbr_* |
Store both in partner .env |
2) Minimal .env
LABORED_API_URL=https://labored.net/api/submit_request
LABORED_API_KEY=YOUR_PARTNER_HEX_KEY
LABORED_PARTNER_SLUG=your-company-slug
LABORED_COMPANY_ID=123
LABORED_COMPANY_API_KEY=lbr_YOUR_COMPANY_KEY
LABORED_MEDIA_URL=https://labored.net/api/media
LABORED_PUBLIC_ORIGIN=https://labored.net
3) Smoke tests
Lead ingest
curl -s -X POST "https://labored.net/api/submit_request" \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_PARTNER_HEX_KEY" \
-d '{
"full_name":"Test Lead",
"service_requested":"Landscaping & Design",
"email":"[email protected]",
"partner_assigned":"your-company-slug",
"source":"partner_site"
}'
Media pull
curl -s "https://labored.net/api/media?company_id=123&include=portfolio&grouped=1" \
-H "X-API-Key: lbr_YOUR_COMPANY_KEY"
Media upload (single)
curl -s -X POST "https://labored.net/api/media_upload" \
-H "X-API-Key: lbr_YOUR_COMPANY_KEY" \
-F "company_id=123" \
-F "kind=single_image" \
-F "title=Test photo" \
-F "image=@/path/photo.jpg"
Media upload (before / after)
curl -s -X POST "https://labored.net/api/media_upload" \
-H "X-API-Key: lbr_YOUR_COMPANY_KEY" \
-F "company_id=123" \
-F "kind=before_after" \
-F "title=Yard reset" \
-F "image_before=@/path/before.jpg" \
-F "image_after=@/path/after.jpg"
4) Wire your site
- On form submit - POST partner payload to
submit_request - On gallery upload - POST multipart to
media_uploadwith the company key - On gallery render - GET
mediaand merge absolute URLs into your UI - Optional dashboard - show partner-scoped request status from your CRM or a Labored-side report
Full models, workflows, and diagrams live under Documentation. HTTP endpoint reference: /documentation/api/.