Risk Flags help general contractors annotate and monitor issues related to subcontractor qualifications, safety, and performance. The flags are only visible to users within your company and vendors do not have the ability to see them. The subcontractor cannot create flags. This is a general contractor only workflow. This product help tells in more details:
We are happy to announce: a few new endpoints are released with TradeTapp v2 API:
- GET /flags: Retrieve a list of flags for subcontractor companies.
- GET /flags/:flagId: Retrieve a specific flag for a subcontractor company.
- POST /flags: Create a flag for a subcontractor company.
- PATCH flags/:flagId: Update an existing flag.
- DELETE flags/:flagId: Delete a flag.
- GET flags/:flagId/state-history: Retrieve the state history of a flag.
There is an interesting attribute with flag: isVisibleInPlatform. It controls the visibility with the two types of valid users below. When isVisibleInPlatform= true, both Tradetapp Users and BuildingConnected Users can view this flag. If false, only TradeTapp Users can view this flag.
- TradeTapp Users: Users who have a TradeTapp account
- BuildingConnected (BC) Users: Users who do NOT have a TradeTapp account, but have a BC account that is linked to a BC company that has TradeTapp.
The flag has an attribute named taxId. It is same to federalTaxId with financials APIs.
For long-running flags, it may go from active to resolved back to active often, so the API state-history is exposed to manage the states list.
Documentations
Code Samples on GitHub
If you have any questions or feedback, please don't hesitate to contact us through our APS support channel.