Skip to main content

​
Overview

Supervisors in SFLUV are responsible for overseeing workflows assigned to specific roles. They can view workflow progress, export data for reporting, and manage their rewards account. Supervisors are typically assigned to workflows by proposers when creating workflow roles.

​
Requesting Supervisor Status

1

Submit Supervisor Request

Navigate to Settings → Role Management and select Request Supervisor Status.Provide your organization or team affiliation if applicable.
2

Wait for Admin Approval

An admin must approve your supervisor request.You’ll receive an email notification once your status is approved.
3

Access Supervisor Dashboard

Once approved, navigate to /supervisor to access your supervisor dashboard.
API Endpoint: POST /supervisors/request

​
Viewing Assigned Workflows

Supervisors can view workflows where they are assigned as a supervisor for specific roles.
1

Access Your Workflows

Navigate to /supervisor or use the API:
curl -X GET https://api.sfluv.com/supervisors/workflows \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"
2

Review Workflow Details

For each workflow, you can see:
  • Workflow title and description
  • Assigned roles and steps
  • Current status and progress
  • Improver assignments and completion status
  • Timestamps for key events
3

Monitor Step Completion

Track which steps have been:
  • Claimed by improvers
  • Started (in progress)
  • Completed
  • Paid out

​
Exporting Workflow Data

Supervisors can export workflow data for reporting and analysis.
1

Request Data Export

Use the export endpoint to generate workflow reports:
curl -X POST https://api.sfluv.com/supervisors/workflows/export \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "workflow-uuid",
    "format": "csv"
  }'
2

Download Export File

The API returns a downloadable file containing:
  • Workflow metadata
  • Step details and completion status
  • Improver assignments
  • Timestamps and bounty information
  • Work item submissions
3

Analyze Data

Use the exported data for:
  • Performance reporting
  • Budget tracking
  • Completion rate analysis
  • Improver productivity metrics
Supported Formats: CSV, JSON, Excel

​
Managing Rewards Account

Supervisors may receive bounties when assigned as supervisors to workflow roles. You can manage your primary rewards account.
1

Set Primary Rewards Account

Navigate to Settings → Rewards or use the API:
curl -X PUT https://api.sfluv.com/supervisors/primary-rewards-account \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_id": "your-wallet-uuid"
  }'
2

Verify Account Setup

Ensure the wallet is:
  • Connected to your SFLUV account
  • Verified and active
  • Capable of receiving SFLuv tokens

​
Supervisor Role in Workflows

​
Role Assignment

When proposers create workflows, they can assign a supervisor to specific roles: 
{
  "role_title": "Community Cleaner",
  "bounty": "1000000000000000000",  // 1 SFLuv
  "supervisor_title": "DPW Supervisor",
  "supervisor_bounty": "200000000000000000"  // 0.2 SFLuv
}

​
Supervisor Responsibilities

  • Oversight: Monitor assigned workflows and improver performance
  • Reporting: Export data for stakeholders and grant funders
  • Quality Assurance: Review work item submissions (photos, responses)
  • Communication: Coordinate with improvers and proposers
  • Documentation: Maintain records of workflow completion
Supervisors do NOT approve or reject workflow proposals. That responsibility belongs to voters.

​
Best Practices

Check your supervisor dashboard daily to stay updated on workflow progress.Set up notifications for:
  • New workflow assignments
  • Step completions
  • Issues requiring attention
Export workflow data regularly for record-keeping:
  • Weekly exports for active workflows
  • Final exports upon workflow completion
  • Monthly summary reports for stakeholders
Maintain open communication channels with:
  • Improvers completing workflow steps
  • Proposers who created the workflow
  • Admins for escalations
Establish clear expectations for work quality:
  • Review photo submissions for completeness
  • Verify written responses meet requirements
  • Provide feedback to improvers when needed

​
Troubleshooting

Solution: Ensure you have been approved as a supervisor and that proposers have assigned you to specific workflow roles.Check:
  • Your supervisor status is active
  • Workflows exist with your supervisor assignment
  • You’re logged in with the correct account
Solution: Verify the workflow ID is correct and you have access to that workflow.Common issues:
  • Invalid workflow ID
  • Workflow not assigned to you
  • Export format not supported
Solution: Check your primary rewards account is set correctly.Steps:
  1. Verify wallet is connected
  2. Confirm rewards account is set
  3. Check workflow step status is paid_out
  4. Contact admin if payment is missing

​
API Endpoints

​
Supervisor Role Management

  • POST /supervisors/request - Request supervisor status
  • GET /supervisors/approved - List approved supervisors (authenticated users)

​
Workflow Management

  • GET /supervisors/workflows - Get workflows where you are assigned as supervisor
  • POST /supervisors/workflows/export - Export workflow data

​
Rewards Management

  • PUT /supervisors/primary-rewards-account - Set primary rewards wallet

​
Admin Endpoints

  • GET /admin/supervisors - List all supervisors (admin)
  • PUT /admin/supervisors - Update supervisor settings (admin)

Build docs developers (and LLMs) love

Get started for freeTalk to us