List Of Deleted Submittals
list_of_deleted_submittalsLists deleted submittals in a Procore project to help you locate removed records and retrieve their IDs for recovery or audit.
Instructions
The Submittals endpoint returns all deleted Submittals in a project. Use this to discover deleted submittals or to look up the id of one before calling a tool that needs it. project_id defaults to the value set by procore_set_config when omitted. Returns a JSON array of deleted submittals; page and per_page control pagination and the response reports how many pages remain. Read-only — it changes nothing in Procore. 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: project_id. Procore API (v1.1): Project Management > Submittals. Endpoint: GET /rest/v1.1/projects/{project_id}/submittals/recycle_bin
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Query string parameter — page number for paginated results (default: 1) | |
| sort | No | Query string parameter — sort order for results. Prefix with '-' for descending order | |
| per_page | No | Query string parameter — number of items per page (default: 100, max: 100) | |
| project_id | Yes | URL path parameter — unique identifier for the project. | |
| filters__id | No | Query string parameter — return item(s) with the specified IDs. | |
| filters__type | No | Query string parameter — array of Submittal Types. A single Submittal Type is also accepted. | |
| filters__query | No | Query string parameter — return item(s) containing search query | |
| filters__division | No | Query string parameter — array of Divisions to filter on. A Division is the first two digits from the Specification Section Number. A single Division is also accepted. | |
| filters__status_id | No | Query string parameter — array of Status IDs. A single Status ID is also accepted. | |
| filters__created_at | No | Query string parameter — return item(s) created within the specified ISO 8601 datetime range. Formats: `YYYY-MM-DD`...`YYYY-MM-DD` - Date `YYYY-MM-DDTHH:MM:SSZ`...`YYYY-MM-DDTHH:MM:SSZ` - DateTime with UTC Offset `YYYY-MM-... | |
| filters__updated_at | No | Query string parameter — return item(s) last updated within the specified ISO 8601 datetime range. Formats: `YYYY-MM-DD`...`YYYY-MM-DD` - Date `YYYY-MM-DDTHH:MM:SSZ`...`YYYY-MM-DDTHH:MM:SSZ` - DateTime with UTC Offset `YYY... | |
| filters__approver_id | No | Query string parameter — array of User IDs. Return item(s) where the specified User IDs are in the approver list. A single integer is also accepted. | |
| filters__location_id | No | Query string parameter — array of Location IDs. A single Location ID is also accepted. | |
| filters__response_id | No | Query string parameter — array of Response IDs. A single Response ID is also accepted. | |
| filters__ball_in_court_id | No | Query string parameter — user ID. Return item(s) where the specified User ID is the Ball in Court. | |
| filters__current_revision | No | Query string parameter — default false. If true, only current revisions are shown. If false, all submittals are shown, regardless of whether or not it is the current revision. | |
| filters__received_from_id | No | Query string parameter — filter results by received from id | |
| filters__submittal_manager_id | No | Query string parameter — array of Submittal Manager IDs. A single Submittal Manager ID is also accepted. | |
| filters__submittal_package_id | No | Query string parameter — array of Submittal Package IDs. Returns item(s) associated with the specified Submittal Package IDs. A single integer value is also accepted. | |
| filters__specification_section_id | No | Query string parameter — array of Specification Section IDs. A single Specification Section ID is also accepted. | |
| filters__responsible_contractor_id | No | Query string parameter — array of Responsible Contractor IDs. A single Responsible Contractor ID is also accepted. |