1. Uploads Module
  • Auth Module
    • Merchant
      • Register Merchant
      • Login Merchant
    • User
      • Register User
      • Login User
    • OTP
      • Send OTP
      • Verify OTP
      • Reset Password
    • Token
      • Refresh Access Token
      • Logout
    • OAuth
      • Google
        • Initiate Google Sign-In (User)
        • Google Callback (User)
        • Initiate Google Sign-In (Merchant)
        • Google Callback (Merchant)
      • Exchange OAuth Code
      • Complete Merchant Profile (OAuth)
  • Merchants Module
    • Banks
      • List Banks
      • Resolve Bank Account
    • Profile
      • Get My Profile
      • Update My Profile
      • Update Avatar
    • Contests
      • List My Contests
      • Create Contest
      • Get Contest
      • Update Contest
      • Cancel Contest
    • Entries
      • Add Entry
      • Remove Entry
    • Analytics
      • Get Contest Analytics
      • Get Merchant Analytics
    • Payouts
      • Save Bank Details
      • Get Bank Details
      • Get Payout Summary
      • List Payout Requests
      • Get Payout Request
    • KYC
      • Submit BVN
      • Submit NIN
      • Get KYC Status
  • Users Module
    • Get My Profile
      GET
    • Update My Profile
      PUT
    • Get My Vote History
      GET
  • Payments Module
    • Webhooks
      • Paystack Webhook
      • Flutterwave Webhook
      • Payout Webhook (Payouts)
    • Initiate Payment
      POST
    • Get Transaction Status
      GET
  • Admin Module
    • Dashboard
      • Get Platform Dashboard
    • Merchants
      • List Merchants
      • Get Merchant Detail
      • Ban Merchant
      • Approve Merchant
      • Suspend Merchant
    • Users
      • List Users
      • Get User Detail
      • Suspend User
      • Ban User
    • Contests
      • List Contests
      • Get Contest Detail
      • Cancel Contest
      • Approve Contest
    • Transactions
      • List Transactions
      • Get Transaction Detail
    • Audit Logs
      • List Audit Logs
    • Settings
      • Get Platform Settings
      • Update Platform Settings
    • RBAC
      • Roles
        • List Available Permissions
        • List Roles
        • Create Role
        • Get Role Detail
        • Update Role
        • Delete Role
      • Admins
        • List Admins
        • Create Admin
        • Get Admin Detail
        • Update Admin
        • Update Admin Status
        • Force Logout Admin
    • Admin Profile
      • Update 2FA Channel
    • Payouts
      • Create Payout Request (Admin)
      • List Payout Requests (Admin)
      • Get Payout Request (Admin)
      • Approve Payout Request
      • Process Payout Request
      • Cancel Payout Request
      • Get Merchant Payout Summary (Admin)
    • Terms of Service
      • Publish New ToS Version
      • List All ToS Versions (Admin)
      • List ToS Acceptances
      • Get Actor ToS History
    • Data Erasure
      • List Erasure Requests
      • Get Erasure Request Detail
      • Execute Erasure Request
    • Queue Management
      • Get Queue Status
      • List Failed (DLQ) Jobs
      • Retry Failed Job
      • Discard Failed Job
      • Retry All Failed Jobs
      • Discard All Failed Jobs
    • Webhook Deliveries
      • List Webhook Deliveries
      • Get Webhook Delivery Detail
      • Retry Webhook Delivery
      • Discard Webhook Delivery
    • Fraud Detection
      • Get Fraud Dashboard
      • List Fraud Flags
      • Get Fraud Flag Detail
      • Resolve Fraud Flag
    • KYC
      • List Merchant KYC Records
      • Get KYC Service Status
      • Switch KYC Provider
      • Get Merchant KYC Detail
      • Review Merchant KYC
    • Login Admin
      POST
    • Verify Admin 2FA (Step 2)
      POST
  • Uploads Module
    • Upload File
      POST
  • Public Access Module
    • Entries Module
      • List Contest Entries
      • Get Entry Detail
    • Votes Module
      • Cast Free Vote
    • Contests Module
      • List Public Contests
      • Get Contest Detail
    • Activity
      • Get Contest Activity
      • Stream Contest Activity (SSE)
  • Terms of Service Module
    • Get Current ToS
    • Get ToS History
    • Get ToS By Version
    • Accept Current ToS
  • Data Erasure Module
    • Submit Erasure Request
    • Confirm Erasure (Email Token)
    • Cancel Erasure (Email Token)
    • Get Export Status
    • Download Data Export
  • Monitoring Module
    • Get Prometheus Metrics
  • Health Check
    GET
  • API Root
    GET
  1. Uploads Module

Upload File

POST
https://stageapi.partake.ng/api/v2/uploads
Last modified:2026-07-10 13:15:30
Maintainer:Not configured
Uploads an image file and returns a fileId and public URL. Authenticated (any role); permitted contexts vary by actor role. Merchant/Admin.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params multipart/form-data

Responses

🟠403
application/json
Bodyapplication/json

🟠415
🟠413
🟢201
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://stageapi.partake.ng/api/v2/uploads' \
--header 'Authorization: Bearer <token>' \
--form 'file=@",zh6LjPKsx/signature2.png"' \
--form 'context="admin_profile_picture"'
Response Response Example
403 - 403 Forbidden — Context Not Allowed
{
  "success": false,
  "error": {
    "code": "UPLOAD_CONTEXT_NOT_ALLOWED",
    "message": "Your account type is not permitted to upload files for context 'admin_profile_picture'.",
    "details": {}
  },
  "statusCode": 403
}
Modified at 2026-07-10 13:15:30
Previous
Verify Admin 2FA (Step 2)
Next
List Contest Entries
Built with