AiGov API Documentation

// List my initiatives
const res = await fetch('/api/v1/initiatives', { credentials: 'include' })
const { data } = await res.json()

// List all enterprise initiatives
const all = await fetch('/api/v1/initiatives?scope=enterprise', { credentials: 'include' })

// Get a single initiative
const detail = await fetch('/api/v1/initiatives/550e8400-...', { credentials: 'include' })
const { data: initiative } = await detail.json()

const res = await fetch('/api/v1/initiatives', {
  method: 'POST',
  credentials: 'include'
})
const { data } = await res.json() // { id: "uuid", ... }

const res = await fetch('/api/v1/initiatives/550e8400-.../transition', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  credentials: 'include',
  body: JSON.stringify({
    newStatus: 'Approved for Prototype',
    comment: 'Meets all requirements. Approved for pilot deployment.'
  })
})
const result = await res.json()

const res = await fetch('/api/v1/initiatives/550e8400-.../chat', {
  credentials: 'include'
})
const { data: messages } = await res.json()
// messages: [{ role, content, created_at }, ...]

const res = await fetch('/api/v1/initiatives/<id>/documents', {
  credentials: 'include'
})
const { data: docs } = await res.json()
// docs: [{ id, file_name, file_type, file_size, uploaded_at }, ...]

const formData = new FormData()
formData.append('file', fileInput.files[0])

const res = await fetch('/api/v1/initiatives/<id>/documents', {
  method: 'POST',
  credentials: 'include',
  body: formData
})
const { data } = await res.json()

const res = await fetch('/api/v1/initiatives/<id>/resources', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  credentials: 'include',
  body: JSON.stringify({
    role: 'Cloud Engineer',
    quantity: 2,
    duration_months: 6,
    location: 'Remote',
    pay_rate: 85,
    pay_frequency: 'hourly'
  })
})

const res = await fetch('/api/v1/initiatives/<id>/financials', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  credentials: 'include',
  body: JSON.stringify({
    category: 'licensing',
    description: 'Annual SaaS license for 250 seats',
    amount: 45000,
    frequency: 'annual'
  })
})

// List all inventory items
const res = await fetch('/api/v1/inventory', { credentials: 'include' })
const { data } = await res.json()

// Search with fuzzy matching
const search = await fetch('/api/v1/inventory?search=project+management', {
  credentials: 'include'
})
const { data: results } = await search.json()

const res = await fetch('/api/v1/inventory', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  credentials: 'include',
  body: JSON.stringify({
    tool_name: 'Jira',
    vendor: 'Atlassian',
    category: 'Engineering',
    department: 'Technology',
    description: 'Project tracking and agile management',
    status: 'active'
  })
})
const { data } = await res.json()

const res = await fetch('/api/v1/queues', { credentials: 'include' })
const { data: queues } = await res.json()
for (const q of queues) {
  console.log(q.name, q.is_active ? '(active)' : '(inactive)')
}

const res = await fetch('/api/v1/queues', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  credentials: 'include',
  body: JSON.stringify({ name: 'Regulatory', description: 'Compliance and regulatory tools' })
})
const { data } = await res.json()

const res = await fetch('/api/v1/initiatives/<id>/comments', { credentials: 'include' })
const { data: comments } = await res.json()

const res = await fetch('/api/v1/initiatives/<id>/comments', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  credentials: 'include',
  body: JSON.stringify({
    content: 'Approved — meets all security requirements.',
    review_type: 'security',
    traffic_light: 'green'
  })
})

const response = await fetch('/api/export/audit-logs?format=json', {
  credentials: 'include'
})
const logs = await response.json()
console.log(`Found ${logs.length} audit log entries`)

// Get notifications
const res = await fetch('/api/v1/notifications?limit=20', { credentials: 'include' })
const { data } = await res.json()

// Get unread count only
const count = await fetch('/api/v1/notifications?count_only=true', { credentials: 'include' })
const { data: unreadCount } = await count.json()

const res = await fetch('/api/v1/users?search=jane', { credentials: 'include' })
const { data: users } = await res.json()

const res = await fetch('/api/v1/users/<user-id>/roles', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  credentials: 'include',
  body: JSON.stringify({ role: 'function_lead', queue_id: '<queue-id>' })
})

// Get all dashboard data
const res = await fetch('/api/v1/dashboard', { credentials: 'include' })
const { data } = await res.json()
console.log(data.byFunction, data.funnel, data.volume, data.approval)

// Get a specific section
const volume = await fetch('/api/v1/dashboard?section=volume&months=6', {
  credentials: 'include'
})
const { data: trends } = await volume.json()

const res = await fetch('/api/tts', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ text: 'Hello, welcome to AiGov.' })
})
const audioBlob = await res.blob()
const audioUrl = URL.createObjectURL(audioBlob)
const audio = new Audio(audioUrl)
audio.play()