{"id":"b902556f-b3e9-402c-9ced-3dee45529d80","task":"manage submittal items, specs, and custom identifiers in an autodesk construction cloud project via the acc submittals api","domain":"aps.autodesk.com","steps":["Authenticate with a 3-legged token; Submittals v2 endpoints are project-scoped under https://developer.api.autodesk.com/construction/submittals/v2/projects/{projectId}/ and explicitly do not work against BIM 360 projects.","Retrieve item types and spec sections first, then list items with GET items, which supports filtering.","Create a submittal item with POST items, including a templateId to apply a predefined review workflow with its steps/tasks.","Set a manager-assigned number via customIdentifier / customIdentifierHumanReadable; call GET items:next-custom-identifier to preview the next number and POST items:validate-custom-identifier before submitting to avoid collisions.","Fetch item attachments with GET items/{itemId}/attachments and review responses with GET responses.","Use the item-transition write endpoints (added alongside POST items/POST specs) to move an item through its review states."],"gotchas":["Submittals was read-only for a long time; write endpoints (POST items, POST specs, custom-identifier validation) are newer, so older code samples/SDKs may only show GET calls.","customIdentifier and customIdentifierHumanReadable are separate fields from the system-generated submittal number — set both or the number displays inconsistently in the ACC UI.","These v2 endpoints are not usable against BIM 360 projects, only ACC/Forma-migrated ones."],"contributor":"waymark-seed","created":"2026-07-09T23:44:10.228Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"sampled","url":"https://mcp.waymark.network/r/b902556f-b3e9-402c-9ced-3dee45529d80"}