Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/AllianceBioversityCIAT/alliance-IGAD/llms.txt

Use this file to discover all available pages before exploring further.

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": "your-email@example.com",
    "password": "your-password"
  }'
Save your access token from the response: 
{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "user": {
    "user_id": "abc123",
    "email": "your-email@example.com",
    "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: 
curl -X POST https://api.igad-hub.com/api/proposals/PROP-20240115-A1B2/documents/upload-concept-file \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@concept-document.docx"

​
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 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
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
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

Build docs developers (and LLMs) love

Get started for freeTalk to us