1. Non-Tenant
AI Command Room
  • Authenticated
    • Projects
      • Get Projects for Tenant
      • Create Project
      • Update Project
      • Delete Project
      • Get Projects for Tenant
      • Create Project
      • Update Project
      • Delete Project
    • Tags
      • Get All Tags
      • Create Tag
      • Update Tag
      • Delete Tag
      • Get All Tags
      • Create Tag
      • Update Tag
      • Delete Tag
    • Tasks
      • Get All Tasks
      • Get Tasks Under DDDEEE column
      • Get My Automations Stats
      • Get All Tasks
      • Get Tasks Under DDDEEE column
      • Get My Automations Stats
    • Idea Capture
      • Transcribe Audio
      • Generate PRD
      • Generate Implementation Steps
      • Generate Build Steps
      • Create Task
      • Generate PRD PDF
      • Create Build Step
      • Create Implementation Step
      • Create Task
      • Generate PRD PDF
      • Create Build Step
      • Create Implementation Step
    • Organizations
      • Create Org Chart
      • Create Org Chart
    • Metrics
      • Get Business Value Impact Time Series
      • Get Business Value Impact Time Series
    • Automations
      • Get Automation Stats
      • Get Value Impact (Executions)
      • Get Automation Stats
      • Get Value Impact (Executions)
    • Client Collaboration
      • GET Access Requests (index)
      • POST Access Requests (store)
      • GET Incoming (incoming)
      • GET Own (own)
      • GET Item (show)
      • PUT Item (update)
      • PATCH Item (update)
      • DELETE Item (destroy)
      • POST Approve (approve)
      • POST Decline (decline)
      • POST Revoke (revoke)
      • GET Access Requests (index)
      • POST Access Requests (store)
      • GET Incoming (incoming)
      • GET Own (own)
      • GET Item (show)
      • PUT Item (update)
      • PATCH Item (update)
      • DELETE Item (destroy)
      • POST Approve (approve)
      • POST Decline (decline)
      • POST Revoke (revoke)
    • Non-Tenant
      • GET Auth (authenticate)
        GET
      • POST Auth (authenticate)
        POST
      • POST Logout (logout)
        POST
      • GET Notifications (index)
        GET
      • GET By Type (getByType)
        GET
      • POST Clear Read (clearRead)
        POST
      • POST Mark All Read (markAllAsRead)
        POST
      • GET Unread Count (unreadCount)
        GET
      • DELETE Item (destroy)
        DELETE
      • POST Mark Read (markAsRead)
        POST
      • GET Item (show)
        GET
      • PATCH Business Valuation Multiplier (updateBusinessValuationMultiplier)
        PATCH
      • GET Search (search)
        GET
      • GET Item (getByJobId)
        GET
      • PATCH Status (updateStatus)
        PATCH
      • POST Results (storeResult)
        POST
      • GET Public Automations (getPublicAutomations)
        GET
      • Get Multiplai User
        GET
      • GET Auth (authenticate)
        GET
      • POST Auth (authenticate)
        POST
      • POST Logout (logout)
        POST
      • GET Notifications (index)
        GET
      • GET By Type (getByType)
        GET
      • POST Clear Read (clearRead)
        POST
      • POST Mark All Read (markAllAsRead)
        POST
      • GET Unread Count (unreadCount)
        GET
      • DELETE Item (destroy)
        DELETE
      • POST Mark Read (markAsRead)
        POST
      • GET Item (show)
        GET
      • PATCH Business Valuation Multiplier (updateBusinessValuationMultiplier)
        PATCH
      • GET Search (search)
        GET
      • GET Item (getByJobId)
        GET
      • PATCH Status (updateStatus)
        PATCH
      • POST Results (storeResult)
        POST
      • GET Public Automations (getPublicAutomations)
        GET
      • Get Multiplai User
        GET
    • Tenant Scoped
      • GET Comments (index)
      • POST Comments (store)
      • GET Item (show)
      • PUT Item (update)
      • PATCH Item (update)
      • DELETE Item (destroy)
      • POST Reactions (addReaction)
      • POST Replies (storeReply)
      • Multiplai Dev - Departments
      • POST Resolve User Ids (resolveUserIds)
      • GET Users (teamUsers)
      • GET Tree (tree)
      • GET Paginated (treePaginated)
      • GET Item (show)
      • GET Teams (departmentTeams)
      • GET Files (index)
      • POST Files (store)
      • GET Item (show)
      • PUT Item (update)
      • PATCH Item (update)
      • DELETE Item (destroy)
      • GET Workflow Executions (getWorkflowExecutionsForMetrics)
      • POST Time Series (getWorkflowExecutionsTimeSeries)
      • POST Time Series (getWorkflowsTimeSeries)
      • GET Orgcharts (index)
      • GET Active (getActive)
      • GET Item (showShallow)
      • PUT Item (updateShallow)
      • DELETE Item (destroyShallow)
      • POST Parse File (parseUploadedFile)
      • GET Download (downloadTemplate)
      • POST Validate Csv (validateCsv)
      • PUT Positions (updatePositions)
      • GET Item (show)
      • PUT Item (update)
      • PATCH Item (update)
      • DELETE Item (destroy)
      • POST Archive (archive)
      • POST Deactivate (deactivate)
      • GET Nodes (index)
      • POST Nodes (store)
      • GET Item (show)
      • PUT Item (update)
      • PATCH Item (update)
      • DELETE Item (destroy)
      • GET Ai Automations (index)
      • POST Ai Automations (store)
      • POST From Suggestion (createFromSuggestion)
      • GET Grouped (grouped)
      • GET Savings (savings)
      • GET Item (show)
      • PUT Item (update)
      • PATCH Item (update)
      • DELETE Item (destroy)
      • POST Implemented (markImplemented)
      • POST Link Rea Agent (linkExistingReaAgent)
      • POST Sync To Rea (syncToRea)
      • GET Added (getAdded)
      • GET Suggestions (getSuggestions)
      • POST Sync (syncAgent)
      • GET Synced (getSynced)
      • DELETE Item (unsyncAgent)
      • PUT Forecast (updateForecast)
      • POST Set Active (setActive)
      • POST Unarchive (unarchive)
      • PUT Sort (updateSort)
      • GET Item (show)
      • Update Project
      • PATCH Item (update)
      • Delete Project
      • GET Task Groups (index)
      • PUT Reorder (reorder)
      • Get Tasks Under DDDEEE column
      • GET Research Reports (index)
      • POST Research Reports (store)
      • GET My Prospects (myProspects)
      • GET My Reports (myReports)
      • GET Pending (pending)
      • POST Register (register)
      • GET Stats (stats)
      • POST Generate Org Chart (generateOrgChart)
      • GET Item (show)
      • DELETE Item (destroy)
      • GET Roles (index)
      • POST Roles (store)
      • GET Permissions (permissions)
      • GET Templates (templates)
      • GET Item (show)
      • PUT Item (update)
      • PATCH Item (update)
      • DELETE Item (destroy)
      • POST Apply Template (applyTemplate)
      • POST Assign Users (assignUsers)
      • POST Clone (clone)
      • POST Remove Users (removeUsers)
      • GET Users (roleUsers)
      • GET Software (index)
      • POST Software (store)
      • GET Item (show)
      • PUT Item (update)
      • PATCH Item (update)
      • DELETE Item (destroy)
      • POST Reorder (reorder)
      • GET Item (show)
      • PUT Item (update)
      • PATCH Item (update)
      • DELETE Item (destroy)
      • GET Task Groups (index)
      • POST Task Groups (store)
      • GET Item (show)
      • PUT Item (update)
      • PATCH Item (update)
      • DELETE Item (destroy)
      • POST Tasks (addTasks)
      • DELETE Tasks (removeTasks)
      • GET Tasks (index)
      • GET Task Shares (index)
      • POST Task Shares (store)
      • POST Increment Usage (incrementUsage)
      • POST Share Publicly (sharePublicly)
      • POST Share With Organization (shareWithOrganization)
      • GET Shared Automations (getSharedAutomations)
      • POST Unshare (unshare)
      • GET Item (show)
      • PUT Item (update)
      • PATCH Item (update)
      • DELETE Item (destroy)
      • GET Stats (stats)
      • POST Automation Target Metrics (getAutomationTargetMetrics)
      • DELETE Bulk Delete (bulkDelete)
      • GET Item (showBySlug)
      • POST Copy Shared Automation (copySharedAutomation)
      • POST Mass Update (massUpdate)
      • GET My Automations (getMyAutomations)
      • GET My Automations Value Impact (getMyAutomationsValueImpact)
      • GET My Executions (getMyWorkflowExecutions)
      • GET Grouped (getMyWorkflowExecutionsGrouped)
      • GET Workflow Execution Count (getWorkflowExecutionCount)
      • GET Item (show)
      • PUT Item (update)
      • PATCH Item (update)
      • DELETE Item (destroy)
      • PUT Assignees (updateAssignees)
      • PUT Build Steps (bulkUpdate)
      • GET Build Steps (index)
      • Create Build Step
      • GET Item (show)
      • PUT Item (update)
      • PATCH Item (update)
      • DELETE Item (destroy)
      • GET Comments (index)
      • GET Files (index)
      • POST Rea (attachReaWorkflow)
      • PATCH Rea (refreshReaWorkflowStatus)
      • DELETE Rea (detachReaWorkflow)
      • PUT Remove Assignees (removeAllAssignees)
      • GET Steps (index)
      • POST Steps (store)
      • GET Item (show)
      • PUT Item (update)
      • PATCH Item (update)
      • DELETE Item (destroy)
      • PUT Tags (updateTags)
      • PUT Team (updateTeam)
      • POST Trigger_updated (triggerTaskUpdated)
      • POST Uploads (attachUpload)
      • DELETE Item (detachUpload)
      • Multiplai Dev - Teams
      • POST Teams (store)
      • GET Item (show)
      • PUT Item (update)
      • DELETE Item (destroy)
      • PATCH Move Down (moveDown)
      • PATCH Move Up (moveUp)
      • DELETE Remove Team Lead (removeTeamLead)
      • POST Set Team Lead (setTeamLead)
      • POST Uploads (store)
      • POST Signed Url (getSignedUrl)
      • PUT Item (update)
      • DELETE Item (destroy)
      • GET Download Url (getDownloadUrl)
      • GET Preview (preview)
      • GET Users (organizationUsers)
      • POST Invite (inviteMember)
      • GET Item (show)
      • PUT Item (update)
      • POST Activate (activate)
      • POST Avatar (updateAvatar)
      • DELETE Avatar (removeAvatar)
      • DELETE Remove (removeFromOrganization)
      • POST Suspend (suspend)
      • GET Comments (index)
      • POST Comments (store)
      • GET Item (show)
      • PUT Item (update)
      • PATCH Item (update)
      • DELETE Item (destroy)
      • POST Reactions (addReaction)
      • POST Replies (storeReply)
      • Multiplai Dev - Departments
      • POST Resolve User Ids (resolveUserIds)
      • GET Users (teamUsers)
      • GET Tree (tree)
      • GET Paginated (treePaginated)
      • GET Item (show)
      • GET Teams (departmentTeams)
      • GET Files (index)
      • POST Files (store)
      • GET Item (show)
      • PUT Item (update)
      • PATCH Item (update)
      • DELETE Item (destroy)
      • GET Workflow Executions (getWorkflowExecutionsForMetrics)
      • POST Time Series (getWorkflowExecutionsTimeSeries)
      • POST Time Series (getWorkflowsTimeSeries)
      • GET Orgcharts (index)
      • GET Active (getActive)
      • GET Item (showShallow)
      • PUT Item (updateShallow)
      • DELETE Item (destroyShallow)
      • POST Parse File (parseUploadedFile)
      • GET Download (downloadTemplate)
      • POST Validate Csv (validateCsv)
      • PUT Positions (updatePositions)
      • GET Item (show)
      • PUT Item (update)
      • PATCH Item (update)
      • DELETE Item (destroy)
      • POST Archive (archive)
      • POST Deactivate (deactivate)
      • GET Nodes (index)
      • POST Nodes (store)
      • GET Item (show)
      • PUT Item (update)
      • PATCH Item (update)
      • DELETE Item (destroy)
      • GET Ai Automations (index)
      • POST Ai Automations (store)
      • POST From Suggestion (createFromSuggestion)
      • GET Grouped (grouped)
      • GET Savings (savings)
      • GET Item (show)
      • PUT Item (update)
      • PATCH Item (update)
      • DELETE Item (destroy)
      • POST Implemented (markImplemented)
      • POST Link Rea Agent (linkExistingReaAgent)
      • POST Sync To Rea (syncToRea)
      • GET Added (getAdded)
      • GET Suggestions (getSuggestions)
      • POST Sync (syncAgent)
      • GET Synced (getSynced)
      • DELETE Item (unsyncAgent)
      • PUT Forecast (updateForecast)
      • POST Set Active (setActive)
      • POST Unarchive (unarchive)
      • PUT Sort (updateSort)
      • GET Item (show)
      • Update Project
      • PATCH Item (update)
      • Delete Project
      • GET Task Groups (index)
      • PUT Reorder (reorder)
      • Get Tasks Under DDDEEE column
      • GET Research Reports (index)
      • POST Research Reports (store)
      • GET My Prospects (myProspects)
      • GET My Reports (myReports)
      • GET Pending (pending)
      • POST Register (register)
      • GET Stats (stats)
      • POST Generate Org Chart (generateOrgChart)
      • GET Item (show)
      • DELETE Item (destroy)
      • GET Roles (index)
      • POST Roles (store)
      • GET Permissions (permissions)
      • GET Templates (templates)
      • GET Item (show)
      • PUT Item (update)
      • PATCH Item (update)
      • DELETE Item (destroy)
      • POST Apply Template (applyTemplate)
      • POST Assign Users (assignUsers)
      • POST Clone (clone)
      • POST Remove Users (removeUsers)
      • GET Users (roleUsers)
      • GET Software (index)
      • POST Software (store)
      • GET Item (show)
      • PUT Item (update)
      • PATCH Item (update)
      • DELETE Item (destroy)
      • POST Reorder (reorder)
      • GET Item (show)
      • PUT Item (update)
      • PATCH Item (update)
      • DELETE Item (destroy)
      • GET Task Groups (index)
      • POST Task Groups (store)
      • GET Item (show)
      • PUT Item (update)
      • PATCH Item (update)
      • DELETE Item (destroy)
      • POST Tasks (addTasks)
      • DELETE Tasks (removeTasks)
      • GET Tasks (index)
      • GET Task Shares (index)
      • POST Task Shares (store)
      • POST Increment Usage (incrementUsage)
      • POST Share Publicly (sharePublicly)
      • POST Share With Organization (shareWithOrganization)
      • GET Shared Automations (getSharedAutomations)
      • POST Unshare (unshare)
      • GET Item (show)
      • PUT Item (update)
      • PATCH Item (update)
      • DELETE Item (destroy)
      • GET Stats (stats)
      • POST Automation Target Metrics (getAutomationTargetMetrics)
      • DELETE Bulk Delete (bulkDelete)
      • GET Item (showBySlug)
      • POST Copy Shared Automation (copySharedAutomation)
      • POST Mass Update (massUpdate)
      • GET My Automations (getMyAutomations)
      • GET My Automations Value Impact (getMyAutomationsValueImpact)
      • GET My Executions (getMyWorkflowExecutions)
      • GET Grouped (getMyWorkflowExecutionsGrouped)
      • GET Workflow Execution Count (getWorkflowExecutionCount)
      • GET Item (show)
      • PUT Item (update)
      • PATCH Item (update)
      • DELETE Item (destroy)
      • PUT Assignees (updateAssignees)
      • PUT Build Steps (bulkUpdate)
      • GET Build Steps (index)
      • Create Build Step
      • GET Item (show)
      • PUT Item (update)
      • PATCH Item (update)
      • DELETE Item (destroy)
      • GET Comments (index)
      • GET Files (index)
      • POST Rea (attachReaWorkflow)
      • PATCH Rea (refreshReaWorkflowStatus)
      • DELETE Rea (detachReaWorkflow)
      • PUT Remove Assignees (removeAllAssignees)
      • GET Steps (index)
      • POST Steps (store)
      • GET Item (show)
      • PUT Item (update)
      • PATCH Item (update)
      • DELETE Item (destroy)
      • PUT Tags (updateTags)
      • PUT Team (updateTeam)
      • POST Trigger_updated (triggerTaskUpdated)
      • POST Uploads (attachUpload)
      • DELETE Item (detachUpload)
      • Multiplai Dev - Teams
      • POST Teams (store)
      • GET Item (show)
      • PUT Item (update)
      • DELETE Item (destroy)
      • PATCH Move Down (moveDown)
      • PATCH Move Up (moveUp)
      • DELETE Remove Team Lead (removeTeamLead)
      • POST Set Team Lead (setTeamLead)
      • POST Uploads (store)
      • POST Signed Url (getSignedUrl)
      • PUT Item (update)
      • DELETE Item (destroy)
      • GET Download Url (getDownloadUrl)
      • GET Preview (preview)
      • GET Users (organizationUsers)
      • POST Invite (inviteMember)
      • GET Item (show)
      • PUT Item (update)
      • POST Activate (activate)
      • POST Avatar (updateAvatar)
      • DELETE Avatar (removeAvatar)
      • DELETE Remove (removeFromOrganization)
      • POST Suspend (suspend)
    • Global Admin
      • GET Organizations (organizations)
      • GET Statistics (statistics)
      • GET Users (index)
      • POST Bulk Assign Organization Admin (bulkAssignOrganizationAdmin)
      • POST Bulk Update (bulkUpdatePermissions)
      • POST Assign Organization Admin (assignOrganizationAdmin)
      • POST Grant Collaboration (grantClientCollaborationAccess)
      • GET Organization Roles (getUserOrganizationRoles)
      • PUT Permissions (updatePermissions)
      • POST Remove Organization Admin (removeOrganizationAdmin)
      • POST Revoke Collaboration (revokeClientCollaborationAccess)
      • GET Organizations (organizations)
      • GET Statistics (statistics)
      • GET Users (index)
      • POST Bulk Assign Organization Admin (bulkAssignOrganizationAdmin)
      • POST Bulk Update (bulkUpdatePermissions)
      • POST Assign Organization Admin (assignOrganizationAdmin)
      • POST Grant Collaboration (grantClientCollaborationAccess)
      • GET Organization Roles (getUserOrganizationRoles)
      • PUT Permissions (updatePermissions)
      • POST Remove Organization Admin (removeOrganizationAdmin)
      • POST Revoke Collaboration (revokeClientCollaborationAccess)
    • REA
      • GET Agents (agents)
      • POST By Department (agentsByDepartment)
      • POST By Department Detail (agentsByDepartmentDetail)
      • GET Leaderboard (leaderboard)
      • POST Metrics (agentMetrics)
      • GET Item (availableWorkflows)
      • GET Ping (ping)
      • POST Metrics (threadMetrics)
      • GET Workflow Executions (workflowExecutions)
      • GET Workflows (workflows)
      • POST By Department (workflowsByDepartment)
      • POST By Department Detail (workflowsByDepartmentDetail)
      • POST Execution Status Count (workflowExecutionStatusCount)
      • POST Metrics (workflowMetrics)
      • GET Executions (getReaWorkflowExecutions)
      • GET Refresh (refreshWorkflowExecution)
      • GET Agents (agents)
      • POST By Department (agentsByDepartment)
      • POST By Department Detail (agentsByDepartmentDetail)
      • GET Leaderboard (leaderboard)
      • POST Metrics (agentMetrics)
      • GET Item (availableWorkflows)
      • GET Ping (ping)
      • POST Metrics (threadMetrics)
      • GET Workflow Executions (workflowExecutions)
      • GET Workflows (workflows)
      • POST By Department (workflowsByDepartment)
      • POST By Department Detail (workflowsByDepartmentDetail)
      • POST Execution Status Count (workflowExecutionStatusCount)
      • POST Metrics (workflowMetrics)
      • GET Executions (getReaWorkflowExecutions)
      • GET Refresh (refreshWorkflowExecution)
    • Get Multiplai User
      GET
    • Fetch Organizations
      GET
    • Get Global Permissions
      GET
    • Get Permissions for Tenant
      GET
    • Fetch Organizations
      GET
    • Get Global Permissions
      GET
    • Get Permissions for Tenant
      GET
  • Public
    • Public
      • GET Item (getSharedTaskBuildSteps)
      • GET Item (getSharedTaskBySlug)
      • GET Item (getSharedTaskComments)
      • GET Item (getSharedTaskSteps)
      • GET Item (getSharedTask)
      • GET Version (show)
      • POST Create (handleCreate)
      • POST Update (handleUpdate)
      • POST Attach (handleUserAttach)
      • POST Detach (handleUserDetach)
      • POST Update (handleUserUpdate)
      • POST Update (handleUserUpdate)
      • GET Item (getSharedTaskBuildSteps)
      • GET Item (getSharedTaskBySlug)
      • GET Item (getSharedTaskComments)
      • GET Item (getSharedTaskSteps)
      • GET Item (getSharedTask)
      • GET Version (show)
      • POST Create (handleCreate)
      • POST Update (handleUpdate)
      • POST Attach (handleUserAttach)
      • POST Detach (handleUserDetach)
      • POST Update (handleUserUpdate)
      • POST Update (handleUserUpdate)
  • Internal API Key
    • Internal
      • POST Generate Org Chart (generateOrgChart)
      • POST Results (storeResults)
      • GET Search (search)
      • POST Generate Org Chart (generateOrgChart)
      • POST Results (storeResults)
      • GET Search (search)
  • Multiplai Dev - Organizations
    GET
  • Multiplai Dev - Departments
    GET
  • Multiplai Dev - Organization Departments
    GET
  • Multiplai Dev - Departments Teams
    GET
  • Multiplai Dev - Organization Departments
    PUT
  • Multiplai Dev - Organization Departments Bulk
    POST
  • Multiplai Dev - Teams
    GET
  • Multiplai Dev - Organizations
    GET
  • Multiplai Dev - Departments
    GET
  • Multiplai Dev - Organization Departments
    GET
  • Multiplai Dev - Departments Teams
    GET
  • Multiplai Dev - Organization Departments
    PUT
  • Multiplai Dev - Organization Departments Bulk
    POST
  • Multiplai Dev - Teams
    GET
  1. Non-Tenant

PATCH Status (updateStatus)

Developing
PATCH
/api/research-webhooks/jobs/{jobId}/status
Update the status of a research job by job ID. Called by the chat service to signal progress (pending → processing → completed/failed). When status is 'completed', the report text and structured data can be included. When 'failed', an error message can be included.
Auth: auth:api (bearer token, forwarded by chat service).

Request

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success
application/json
Bodyapplication/json

🟠401Unauthorized
🟠403Forbidden
🟠404Not Found
🟠422Unprocessable Entity
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PATCH 'https://api-dev.commandroom.ai/api/api/research-webhooks/jobs/research_abc123/status' \
--header 'Authorization: Bearer {{token}}' \
--header 'Content-Type: application/json' \
--data '{
  "status": "pending",
  "report": "string",
  "structured_data": {},
  "error_message": "Success.",
  "duration_ms": 1,
  "openai_response_id": 1
}'
Response Response Example
200 - OK
{
  "success": true,
  "message": "Success.",
  "data": {
    "id": 1,
    "uuid": "00000000-0000-0000-0000-000000000000",
    "status": "pending"
  }
}
Modified at 2026-07-02 04:47:16
Previous
GET Item (getByJobId)
Next
POST Results (storeResult)
Built with