Create Workflow Activity History
create_workflow_activity_historyLog a workflow activity to transition a workflow instance, creating a history record that tracks performed actions.
Instructions
Perform a workflow activity. Workflows Instances transition between states when all required activities have been performed. Pass the record's fields as top-level arguments — they are nested under "workflow_activity_history" in the request payload for you. Creates the workflow activity history and returns it with its new id (HTTP 201); calling it again creates another record. Failures come back as an error payload carrying the HTTP status — commonly 401 when the token has expired, 403 without tool permission, and 404 when an id does not resolve. Required parameters: workflow_instance_id, company_id, workflow_activity_id, workflow_user_role_id, performed_by_id. Procore API: Core > Workflows. Endpoint: POST /rest/v1.0/workflow_activity_histories
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| comments | No | JSON request body field — the comments for this Workflows operation | |
| company_id | Yes | Query string parameter — unique identifier for the company. | |
| attachments | No | JSON request body field — attachments. To upload attachments you must upload the entire payload as `multipart/form-data` content-type and specify each parameter as form-data together with `attachments[]` as files. | |
| performed_by_id | Yes | JSON request body field — login Information ID of a Workflow User Role Login Information. | |
| workflow_activity_id | Yes | JSON request body field — workflow Activity ID | |
| workflow_instance_id | Yes | Query string parameter — workflow Instance ID | |
| workflow_user_role_id | Yes | JSON request body field — workflow User Role ID |