This guide will walk you through creating your first AI-powered proposal in the Alliance IGAD Innovation Hub.
Prerequisites Before you begin, ensure you have:
An active account on the IGAD Innovation Hub platform
Your RFP document (PDF format)
Initial concept notes or reference materials
Step 1: Log in to your account Access the platform and authenticate:
curl -X POST https://api.igad-hub.com/api/auth/login \ -H "Content-Type: application/json" \ -d '{ "username": "[email protected] ", "password": "your-password" }'
Save your access token from the response:
{ "access_token" : "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." , "user" : { "user_id" : "abc123" , "email" : "[email protected] " , "name" : "Your Name" } }
Store the access token securely. You’ll need to include it in all subsequent API requests as a Bearer token.
Step 2: Create a new proposal Create your first proposal:
curl -X POST https://api.igad-hub.com/api/proposals \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "title": "Climate-Smart Agriculture Initiative", "description": "Proposal for sustainable farming practices in the IGAD region" }'
Response:
{ "proposal" : { "id" : "uuid-here" , "proposalCode" : "PROP-20240115-A1B2" , "title" : "Climate-Smart Agriculture Initiative" , "status" : "draft" , "completed_steps" : [] } }
Save the proposalCode - you’ll use it in subsequent requests.
Step 3: Upload your RFP document Upload the Request for Proposal you’re responding to:
curl -X POST https://api.igad-hub.com/api/proposals/PROP-20240115-A1B2/documents/upload \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -F "file=@path/to/rfp-document.pdf"
RFP documents must be in PDF format and under 10 MB in size.
Step 4: Add your concept materials You can either upload a concept document or provide concept text:
Upload concept file
Provide concept text
curl -X POST https://api.igad-hub.com/api/proposals/PROP-20240115-A1B2/documents/upload-concept-file \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -F "[email protected] "
curl -X POST https://api.igad-hub.com/api/proposals/PROP-20240115-A1B2/documents/save-concept-text \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "text": "Our climate-smart agriculture initiative aims to improve food security by introducing drought-resistant crop varieties and sustainable water management practices across three districts in the IGAD region..." }'
Step 5: Trigger RFP analysis Start the AI analysis of your RFP document:
curl -X POST https://api.igad-hub.com/api/proposals/PROP-20240115-A1B2/analyze-rfp \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
The analysis runs asynchronously. Poll for completion:
curl -X GET https://api.igad-hub.com/api/proposals/PROP-20240115-A1B2/analysis-status \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
The RFP analysis typically takes 1-3 minutes to complete. Poll every 3 seconds until status is “completed”.
Step 6: Analyze your concept Once RFP analysis is complete, analyze your concept:
curl -X POST https://api.igad-hub.com/api/proposals/PROP-20240115-A1B2/analyze-concept \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Poll for completion:
curl -X GET https://api.igad-hub.com/api/proposals/PROP-20240115-A1B2/concept-status \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
When complete, you’ll receive:
{ "status" : "completed" , "concept_analysis" : { "concept_analysis" : { "sections_needing_elaboration" : [ { "title" : "Climate Adaptation Strategies" , "rationale" : "RFP requires detailed climate resilience approaches" , "selected" : true } ] } } }
Step 7: Generate enhanced concept document Select sections you want to elaborate and generate an enhanced concept:
curl -X PUT https://api.igad-hub.com/api/proposals/PROP-20240115-A1B2/concept-evaluation \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "selected_sections": [ {"title": "Climate Adaptation Strategies", "selected": true} ], "user_comments": { "Climate Adaptation Strategies": "Focus on drought-resistant crops" } }'
Then generate the concept document:
curl -X POST https://api.igad-hub.com/api/proposals/PROP-20240115-A1B2/generate-concept-document \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d '{}'
Step 8: Review your generated content Retrieve your proposal with all generated content:
curl -X GET https://api.igad-hub.com/api/proposals/PROP-20240115-A1B2 \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
The response includes:
RFP analysis results
Concept analysis findings
Generated concept document (markdown format)
Completed workflow steps
Next steps Now that you have your enhanced concept document, you can:
Generate proposal structure Create a structured outline and workplan based on RFP requirements
Generate proposal template Download a Word template with your structure for offline editing
Upload reference proposals Add reference proposals to inform AI-generated content
Get draft feedback Upload your completed draft for AI-powered quality analysis
Common issues
Analysis stuck in 'processing' status
Analysis steps typically complete within 5 minutes. If stuck longer:
Check CloudWatch logs for Lambda worker errors
Verify DynamoDB table has write permissions
Try triggering analysis again with force: true parameter
Document upload fails with 400 error
Ensure:
File is in supported format (PDF for RFP, PDF/DOC/DOCX for concept)
File size is under limit (10 MB for RFP, 5 MB for references)
File is not corrupted and has valid header
Token expired error (401)
Access tokens expire after 1 hour. Use your refresh token to get a new one: curl -X POST https://api.igad-hub.com/api/auth/refresh \ -H "Content-Type: application/json" \ -d '{"refresh_token": "YOUR_REFRESH_TOKEN"}'
Learn more
Complete workflow guide Detailed explanation of all 4 workflow steps
API reference Complete API documentation
Architecture overview Understand the platform’s serverless architecture
Document management Learn about uploads, vectorization, and storage