{
"error": "invalid_token",
"error_description": "The access token provided is expired, revoked, malformed, or invalid for other reasons"
}
{
"error": "insufficient_scope",
"error_description": "The request requires higher privileges than provided by the access token",
"required_scope": "bid_evaluations:write",
"provided_scopes": [
"welcome:read"
]
}
{
"error": "validation_failed",
"errors": [
"score must be a whole number between 0 and 10 (got \"eight\")"
],
"available_criteria": [
{
"id": 11,
"description": "Technical Approach"
}
]
}
Bids
Score a proposal against the project's quality criteria (create or update an evaluation)
Records reviewer scores out of 10, each with justification notes, against the project’s evaluation criteria — mirroring the web UI’s evaluation form. Send several criteria in one call via scores, or a single criterion at the top level. Re-scoring a criterion overwrites the previous score and notes, so the same call creates or updates an evaluation. Identify each criterion by criterion_id (from GET /projects//evaluations) or by its exact criterion name. Notes are required. The whole batch is applied together, and the project’s proposal scores are recalculated afterwards, exactly as the UI does.
POST
/
bids
/
{id}
/
scores
Score a proposal against the project's quality criteria (create or update an evaluation)
{
"error": "invalid_token",
"error_description": "The access token provided is expired, revoked, malformed, or invalid for other reasons"
}
{
"error": "insufficient_scope",
"error_description": "The request requires higher privileges than provided by the access token",
"required_scope": "bid_evaluations:write",
"provided_scopes": [
"welcome:read"
]
}
{
"error": "validation_failed",
"errors": [
"score must be a whole number between 0 and 10 (got \"eight\")"
],
"available_criteria": [
{
"id": 11,
"description": "Technical Approach"
}
]
}
Scores recorded; the proposal's recalculated scorecard is returned
The response is of type object.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Zivio API Documentation","colors":{"primary":"#8FC640","light":"#07C983","dark":"#0D9373"},"logo":{"light":"https://mintcdn.com/zivio/TS2e-J71a1N5Byq4/logo/light.png?fit=max\u0026auto=format\u0026n=TS2e-J71a1N5Byq4\u0026q=85\u0026s=bb658cb8a0c9eb4edf53d8ceef401821","dark":"https://mintcdn.com/zivio/TS2e-J71a1N5Byq4/logo/dark.png?fit=max\u0026auto=format\u0026n=TS2e-J71a1N5Byq4\u0026q=85\u0026s=d96b1cfce8875828a11bf6b7a8b144b8"},"favicon":"https://mintcdn.com/zivio/TS2e-J71a1N5Byq4/favicon.png?fit=max\u0026auto=format\u0026n=TS2e-J71a1N5Byq4\u0026q=85\u0026s=7a9d9da4a098084333a2e9cbbf6e1419","navbar":{"links":[{"href":"mailto:support@zivio.com","label":"Support"}]},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode","download-spec"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"zivio","hasAudioNarration":false,"actualSubdomain":"zivio","customDomains":["docs.zivio.com"],"gitSource":{"type":"github","owner":"talonfms","repo":"zivio-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aa46641450b9c7ca6829f18","collectionId":"7d17fb72-9de0-42a3-bd86-cf9b2ead81de","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aa46641450b9c7ca6829f18"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aa4693a5ea5c3f12d991052","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"API Reference","count":191},{"language":"default","tag":"Endpoints","count":72},{"language":"default","tag":"Projects","count":32},{"language":"default","tag":"Documentation","count":17},{"language":"default","tag":"Bids","count":16},{"language":"default","tag":"Suppliers","count":15},{"language":"default","tag":"Invoices","count":13},{"language":"default","tag":"Orgs","count":11},{"language":"default","tag":"Milestones","count":9},{"language":"default","tag":"Purchase Orders","count":8}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/v4/bids/score-a-proposal-against-the-projects-quality-criteria-create-or-update-an-evaluation","slug":"/api-reference/v4/bids/score-a-proposal-against-the-projects-quality-criteria-create-or-update-an-evaluation","pageMetadata":{"title":"Score a proposal against the project's quality criteria (create or update an evaluation)","description":"Records reviewer scores out of 10, each with justification notes, against the project's evaluation criteria — mirroring the web UI's evaluation form. Send several criteria in one call via `scores`, or a single criterion at the top level. Re-scoring a criterion overwrites the previous score and notes, so the same call creates or updates an evaluation. Identify each criterion by `criterion_id` (from GET /projects/{id}/evaluations) or by its exact `criterion` name. Notes are required. The whole batch is applied together, and the project's proposal scores are recalculated afterwards, exactly as the UI does.","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json post /bids/{id}/scores","href":"/api-reference/v4/bids/score-a-proposal-against-the-projects-quality-criteria-create-or-update-an-evaluation","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Records reviewer scores out of 10, each with justification notes, against the project’s evaluation criteria — mirroring the web UI’s evaluation form. Send several criteria in one call via \", _jsx(_components.code, {\n children: \"scores\"\n }), \", or a single criterion at the top level. Re-scoring a criterion overwrites the previous score and notes, so the same call creates or updates an evaluation. Identify each criterion by \", _jsx(_components.code, {\n children: \"criterion_id\"\n }), \" (from GET /projects/\", \"/evaluations) or by its exact \", _jsx(_components.code, {\n children: \"criterion\"\n }), \" name. Notes are required. The whole batch is applied together, and the project’s proposal scores are recalculated afterwards, exactly as the UI does.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Score a proposal against the project's quality criteria (create or update an evaluation)","description":"Records reviewer scores out of 10, each with justification notes, against the project's evaluation criteria — mirroring the web UI's evaluation form. Send several criteria in one call via `scores`, or a single criterion at the top level. Re-scoring a criterion overwrites the previous score and notes, so the same call creates or updates an evaluation. Identify each criterion by `criterion_id` (from GET /projects/{id}/evaluations) or by its exact `criterion` name. Notes are required. The whole batch is applied together, and the project's proposal scores are recalculated afterwards, exactly as the UI does.","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json post /bids/{id}/scores","href":"/api-reference/v4/bids/score-a-proposal-against-the-projects-quality-criteria-create-or-update-an-evaluation","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Score a proposal against the project's quality criteria (create or update an evaluation)","description":"Records reviewer scores out of 10, each with justification notes, against the project's evaluation criteria — mirroring the web UI's evaluation form. Send several criteria in one call via `scores`, or a single criterion at the top level. Re-scoring a criterion overwrites the previous score and notes, so the same call creates or updates an evaluation. Identify each criterion by `criterion_id` (from GET /projects/{id}/evaluations) or by its exact `criterion` name. Notes are required. The whole batch is applied together, and the project's proposal scores are recalculated afterwards, exactly as the UI does.","tags":["Bids"],"security":["945007af-70ee-4735-ac9a-cdc01df98cc9"],"parameters":["d2dfe1ba-cba4-43e9-9fa4-32bea432479a"],"responses":{"200":"24a56902-ba72-4d7a-8d8f-b2f4e65ce81b","401":"c0d8cedf-2feb-4f71-a9fd-511cfe3571cf","403":"92a96a1a-b48e-4770-beb5-f102377ef741","422":"a74ec3c4-5f3d-4d3f-9604-8b6a9a9eb822"},"requestBody":"ed0bea20-ab5f-4076-9fdf-1c954e9ee880","operationId":"postBidsByIdScores","method":"post","type":"path","servers":["aa0b1458-6389-4e85-962c-a29220c35c66","d660a9e0-3bd7-43c1-8878-18db4712bb8a","56763708-39e4-4d42-a0b4-3e9a73099018","bb15fc1c-b1f1-4d36-af9e-66e6f4077ad6"],"path":"/bids/{id}/scores","baseUrlOptions":["https://api.zivio.net/api/v4","https://api.eu.zivio.net/api/v4","https://api.uk.zivio.net/api/v4","https://api.us.zivio.net/api/v4"],"title":"Score a proposal against the project's quality criteria (create or update an evaluation)","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"d2dfe1ba-cba4-43e9-9fa4-32bea432479a":{"name":"id","in":"path","required":true,"schema":{"type":"integer","isRequired":true,"description":"Bid ID","uniqueKey":"","typeLabel":"integer"},"description":"Bid ID","example":123}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"scores":{"type":"array","description":"One entry per criterion: { criterion_id or criterion, score (0-10), notes }.","items":{"type":"object","properties":{"criterion_id":{"type":"integer","description":"Quality criterion id.","example":11,"uniqueKey":"scores.items.[INDEX].criterion_id","typeLabel":"integer"},"criterion":{"type":"string","description":"Criterion name, as an alternative to criterion_id.","example":"Technical Approach","uniqueKey":"scores.items.[INDEX].criterion","typeLabel":"string"},"score":{"type":"integer","description":"Whole number from 0 to 10.","example":8,"uniqueKey":"scores.items.[INDEX].score","typeLabel":"integer"},"notes":{"type":"string","description":"Justification for the score (required).","example":"Strong discovery phase and a credible test strategy.","uniqueKey":"scores.items.[INDEX].notes","typeLabel":"string"}},"uniqueKey":"scores.items.[INDEX]","typeLabel":"object"},"uniqueKey":"scores","typeLabel":"object[]"},"criterion_id":{"type":"integer","description":"Single-score form: the criterion id.","uniqueKey":"criterion_id","typeLabel":"integer"},"criterion":{"type":"string","description":"Single-score form: the criterion name.","uniqueKey":"criterion","typeLabel":"string"},"score":{"type":"integer","description":"Single-score form: whole number from 0 to 10.","uniqueKey":"score","typeLabel":"integer"},"notes":{"type":"string","description":"Single-score form: justification (required).","uniqueKey":"notes","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"scores":[{"criterion_id":11,"criterion":"Technical Approach","score":8,"notes":"Strong discovery phase and a credible test strategy."}],"criterion_id":123,"criterion":"\u003cstring>","score":123,"notes":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"24a56902-ba72-4d7a-8d8f-b2f4e65ce81b":{"description":"Scores recorded; the proposal's recalculated scorecard is returned","content":{"application/json":{"schema":{"type":"object","uniqueKey":"","typeLabel":"object"},"example":{"message":"Recorded 2 scores for proposal 9","project_id":123,"proposal":{"bid_id":9,"total_score_percentage":84,"scores":[{"criterion_id":11,"criterion":"Technical Approach","score":8,"notes":"Strong discovery phase.","weighted_score":80}],"unscored_criteria":[]}},"examples":{"Example":{"title":"Example","value":{"message":"Recorded 2 scores for proposal 9","project_id":123,"proposal":{"bid_id":9,"total_score_percentage":84,"scores":[{"criterion_id":11,"criterion":"Technical Approach","score":8,"notes":"Strong discovery phase.","weighted_score":80}],"unscored_criteria":[]}}}},"exampleType":"examples"}},"exampleType":"examples"},"c0d8cedf-2feb-4f71-a9fd-511cfe3571cf":{"description":"Unauthorized - the access token is missing, expired, revoked or malformed","content":{"application/json":{"schema":{"type":"object","description":"Error envelope returned by every non-2xx V4 response","properties":{"error":{"type":"string","example":"insufficient_scope","uniqueKey":"error","typeLabel":"string"},"error_description":{"type":"string","uniqueKey":"error_description","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"uniqueKey":"details","typeLabel":"object"},"required_scope":{"type":"string","example":"projects:read","uniqueKey":"required_scope","typeLabel":"string"},"provided_scopes":{"type":"array","items":{"type":"string","uniqueKey":"provided_scopes.items.[INDEX]","typeLabel":"string"},"uniqueKey":"provided_scopes","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"invalid_token","error_description":"The access token provided is expired, revoked, malformed, or invalid for other reasons"},"examples":{"Example":{"title":"Example","value":{"error":"invalid_token","error_description":"The access token provided is expired, revoked, malformed, or invalid for other reasons"}}},"exampleType":"examples"}},"exampleType":"examples"},"92a96a1a-b48e-4770-beb5-f102377ef741":{"description":"Forbidden - insufficient scope","content":{"application/json":{"schema":{"type":"object","description":"Error envelope returned by every non-2xx V4 response","properties":{"error":{"type":"string","example":"insufficient_scope","uniqueKey":"error","typeLabel":"string"},"error_description":{"type":"string","uniqueKey":"error_description","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"uniqueKey":"details","typeLabel":"object"},"required_scope":{"type":"string","example":"projects:read","uniqueKey":"required_scope","typeLabel":"string"},"provided_scopes":{"type":"array","items":{"type":"string","uniqueKey":"provided_scopes.items.[INDEX]","typeLabel":"string"},"uniqueKey":"provided_scopes","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"insufficient_scope","error_description":"The request requires higher privileges than provided by the access token","required_scope":"bid_evaluations:write","provided_scopes":["welcome:read"]},"examples":{"Example":{"title":"Example","value":{"error":"insufficient_scope","error_description":"The request requires higher privileges than provided by the access token","required_scope":"bid_evaluations:write","provided_scopes":["welcome:read"]}}},"exampleType":"examples"}},"exampleType":"examples"},"a74ec3c4-5f3d-4d3f-9604-8b6a9a9eb822":{"description":"Unknown criterion, score out of range, missing notes, or quality scoring disabled for the project. A validation failure lists the project's available criteria so the call can be corrected","content":{"application/json":{"schema":{"type":"object","uniqueKey":"","typeLabel":"object"},"example":{"error":"validation_failed","errors":["score must be a whole number between 0 and 10 (got \"eight\")"],"available_criteria":[{"id":11,"description":"Technical Approach"}]},"examples":{"Example":{"title":"Example","value":{"error":"validation_failed","errors":["score must be a whole number between 0 and 10 (got \"eight\")"],"available_criteria":[{"id":11,"description":"Technical Approach"}]}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"945007af-70ee-4735-ac9a-cdc01df98cc9":{"oauth2":{"type":"oauth2","description":"OAuth 2.0 client credentials. The access token from POST /oauth/token is sent as a bearer token. Request only the scopes you need.","flows":{"clientCredentials":{"tokenUrl":"https://api.zivio.net/api/v4/oauth/token","scopes":{"bank_accounts:read":"Read bank account details on suppliers and the org.","catalogs:read":"Read catalog items.","cost_centers:read":"Read cost center records.","eoi_responses:read":"Read responses to expressions of interest.","eois:read":"Read expressions of interest.","offers:read":"Read offers for projects.","org_units:read":"Read your organization unit hierarchy.","org_users:read":"Read members of your organization.","resources:read":"Read resource (worker) records.","sales_invoices:read":"Read invoices issued to clients.","sales_milestones:read":"Read milestones on sales engagements.","skill_categories:read":"Read the skill category taxonomy.","skill_taxonomies:read":"Read skill taxonomy structure.","skills:read":"Read individual skills.","supplier_documents:read":"Read documents uploaded by suppliers.","supplier_lists:read":"Read curated lists of suppliers.","supplier_users:read":"Read users belonging to supplier organizations.","tax_types:read":"Read configured tax types.","users:read":"Read user profiles.","variation_orders:read":"Read variation orders on projects.","welcome:read":"Required: confirms your identity to the application.","bid_evaluations:read":"Read evaluation scorecards for bids, including criterion scores and quality, cost and total scores.","bid_evaluations:write":"Score bids against a project's quality criteria and override calculated cost scores.","bids:read":"Read bids submitted on projects.","bids:write":"Shortlist, select, eliminate and reinstate bids submitted on projects.","invoices:read":"Read invoices on projects.","invoices:write":"Create and update invoices.","notes:read":"Read notes on projects and EOIs.","notes:write":"Create and update notes on projects and EOIs.","project_approvals:read":"Read project approval workflows.","project_approvals:write":"Create and update project approval workflows.","project_conversations:read":"Read messages exchanged with suppliers on a project.","project_conversations:write":"Send messages to suppliers on a project.","project_invitations:read":"Read supplier invitations on projects.","project_invitations:write":"Invite suppliers to bid on projects.","project_questions:read":"Read supplier clarification questions on projects.","project_questions:write":"Answer and approve supplier clarification questions.","projects:read":"Read projects.","projects:write":"Create and update projects.","milestones:read":"Read milestones on projects.","milestones:write":"Create and update milestones.","orgs:read":"Read organization records.","orgs:write":"Create and update organization records.","purchase_orders:read":"Read purchase orders.","purchase_orders:write":"Create and update purchase orders.","reviews:read":"Read reviews left on suppliers.","reviews:write":"Create and update reviews.","suppliers:read":"Read supplier profiles.","suppliers:write":"Create and update supplier profiles.","raw_scorecard_entries:write":"Create and update raw scorecard entries.","raw_scorecard_entries:read":"Read raw scorecard entries.","tasks:read":"Read the acting user's task queue, including outstanding approvals and items to review.","tasks:write":"Complete and dismiss tasks in the acting user's task queue.","act_as_user":"Make requests as another user within the token holder's delegation boundary."}}},"scopes":["bid_evaluations:write"]},"tenantId":{"type":"apiKey","name":"zivio-tenant-id","in":"header","description":"Your Zivio organisation identifier. The regional API endpoints serve every Zivio organisation, so each request must identify yours.","scopes":[]}}},"servers":{"aa0b1458-6389-4e85-962c-a29220c35c66":{"url":"https://api.zivio.net/api/v4","description":"Global API Router"},"d660a9e0-3bd7-43c1-8878-18db4712bb8a":{"url":"https://api.eu.zivio.net/api/v4","description":"EU Data Region"},"56763708-39e4-4d42-a0b4-3e9a73099018":{"url":"https://api.uk.zivio.net/api/v4","description":"UK Data Region"},"bb15fc1c-b1f1-4d36-af9e-66e6f4077ad6":{"url":"https://api.us.zivio.net/api/v4","description":"US Data Region"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"oauth2","description":"OAuth 2.0 client credentials. The access token from POST /oauth/token is sent as a bearer token. Request only the scopes you need.","flows":{"clientCredentials":{"tokenUrl":"https://api.zivio.net/api/v4/oauth/token","scopes":{"bank_accounts:read":"Read bank account details on suppliers and the org.","catalogs:read":"Read catalog items.","cost_centers:read":"Read cost center records.","eoi_responses:read":"Read responses to expressions of interest.","eois:read":"Read expressions of interest.","offers:read":"Read offers for projects.","org_units:read":"Read your organization unit hierarchy.","org_users:read":"Read members of your organization.","resources:read":"Read resource (worker) records.","sales_invoices:read":"Read invoices issued to clients.","sales_milestones:read":"Read milestones on sales engagements.","skill_categories:read":"Read the skill category taxonomy.","skill_taxonomies:read":"Read skill taxonomy structure.","skills:read":"Read individual skills.","supplier_documents:read":"Read documents uploaded by suppliers.","supplier_lists:read":"Read curated lists of suppliers.","supplier_users:read":"Read users belonging to supplier organizations.","tax_types:read":"Read configured tax types.","users:read":"Read user profiles.","variation_orders:read":"Read variation orders on projects.","welcome:read":"Required: confirms your identity to the application.","bid_evaluations:read":"Read evaluation scorecards for bids, including criterion scores and quality, cost and total scores.","bid_evaluations:write":"Score bids against a project's quality criteria and override calculated cost scores.","bids:read":"Read bids submitted on projects.","bids:write":"Shortlist, select, eliminate and reinstate bids submitted on projects.","invoices:read":"Read invoices on projects.","invoices:write":"Create and update invoices.","notes:read":"Read notes on projects and EOIs.","notes:write":"Create and update notes on projects and EOIs.","project_approvals:read":"Read project approval workflows.","project_approvals:write":"Create and update project approval workflows.","project_conversations:read":"Read messages exchanged with suppliers on a project.","project_conversations:write":"Send messages to suppliers on a project.","project_invitations:read":"Read supplier invitations on projects.","project_invitations:write":"Invite suppliers to bid on projects.","project_questions:read":"Read supplier clarification questions on projects.","project_questions:write":"Answer and approve supplier clarification questions.","projects:read":"Read projects.","projects:write":"Create and update projects.","milestones:read":"Read milestones on projects.","milestones:write":"Create and update milestones.","orgs:read":"Read organization records.","orgs:write":"Create and update organization records.","purchase_orders:read":"Read purchase orders.","purchase_orders:write":"Create and update purchase orders.","reviews:read":"Read reviews left on suppliers.","reviews:write":"Create and update reviews.","suppliers:read":"Read supplier profiles.","suppliers:write":"Create and update supplier profiles.","raw_scorecard_entries:write":"Create and update raw scorecard entries.","raw_scorecard_entries:read":"Read raw scorecard entries.","tasks:read":"Read the acting user's task queue, including outstanding approvals and items to review.","tasks:write":"Complete and dismiss tasks in the acting user's task queue.","act_as_user":"Make requests as another user within the token holder's delegation boundary."}}},"scopes":["bid_evaluations:write"]},"schema":{"title":"OAuth2 Auth","type":"string","isRequired":true,"description":"OAuth 2.0 client credentials. The access token from POST /oauth/token is sent as a bearer token. Request only the scopes you need.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"oauth2","name":"Authorization"},{"scheme":{"type":"apiKey","name":"zivio-tenant-id","in":"header","description":"Your Zivio organisation identifier. The regional API endpoints serve every Zivio organisation, so each request must identify yours.","scopes":[]},"schema":{"title":"zivio-tenant-id","type":"string","description":"Your Zivio organisation identifier. The regional API endpoints serve every Zivio organisation, so each request must identify yours.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"tenantId","name":"zivio-tenant-id"}],"title":"oauth2 \u0026 tenantId"}]},"originalFileLocation":"api-reference/v4/openapi.json"},"subdomain":"zivio","siteName":"Zivio API Documentation","title":"Score a proposal against the project's quality criteria (create or update an evaluation) - Zivio API Documentation","navMaps":{"firstHrefInVersion":{"v4":{"href":"/api-reference/v4/bids/score-a-proposal-against-the-projects-quality-criteria-create-or-update-an-evaluation","matchLevel":0},"v3":{"href":"/v3-notice","matchLevel":4}},"firstHrefInLanguage":{}},"lastModified":"2026-09-11T20:36:35.603Z","originalFileLocation":"api-reference/v4/bids/score-a-proposal-against-the-projects-quality-criteria-create-or-update-an-evaluation.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Records reviewer scores out of 10, each with justification notes, against the project\u0026#x27;s evaluation criteria — mirroring the web UI\u0026#x27;s evaluation form. Send several criteria in one call via scores, or a single criterion at the top level. Re-scoring a criterion overwrites the previous score and notes, so the same call creates or updates an evaluation. Identify each criterion by criterion_id (from GET /projects/{id}/evaluations) or by its exact criterion name. Notes are required. The whole batch is applied together, and the project\u0026#x27;s proposal scores are recalculated afterwards, exactly as the UI does.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Zivio API Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/zivio/53c9XLGOXMDHAUjU/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/zivio/53c9XLGOXMDHAUjU/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/zivio/53c9XLGOXMDHAUjU/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/zivio/53c9XLGOXMDHAUjU/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/zivio/53c9XLGOXMDHAUjU/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/zivio/53c9XLGOXMDHAUjU/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/zivio/53c9XLGOXMDHAUjU/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/zivio/53c9XLGOXMDHAUjU/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/zivio/53c9XLGOXMDHAUjU/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Score a proposal against the project\u0026#x27;s quality criteria (create or update an evaluation) - Zivio API Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Records reviewer scores out of 10, each with justification notes, against the project\u0026#x27;s evaluation criteria — mirroring the web UI\u0026#x27;s evaluation form. Send several criteria in one call via scores, or a single criterion at the top level. Re-scoring a criterion overwrites the previous score and notes, so the same call creates or updates an evaluation. Identify each criterion by criterion_id (from GET /projects/{id}/evaluations) or by its exact criterion name. Notes are required. The whole batch is applied together, and the project\u0026#x27;s proposal scores are recalculated afterwards, exactly as the UI does.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Zivio API Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.zivio.com/api-reference/v4/bids/score-a-proposal-against-the-projects-quality-criteria-create-or-update-an-evaluation\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://zivio.mintlify.app/_mintlify/api/og/v2?division=Bids\u0026amp;title=Score+a+proposal+against+the+project%27s+quality+criteria+%28create+or+update+an+evaluation%29\u0026amp;description=Records+reviewer+scores+out+of+10%2C+each+with+justification+notes%2C+against+the+project%27s+evaluation+criteria+%E2%80%94+mirroring+the+web+UI%27s+evaluation+form.+Send+sever\u0026amp;theme=1bf58ecb3dcd43f6bf622534\u0026amp;signature=befe2d1c3eabef8b26d70aeae8c8e14ac5fec18ef2b4378af7cc707d109f73d7\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Score a proposal against the project\u0026#x27;s quality criteria (create or update an evaluation) - Zivio API Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Records reviewer scores out of 10, each with justification notes, against the project\u0026#x27;s evaluation criteria — mirroring the web UI\u0026#x27;s evaluation form. Send several criteria in one call via scores, or a single criterion at the top level. Re-scoring a criterion overwrites the previous score and notes, so the same call creates or updates an evaluation. Identify each criterion by criterion_id (from GET /projects/{id}/evaluations) or by its exact criterion name. Notes are required. The whole batch is applied together, and the project\u0026#x27;s proposal scores are recalculated afterwards, exactly as the UI does.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://zivio.mintlify.app/_mintlify/api/og/v2?division=Bids\u0026amp;title=Score+a+proposal+against+the+project%27s+quality+criteria+%28create+or+update+an+evaluation%29\u0026amp;description=Records+reviewer+scores+out+of+10%2C+each+with+justification+notes%2C+against+the+project%27s+evaluation+criteria+%E2%80%94+mirroring+the+web+UI%27s+evaluation+form.+Send+sever\u0026amp;theme=1bf58ecb3dcd43f6bf622534\u0026amp;signature=befe2d1c3eabef8b26d70aeae8c8e14ac5fec18ef2b4378af7cc707d109f73d7\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/zivio/53c9XLGOXMDHAUjU/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Zivio API Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#8FC640\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.zivio.com/api-reference/v4/bids/score-a-proposal-against-the-projects-quality-criteria-create-or-update-an-evaluation\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/v4/bids/score-a-proposal-against-the-projects-quality-criteria-create-or-update-an-evaluation.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.zivio.com/#organization\",\"name\":\"Zivio API Documentation\",\"url\":\"https://docs.zivio.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/zivio/TS2e-J71a1N5Byq4/logo/light.png?fit=max\u0026auto=format\u0026n=TS2e-J71a1N5Byq4\u0026q=85\u0026s=bb658cb8a0c9eb4edf53d8ceef401821\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.zivio.com#website\",\"name\":\"Zivio API Documentation\",\"url\":\"https://docs.zivio.com\",\"publisher\":{\"@id\":\"https://docs.zivio.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.zivio.com/api-reference/v4/bids/score-a-proposal-against-the-projects-quality-criteria-create-or-update-an-evaluation#webpage\",\"url\":\"https://docs.zivio.com/api-reference/v4/bids/score-a-proposal-against-the-projects-quality-criteria-create-or-update-an-evaluation\",\"name\":\"Score a proposal against the project's quality criteria (create or update an evaluation)\",\"description\":\"Records reviewer scores out of 10, each with justification notes, against the project's evaluation criteria — mirroring the web UI's evaluation form. Send several criteria in one call via scores, or a single criterion at the top level. Re-scoring a criterion overwrites the previous score and notes, so the same call creates or updates an evaluation. Identify each criterion by criterion_id (from GET /projects/{id}/evaluations) or by its exact criterion name. Notes are required. The whole batch is applied together, and the project's proposal scores are recalculated afterwards, exactly as the UI does.\",\"dateModified\":\"2026-09-11T20:36:35.603Z\",\"isPartOf\":{\"@id\":\"https://docs.zivio.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.zivio.com/api-reference/v4/bids/score-a-proposal-against-the-projects-quality-criteria-create-or-update-an-evaluation#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.zivio.com/api-reference/v4/bids/score-a-proposal-against-the-projects-quality-criteria-create-or-update-an-evaluation#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Bids\",\"item\":\"https://docs.zivio.com/api-reference/v4/bids/list-bids\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Score a proposal against the project's quality criteria (create or update an evaluation)\",\"item\":\"https://docs.zivio.com/api-reference/v4/bids/score-a-proposal-against-the-projects-quality-criteria-create-or-update-an-evaluation\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.zivio.com/api-reference/v4/bids/score-a-proposal-against-the-projects-quality-criteria-create-or-update-an-evaluation#apireference\",\"headline\":\"Score a proposal against the project's quality criteria (create or update an evaluation)\",\"name\":\"Score a proposal against the project's quality criteria (create or update an evaluation)\",\"description\":\"Records reviewer scores out of 10, each with justification notes, against the project's evaluation criteria — mirroring the web UI's evaluation form. Send several criteria in one call via scores, or a single criterion at the top level. Re-scoring a criterion overwrites the previous score and notes, so the same call creates or updates an evaluation. Identify each criterion by criterion_id (from GET /projects/{id}/evaluations) or by its exact criterion name. Notes are required. The whole batch is applied together, and the project's proposal scores are recalculated afterwards, exactly as the UI does.\",\"url\":\"https://docs.zivio.com/api-reference/v4/bids/score-a-proposal-against-the-projects-quality-criteria-create-or-update-an-evaluation\",\"mainEntityOfPage\":{\"@id\":\"https://docs.zivio.com/api-reference/v4/bids/score-a-proposal-against-the-projects-quality-criteria-create-or-update-an-evaluation#webpage\"},\"dateModified\":\"2026-09-11T20:36:35.603Z\",\"publisher\":{\"@id\":\"https://docs.zivio.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.zivio.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Zivio API Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Zivio API Documentation","nav":{"global":null,"versions":[{"version":"v4","default":true,"tag":"Latest","tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/v4/overview"}]},{"tab":"API Reference","groups":[{"group":"Authentication","pages":[{"title":"Obtain an access token","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json post /oauth/token","href":"/api-reference/v4/authentication/obtain-an-access-token"}]},{"group":"Welcome","pages":[{"title":"Who am I — the current authenticated user and token scopes (whoami)","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /welcome","href":"/api-reference/v4/welcome/who-am-i-—-the-current-authenticated-user-and-token-scopes-whoami"}]},{"group":"Bids","pages":[{"title":"List Bids","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /bids","href":"/api-reference/v4/bids/list-bids"},{"title":"Get a Bid","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /bids/{id}","href":"/api-reference/v4/bids/get-a-bid"},{"title":"Get filterable attributes for Bids","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /bids/help","href":"/api-reference/v4/bids/get-filterable-attributes-for-bids"},{"title":"One proposal's evaluation scorecard (criterion scores, notes, quality/cost/total)","description":"Returns the reviewer scores and notes recorded against each of the project's quality criteria for this proposal, which criteria are still unscored, and the resulting quality, cost and total score percentages (including whether the cost score is automatic or overridden). Use GET /projects/{id}/evaluations to see all proposals ranked side by side.","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /bids/{id}/evaluation","href":"/api-reference/v4/bids/one-proposals-evaluation-scorecard-criterion-scores-notes-qualitycosttotal"},{"title":"Score a proposal against the project's quality criteria (create or update an evaluation)","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json post /bids/{id}/scores","href":"/api-reference/v4/bids/score-a-proposal-against-the-projects-quality-criteria-create-or-update-an-evaluation"},{"title":"Override (moderate) a proposal's automatically calculated cost score","description":"Replaces the automatic, price-relative cost score with a moderated percentage, mirroring the web UI's cost score override. The value is a percentage of the total available score and is capped at the project's cost score allocation — the response reports the stored value and whether it was capped. Send `null` to clear the override and fall back to the automatic score. Requires cost-score moderation permission on the project.","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json post /bids/{id}/cost_score_override","href":"/api-reference/v4/bids/override-moderate-a-proposals-automatically-calculated-cost-score"},{"title":"Shortlist a proposal (add it to the project shortlist)","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json post /bids/{id}/shortlist","href":"/api-reference/v4/bids/shortlist-a-proposal-add-it-to-the-project-shortlist"},{"title":"Remove a proposal from the project shortlist (without eliminating it)","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json post /bids/{id}/unshortlist","href":"/api-reference/v4/bids/remove-a-proposal-from-the-project-shortlist-without-eliminating-it"},{"title":"Select a proposal as the preferred supplier (notifies the hiring team)","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json post /bids/{id}/select","href":"/api-reference/v4/bids/select-a-proposal-as-the-preferred-supplier-notifies-the-hiring-team"},{"title":"Withdraw a proposal's supplier selection","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json post /bids/{id}/deselect","href":"/api-reference/v4/bids/withdraw-a-proposals-supplier-selection"},{"title":"Eliminate a proposal — reject or archive it, notifying the supplier","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json post /bids/{id}/eliminate","href":"/api-reference/v4/bids/eliminate-a-proposal-—-reject-or-archive-it-notifying-the-supplier"},{"title":"List a proposal's attachments with download URLs","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /bids/{id}/attachments","href":"/api-reference/v4/bids/list-a-proposals-attachments-with-download-urls"},{"title":"Reinstate an eliminated proposal so it can be evaluated again","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json post /bids/{id}/reinstate","href":"/api-reference/v4/bids/reinstate-an-eliminated-proposal-so-it-can-be-evaluated-again"},{"title":"Aggregate bid (proposal) value grouped by one or more dimensions","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /bids/summary","href":"/api-reference/v4/bids/aggregate-bid-proposal-value-grouped-by-one-or-more-dimensions"}]},{"group":"Eois","pages":[{"title":"List Eois","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /eois","href":"/api-reference/v4/eois/list-eois"},{"title":"Get a Eoi","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /eois/{id}","href":"/api-reference/v4/eois/get-a-eoi"},{"title":"Get filterable attributes for Eois","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /eois/help","href":"/api-reference/v4/eois/get-filterable-attributes-for-eois"}]},{"group":"Eoi Responses","pages":[{"title":"List Eoi Responses","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /eoi_responses","href":"/api-reference/v4/eoi-responses/list-eoi-responses"},{"title":"Get a Eoi Response","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /eoi_responses/{id}","href":"/api-reference/v4/eoi-responses/get-a-eoi-response"},{"title":"Get filterable attributes for Eoi Responses","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /eoi_responses/help","href":"/api-reference/v4/eoi-responses/get-filterable-attributes-for-eoi-responses"}]},{"group":"Invoices","pages":[{"title":"List Invoices","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /invoices","href":"/api-reference/v4/invoices/list-invoices"},{"title":"Get a Invoice","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /invoices/{id}","href":"/api-reference/v4/invoices/get-a-invoice"},{"title":"Get filterable attributes for Invoices","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /invoices/help","href":"/api-reference/v4/invoices/get-filterable-attributes-for-invoices"},{"title":"Mark an invoice as paid","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json post /invoices/{id}/paid","href":"/api-reference/v4/invoices/mark-an-invoice-as-paid"},{"title":"Retrieve the presigned S3 URL for the invoice PDF","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /invoices/{id}/file","href":"/api-reference/v4/invoices/retrieve-the-presigned-s3-url-for-the-invoice-pdf"},{"title":"Aggregate invoice spend grouped by one or more dimensions","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /invoices/summary","href":"/api-reference/v4/invoices/aggregate-invoice-spend-grouped-by-one-or-more-dimensions"}]},{"group":"Milestones","pages":[{"title":"List Milestones","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /milestones","href":"/api-reference/v4/milestones/list-milestones"},{"title":"Get a Milestone","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /milestones/{id}","href":"/api-reference/v4/milestones/get-a-milestone"},{"title":"Get filterable attributes for Milestones","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /milestones/help","href":"/api-reference/v4/milestones/get-filterable-attributes-for-milestones"},{"title":"Aggregate milestone value grouped by one or more dimensions","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /milestones/summary","href":"/api-reference/v4/milestones/aggregate-milestone-value-grouped-by-one-or-more-dimensions"}]},{"group":"Offers","pages":[{"title":"List Offers","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /offers","href":"/api-reference/v4/offers/list-offers"},{"title":"Get a Offer","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /offers/{id}","href":"/api-reference/v4/offers/get-a-offer"},{"title":"Get filterable attributes for Offers","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /offers/help","href":"/api-reference/v4/offers/get-filterable-attributes-for-offers"},{"title":"Aggregate offer (work order) value grouped by one or more dimensions","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /offers/summary","href":"/api-reference/v4/offers/aggregate-offer-work-order-value-grouped-by-one-or-more-dimensions"}]},{"group":"Projects","pages":[{"title":"List Projects","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /projects","href":"/api-reference/v4/projects/list-projects"},{"title":"Create a Project","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json post /projects","href":"/api-reference/v4/projects/create-a-project"},{"title":"Get a Project","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /projects/{id}","href":"/api-reference/v4/projects/get-a-project"},{"title":"Update a Project","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json patch /projects/{id}","href":"/api-reference/v4/projects/update-a-project"},{"title":"Get filterable attributes for Projects","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /projects/help","href":"/api-reference/v4/projects/get-filterable-attributes-for-projects"},{"title":"Submit a draft project for approval (publish)","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json post /projects/{id}/submit","href":"/api-reference/v4/projects/submit-a-draft-project-for-approval-publish"},{"title":"List projects awaiting the acting user's approval","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /projects/approvals","href":"/api-reference/v4/projects/list-projects-awaiting-the-acting-users-approval"},{"title":"Who can approve a project, and where it sits in the approval workflow","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /projects/{id}/approval_status","href":"/api-reference/v4/projects/who-can-approve-a-project-and-where-it-sits-in-the-approval-workflow"},{"title":"Approve a pending project at its current approval level","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json post /projects/{id}/approve","href":"/api-reference/v4/projects/approve-a-pending-project-at-its-current-approval-level"},{"title":"Reject a pending project with a reason","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json post /projects/{id}/reject","href":"/api-reference/v4/projects/reject-a-pending-project-with-a-reason"},{"title":"Put an open project on hold (pause sourcing)","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json post /projects/{id}/hold","href":"/api-reference/v4/projects/put-an-open-project-on-hold-pause-sourcing"},{"title":"Take a held project off hold (resume sourcing)","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json post /projects/{id}/resume","href":"/api-reference/v4/projects/take-a-held-project-off-hold-resume-sourcing"},{"title":"Cancel a project (with a reason)","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json post /projects/{id}/cancel","href":"/api-reference/v4/projects/cancel-a-project-with-a-reason"},{"title":"Mark a delivered project's work as completed","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json post /projects/{id}/complete","href":"/api-reference/v4/projects/mark-a-delivered-projects-work-as-completed"},{"title":"Start a best-and-final-offer (BAFO) round with the listed shortlisted proposals","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json post /projects/{id}/request_bafo","href":"/api-reference/v4/projects/start-a-best-and-final-offer-bafo-round-with-the-listed-shortlisted-proposals"},{"title":"Start an additional bid round (clone the project for fresh proposals)","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json post /projects/{id}/additional_bid_round","href":"/api-reference/v4/projects/start-an-additional-bid-round-clone-the-project-for-fresh-proposals"},{"title":"List a project's attachments with download URLs","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /projects/{id}/attachments","href":"/api-reference/v4/projects/list-a-projects-attachments-with-download-urls"},{"title":"List a project's supplier conversations","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /projects/{id}/conversations","href":"/api-reference/v4/projects/list-a-projects-supplier-conversations"},{"title":"Message a supplier about a project (start or continue their thread)","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json post /projects/{id}/conversations","href":"/api-reference/v4/projects/message-a-supplier-about-a-project-start-or-continue-their-thread"},{"title":"Read a conversation's messages","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /projects/{id}/conversations/{conversation_id}","href":"/api-reference/v4/projects/read-a-conversations-messages"},{"title":"Reply to an existing conversation","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json post /projects/{id}/conversations/{conversation_id}/reply","href":"/api-reference/v4/projects/reply-to-an-existing-conversation"},{"title":"List suppliers invited to a project and their response status","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /projects/{id}/invitations","href":"/api-reference/v4/projects/list-suppliers-invited-to-a-project-and-their-response-status"},{"title":"Invite a supplier — or a whole supplier list (talent pool) — to bid on a project","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json post /projects/{id}/invitations","href":"/api-reference/v4/projects/invite-a-supplier-—-or-a-whole-supplier-list-talent-pool-—-to-bid-on-a-project"},{"title":"List supplier clarification questions (Q\u0026A) on a project","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /projects/{id}/questions","href":"/api-reference/v4/projects/list-supplier-clarification-questions-q\u0026a-on-a-project"},{"title":"Answer a supplier clarification question on a project","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json post /projects/{id}/questions/{question_id}/answer","href":"/api-reference/v4/projects/answer-a-supplier-clarification-question-on-a-project"},{"title":"Approve a supplier question's answer — and optionally share it with all suppliers","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json post /projects/{id}/questions/{question_id}/approve","href":"/api-reference/v4/projects/approve-a-supplier-questions-answer-—-and-optionally-share-it-with-all-suppliers"},{"title":"Mark a supplier question as a duplicate of another question","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json post /projects/{id}/questions/{question_id}/link_duplicate","href":"/api-reference/v4/projects/mark-a-supplier-question-as-a-duplicate-of-another-question"},{"title":"Remove a supplier question's duplicate link","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json post /projects/{id}/questions/{question_id}/unlink_duplicate","href":"/api-reference/v4/projects/remove-a-supplier-questions-duplicate-link"},{"title":"Evaluation scorecards for every proposal on a project (scores, weightings, ranking)","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /projects/{id}/evaluations","href":"/api-reference/v4/projects/evaluation-scorecards-for-every-proposal-on-a-project-scores-weightings-ranking"},{"title":"Run (or re-run) the automatic evaluation across a project's proposals","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json post /projects/{id}/evaluations/run","href":"/api-reference/v4/projects/run-or-re-run-the-automatic-evaluation-across-a-projects-proposals"},{"title":"Upload a file attachment to a project","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json post /projects/{id}/file_upload","href":"/api-reference/v4/projects/upload-a-file-attachment-to-a-project"},{"title":"Aggregate project spend grouped by one or more dimensions","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /projects/summary","href":"/api-reference/v4/projects/aggregate-project-spend-grouped-by-one-or-more-dimensions"}]},{"group":"Supplier Lists","pages":[{"title":"List Supplier Lists","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /supplier_lists","href":"/api-reference/v4/supplier-lists/list-supplier-lists"},{"title":"Get a Supplier List","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /supplier_lists/{id}","href":"/api-reference/v4/supplier-lists/get-a-supplier-list"},{"title":"Get filterable attributes for Supplier Lists","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /supplier_lists/help","href":"/api-reference/v4/supplier-lists/get-filterable-attributes-for-supplier-lists"}]},{"group":"Suppliers","pages":[{"title":"List Suppliers","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /suppliers","href":"/api-reference/v4/suppliers/list-suppliers"},{"title":"Get a Supplier","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /suppliers/{id}","href":"/api-reference/v4/suppliers/get-a-supplier"},{"title":"Get filterable attributes for Suppliers","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /suppliers/help","href":"/api-reference/v4/suppliers/get-filterable-attributes-for-suppliers"}]},{"group":"Variation Orders","pages":[{"title":"List Variation Orders","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /variation_orders","href":"/api-reference/v4/variation-orders/list-variation-orders"},{"title":"Get a Variation Order","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /variation_orders/{id}","href":"/api-reference/v4/variation-orders/get-a-variation-order"},{"title":"Get filterable attributes for Variation Orders","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /variation_orders/help","href":"/api-reference/v4/variation-orders/get-filterable-attributes-for-variation-orders"},{"title":"Aggregate variation order value grouped by one or more dimensions","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /variation_orders/summary","href":"/api-reference/v4/variation-orders/aggregate-variation-order-value-grouped-by-one-or-more-dimensions"}]},{"group":"Users","pages":[{"title":"List Users","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /users","href":"/api-reference/v4/users/list-users"},{"title":"Get a User","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /users/{id}","href":"/api-reference/v4/users/get-a-user"},{"title":"Get filterable attributes for Users","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /users/help","href":"/api-reference/v4/users/get-filterable-attributes-for-users"}]},{"group":"Skill Taxonomies","pages":[{"title":"List Skill Taxonomies","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /skill_taxonomies","href":"/api-reference/v4/skill-taxonomies/list-skill-taxonomies"},{"title":"Get a Skill Taxonomy","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /skill_taxonomies/{id}","href":"/api-reference/v4/skill-taxonomies/get-a-skill-taxonomy"},{"title":"Get filterable attributes for Skill Taxonomies","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /skill_taxonomies/help","href":"/api-reference/v4/skill-taxonomies/get-filterable-attributes-for-skill-taxonomies"}]},{"group":"Tax Types","pages":[{"title":"List Tax Types","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /tax_types","href":"/api-reference/v4/tax-types/list-tax-types"},{"title":"Get a Tax Type","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /tax_types/{id}","href":"/api-reference/v4/tax-types/get-a-tax-type"},{"title":"Get filterable attributes for Tax Types","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /tax_types/help","href":"/api-reference/v4/tax-types/get-filterable-attributes-for-tax-types"}]},{"group":"Bank Accounts","pages":[{"title":"List Bank Accounts","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /bank_accounts","href":"/api-reference/v4/bank-accounts/list-bank-accounts"},{"title":"Get a Bank Account","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /bank_accounts/{id}","href":"/api-reference/v4/bank-accounts/get-a-bank-account"},{"title":"Get filterable attributes for Bank Accounts","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /bank_accounts/help","href":"/api-reference/v4/bank-accounts/get-filterable-attributes-for-bank-accounts"}]},{"group":"Raw Scorecard Entries","pages":[{"title":"List Raw Scorecard Entries","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /raw_scorecard_entries","href":"/api-reference/v4/raw-scorecard-entries/list-raw-scorecard-entries"},{"title":"Get a Raw Scorecard Entry","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /raw_scorecard_entries/{id}","href":"/api-reference/v4/raw-scorecard-entries/get-a-raw-scorecard-entry"},{"title":"Get filterable attributes for Raw Scorecard Entries","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /raw_scorecard_entries/help","href":"/api-reference/v4/raw-scorecard-entries/get-filterable-attributes-for-raw-scorecard-entries"}]},{"group":"Reviews","pages":[{"title":"List Reviews","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /reviews","href":"/api-reference/v4/reviews/list-reviews"},{"title":"Get a Review","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /reviews/{id}","href":"/api-reference/v4/reviews/get-a-review"},{"title":"Get filterable attributes for Reviews","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /reviews/help","href":"/api-reference/v4/reviews/get-filterable-attributes-for-reviews"}]},{"group":"Supplier Users","pages":[{"title":"List Supplier Users","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /supplier_users","href":"/api-reference/v4/supplier-users/list-supplier-users"},{"title":"Get a Supplier User","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /supplier_users/{id}","href":"/api-reference/v4/supplier-users/get-a-supplier-user"},{"title":"Get filterable attributes for Supplier Users","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /supplier_users/help","href":"/api-reference/v4/supplier-users/get-filterable-attributes-for-supplier-users"}]},{"group":"Orgs","pages":[{"title":"List Orgs","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /orgs","href":"/api-reference/v4/orgs/list-orgs"},{"title":"Get a Org","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /orgs/{id}","href":"/api-reference/v4/orgs/get-a-org"},{"title":"Get filterable attributes for Orgs","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /orgs/help","href":"/api-reference/v4/orgs/get-filterable-attributes-for-orgs"}]},{"group":"Purchase Orders","pages":[{"title":"List Purchase Orders","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /purchase_orders","href":"/api-reference/v4/purchase-orders/list-purchase-orders"},{"title":"Get a Purchase Order","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /purchase_orders/{id}","href":"/api-reference/v4/purchase-orders/get-a-purchase-order"},{"title":"Get filterable attributes for Purchase Orders","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /purchase_orders/help","href":"/api-reference/v4/purchase-orders/get-filterable-attributes-for-purchase-orders"}]},{"group":"Notes","pages":[{"title":"Get a Note","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /notes/{id}","href":"/api-reference/v4/notes/get-a-note"},{"title":"Delete a Note","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json delete /notes/{id}","href":"/api-reference/v4/notes/delete-a-note"},{"title":"Update a Note","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json patch /notes/{id}","href":"/api-reference/v4/notes/update-a-note"},{"title":"Get filterable attributes for Notes","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /notes/help","href":"/api-reference/v4/notes/get-filterable-attributes-for-notes"},{"title":"List Project Notes","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /projects/{project_id}/notes","href":"/api-reference/v4/notes/list-project-notes"},{"title":"Create a Project Note","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json post /projects/{project_id}/notes","href":"/api-reference/v4/notes/create-a-project-note"},{"title":"List EOI Notes","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /eois/{eoi_id}/notes","href":"/api-reference/v4/notes/list-eoi-notes"},{"title":"Create an EOI Note","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json post /eois/{eoi_id}/notes","href":"/api-reference/v4/notes/create-an-eoi-note"}]},{"group":"Tasks","pages":[{"title":"List Tasks","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /tasks","href":"/api-reference/v4/tasks/list-tasks"},{"title":"Get a Task","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /tasks/{id}","href":"/api-reference/v4/tasks/get-a-task"},{"title":"Get filterable attributes for Tasks","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /tasks/help","href":"/api-reference/v4/tasks/get-filterable-attributes-for-tasks"},{"title":"Counts of my outstanding tasks: active, overdue, due today, and by kind of task","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json get /tasks/summary","href":"/api-reference/v4/tasks/counts-of-my-outstanding-tasks:-active-overdue-due-today-and-by-kind-of-task"},{"title":"Mark a task as complete (done) for every assignee","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json post /tasks/{id}/complete","href":"/api-reference/v4/tasks/mark-a-task-as-complete-done-for-every-assignee"},{"title":"Dismiss (hide) a task from my own list without completing it","deprecated":null,"version":null,"openapi":"/api-reference/v4/openapi.json post /tasks/{id}/dismiss","href":"/api-reference/v4/tasks/dismiss-hide-a-task-from-my-own-list-without-completing-it"}]}]}]},{"version":"v3","tag":"Legacy","pages":[{"title":"v3","href":"/v3-notice"}]}]},"title":"Score a proposal against the project's quality criteria (create or update an evaluation) - Zivio API Documentation","buildId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","deploymentId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-rfhihCWU.js","utils-BmH1XFxk.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BcNsxPKB.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BAES3tkd.js","snippetPresets-DCMQBKLP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D6l_bzE9.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BOktbnNh.js","shallow-BCs8SgM7.js","getApiPlaygroundDisplay-DEmW5bJB.js","CodeSnippet-CpZOpB9C.js","CodeSnippets-BOBDqibl.js","Page-D5fEM6aW.js","getPastedJson-DH2JBvmr.js","icon-BBJH-kKh.js","MethodPill-D2Sd5NLC.js","DuplicateIcon-CGgfL2qN.js","createIcon-BKudBBzi.js","DynamicMarkdown-85clUA0i.js","SectionHeading-D0JiMgDx.js","axios-vUo_bRtp.js","Markdown-Cfiy0xZO.js","clsx-rL8ZCCw4.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-aeztFa9U.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BywkCr5C.js"]}