List Drawing Revisions
list_drawing_revisionsRead-onlyIdempotent
Retrieve a paginated list of drawing revisions for a project. Filter by drawing ID, area, discipline, set, or revision status to find specific revisions.
Instructions
Returns a list of all Drawing Revisions in the specified Project. Use this to enumerate Drawings when you need a paginated overview, to find IDs, or to filter by query parameters. Returns a paginated JSON array of Drawings. Use page and per_page to control pagination; the response includes pagination metadata. Required parameters: project_id. Procore API: Project Management > Drawings. Endpoint: GET /rest/v1.0/projects/{project_id}/drawing_revisions
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | URL path parameter — unique identifier for the project. | |
| page | No | Query string parameter — page number for paginated results (default: 1) | |
| per_page | No | Query string parameter — number of items per page (default: 100, max: 100) | |
| drawing_area_id | No | Query string parameter — filter by Drawing Area | |
| drawing_id | No | Query string parameter — unique identifier of the drawing | |
| drawing_discipline_id | No | Query string parameter — filter by Drawing Discipline | |
| drawing_set_id | No | Query string parameter — filter by Drawing Set. To retreive revisions from current set add `drawing_set_id=current_set` to query | |
| id | No | Query string parameter — filter by Drawing Revision ID To request specific drawing revision ids add `id[]=42&id[]=43` to query | |
| filters__ids | No | Query string parameter — filter by Drawing Revisions ID To request specific drawing revision ids add `filters[ids]=[1,2,3]` to filters | |
| filters__updated_at | No | Query string parameter — return item(s) 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 `YYYY-MM-... | |
| filters__deleted | No | Query string parameter — include deleted drawing revisions. Deleted drawing revisions are filtered by default. | |
| is_reviewed | No | Query string parameter — filter by `reviewed` status | |
| query | No | Query string parameter — filter by custom query | |
| with_obsolete | No | Query string parameter — include obsolete drawing revisions. Obsolete drawing revisions are filtered by default. | |
| sort | No | Query string parameter — sort order for results. Prefix with '-' for descending order | |
| view | No | Query string parameter — defines the type of view returned. Must be one of 'only_pdf_urls', 'only_ids', 'only_ids_post_review', 'web_index', 'web_show', 'extended_coordinates', 'extended_files', 'extended_dpi' or 'android'. |