Skip to content
Invogi Docs

Upsert the authenticated workspace's evaluation path and meaningful stage

PUT
/evaluations/current
curl --request PUT \
  --url https://api.invogi.com/v1/evaluations/current \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "mode": "SELF_SERVE", "source": "XERO", "currentStage": "SOURCE", "assistanceRequested": true, "completed": true, "resetStage": true }'

The server supplies organization and user identity. This route accepts no AP rows, supplier details, amounts, bank data, or finding evidence. Identical updates are idempotent.

Authorizations

Section titled “Authorizations”

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
mode
required
string
Allowed values: SELF_SERVE FOUNDER_ASSISTED
source
string | null
Allowed values: XERO QUICKBOOKS_ONLINE BUSINESS_CENTRAL ODOO GENERIC_FILE
currentStage
required
string
Allowed values: SOURCE EXPORT MAP VALIDATE RUN RESULTS NEXT_STEP
assistanceRequested
boolean
completed

Required and true at NEXT_STEP; completion is terminal for this first-check journey

boolean
resetStage

Explicitly return to SOURCE

boolean

Responses

Section titled “Responses”

200

Section titled “200”

Current journey

Media typeapplication/json
object
organizationId
required
string format: uuid
mode
required
string
Allowed values: SELF_SERVE FOUNDER_ASSISTED
source
required
string | null
Allowed values: XERO QUICKBOOKS_ONLINE BUSINESS_CENTRAL ODOO GENERIC_FILE
currentStage
required
string
Allowed values: SOURCE EXPORT MAP VALIDATE RUN RESULTS NEXT_STEP
startedAt
required
string format: date-time
lastActivityAt
required
string format: date-time
assistanceRequestedAt
required
string | null format: date-time
completedAt
required
string | null format: date-time

Example 

{
  "mode": "SELF_SERVE",
  "source": "XERO",
  "currentStage": "SOURCE"
}

400

Section titled “400”

Invalid request

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: NOT_FOUND UNAUTHORIZED FORBIDDEN INVALID_REQUEST CONFLICT RATE_LIMITED USAGE_LIMIT_EXCEEDED PROCESSING_FAILED
message
required
string
request_id
required
string

Example 

{
  "error": {
    "code": "NOT_FOUND"
  }
}

401

Section titled “401”

Missing or invalid API key

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: NOT_FOUND UNAUTHORIZED FORBIDDEN INVALID_REQUEST CONFLICT RATE_LIMITED USAGE_LIMIT_EXCEEDED PROCESSING_FAILED
message
required
string
request_id
required
string

Example 

{
  "error": {
    "code": "NOT_FOUND"
  }
}

403

Section titled “403”

API key lacks required scope/role

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: NOT_FOUND UNAUTHORIZED FORBIDDEN INVALID_REQUEST CONFLICT RATE_LIMITED USAGE_LIMIT_EXCEEDED PROCESSING_FAILED
message
required
string
request_id
required
string

Example 

{
  "error": {
    "code": "NOT_FOUND"
  }
}