Patch Setup

PATCH /api/v1/onboarding/setup

cURL

cURL

curl -sS -X PATCH "$FLUIDE_BASE_URL/api/v1/onboarding/setup" \
  -H "Authorization: Bearer $FLUIDE_ACCESS_TOKEN" \
  -H "X-Fluide-Api-Key: $FLUIDE_API_KEY" \
  -H "X-Fluide-Client-Id: fluide-developer" \
  -H "Content-Type: application/json" \
  -d '{}'

const baseUrl = process.env.FLUIDE_BASE_URL;

const response = await fetch(`${baseUrl}/api/v1/onboarding/setup`, {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.FLUIDE_ACCESS_TOKEN}`,
    'X-Fluide-Api-Key': process.env.FLUIDE_API_KEY,
    'X-Fluide-Client-Id': 'fluide-developer',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
});

if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
console.log(await response.json());

import os
import requests

base_url = os.environ["FLUIDE_BASE_URL"]
headers = {
        "Authorization": f"Bearer {os.environ['FLUIDE_ACCESS_TOKEN']}",
        "X-Fluide-Api-Key": os.environ["FLUIDE_API_KEY"],
        "X-Fluide-Client-Id": "fluide-developer",
}

response = requests.patch(
    f"{base_url}/api/v1/onboarding/setup",
    headers=headers,
    json={},
    timeout=30,
)
response.raise_for_status()
print(response.json())

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

String baseUrl = System.getenv("FLUIDE_BASE_URL");
HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create(baseUrl + "/api/v1/onboarding/setup"))
    .header("Authorization", "Bearer " + System.getenv("FLUIDE_ACCESS_TOKEN"))
    .header("X-Fluide-Api-Key", System.getenv("FLUIDE_API_KEY"))
    .header("X-Fluide-Client-Id", "fluide-developer")
    .header("Content-Type", "application/json")
    .PATCH(HttpRequest.BodyPublishers.ofString("{}"))
    .build();
HttpResponse<String> response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());
if (response.statusCode() >= 400) throw new RuntimeException("HTTP " + response.statusCode() + ": " + response.body());
System.out.println(response.body());

<?php
$baseUrl = getenv("FLUIDE_BASE_URL");
$ch = curl_init($baseUrl . "/api/v1/onboarding/setup");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'PATCH',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('FLUIDE_ACCESS_TOKEN'),
        'X-Fluide-Api-Key: ' . getenv('FLUIDE_API_KEY'),
        'X-Fluide-Client-Id: fluide-developer',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => "{}",
]);
$response = curl_exec($ch);
if ($response === false) throw new RuntimeException(curl_error($ch));
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($status >= 400) throw new RuntimeException("HTTP $status: $response");
echo $response;

200

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {}
}

{
  "success": false,
  "message": "Validation failed",
  "code": "VALIDATION_FAILED",
  "statusCode": 400,
  "timestamp": "2026-06-03T12:00:00.000Z",
  "errors": {
    "from": [
      "from must be a valid date"
    ]
  }
}

{
  "success": false,
  "message": "Validation failed",
  "code": "VALIDATION_FAILED",
  "statusCode": 400,
  "timestamp": "2026-06-03T12:00:00.000Z",
  "errors": {
    "from": [
      "from must be a valid date"
    ]
  }
}

{
  "success": false,
  "message": "Validation failed",
  "code": "VALIDATION_FAILED",
  "statusCode": 400,
  "timestamp": "2026-06-03T12:00:00.000Z",
  "errors": {
    "from": [
      "from must be a valid date"
    ]
  }
}

{
  "success": false,
  "message": "Validation failed",
  "code": "VALIDATION_FAILED",
  "statusCode": 400,
  "timestamp": "2026-06-03T12:00:00.000Z",
  "errors": {
    "from": [
      "from must be a valid date"
    ]
  }
}

Authorizations

Authorization · string · header · required

Access token JWT. Use as Authorization: Bearer . In the API playground, paste the JWT only.

X-Fluide-Api-Key · string · header · default: fl_dev_your_key · required

Developer API key (fl_dev_...). Required on every API call with a machine access token.

X-Fluide-Client-Id · string · header · default: fluide-developer · required

First-party client audience. Must match the fluide_client_id claim on the JWT. Use fluide-developer for Connect.

Body

application/json

onboardingPersona · enum<string>

Available options: business_owner, partner, service_partner, virtual_manager, compliance_expert, eso, capital_allocator

businessType · enum<string>

Available options: SME, STARTUP, NGO, MFI, CORPORATE, COOPERATIVE

partner · object

Show child attributes

eso · object

Show child attributes

capitalAllocator · object

Show child attributes

firmVerification · object

Show child attributes

businessRegistration · object

Show child attributes

partnerCompliance · object

Show child attributes

legal · object

Show child attributes

regionWorkspace · object

Show child attributes

billing · object

Show child attributes

invites · object

Show child attributes

personalInfo · object

Show child attributes

organizationStructure · object

Organization-wide department names and role labels (merged into setupData).

Show child attributes

wizardStepCursor · number

Optional UI cursor for resume across wizard steps.

Required range: 0 <= x <= 15

employmentOnboardingMode · enum<string>

HR_FIRST: create HR employee then optional invite. INVITE_FIRST: store HR draft then invite; HR row created when user accepts.

Available options: HR_FIRST, INVITE_FIRST

ecosystemPath · enum<string>

Available options: run_organization, raise_capital, deploy_capital, support_organizations, build_solutions, grow_partnership

operationalPriorities · string[]

currentTools · string[]

readinessScore · object

Show child attributes

partnershipApplication · object

developerProfile · object

profileSetup · object

productIntent · object

Show child attributes

activatedProducts · enum<string>[]

Hub product tiles enabled for this org. Overrides ecosystem path defaults when set.

Available options: fluide-pay, fluide-admin, fluide-capital-admin, fluide-developer

checkoutWorkflow · object

Show child attributes

Response

200

application/json

Patch Setup

success · boolean · required

Whether the request succeeded

Example:

true

message · string · required

Human-readable outcome message (localized when i18n is configured)

Example:

"Operation completed successfully"

data · object

Endpoint-specific payload