For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Get SupportGet a demo
  • Get Started
    • Welcome
    • Quickstart
  • Webhooks
    • Introduction
    • Creating a Webhook
    • Available Webhooks
  • Public API Reference (Beta)
    • Applicants/Candidates
    • Contacts/Managers
    • Clients/Departments
        • POSTCreate an opportunity
        • DELDelete an opportunity
        • GETGet an opportunity by GUID
        • GETList opportunities
        • PUTUpdate an opportunity
  • Internal API Reference
    • Applicants/Candidates
    • Clients/Departments
    • Contacts/Managers
LogoLogo
Get SupportGet a demo
Public API Reference (Beta)OpportunitiesCore

Update an opportunity

PUT
https://app.brightmove.com/ATS/api/v1/opportunities/:guid
PUT
/ATS/api/v1/opportunities/:guid
$curl -X PUT https://app.brightmove.com/ATS/api/v1/opportunities/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
>     -H "X-Brightmove-Company-ApiKey: <apiKey>" \
>     -H "Content-Type: application/json" \
>     -d '{}'
200Updated
1{}

Partially updates a sales opportunity. Only fields present in the request body are modified; omitted fields are left unchanged. Requires the Manage My Opportunities permission (if assigned as a sales rep) or Manage Any Opportunities (for any opportunity).

Was this page helpful?
Previous

Create a placement

Next
Built with

Authentication

X-Brightmove-Company-ApiKeystring
BrightMove Company Api Key
X-Brightmove-User-ApiKeystring
BrightMove User Api Key

Path parameters

guidstringRequired
Stable public identifier of the opportunity

Request

This endpoint expects an object.
namestringOptional
Name of the opportunity.
clientGuidstringOptional

GUID of the client (company) to associate with this opportunity.

stageNamestringOptional
Stage name exactly as returned by the GET endpoint. Must match an existing stage configured for your company.
typeNamestringOptional
Opportunity type name exactly as returned by the GET endpoint. Must match an existing type configured for your company.
descriptionstringOptional
Detailed description of the opportunity and its objectives.
opportunityValuedoubleOptional
Estimated total deal value in USD.
closeProbabilitydoubleOptional
Estimated probability of closing this opportunity, expressed as a percentage from 0 to 100.
leadSourceNamestringOptional
Lead source name exactly as returned by the GET endpoint. Must match an existing lead source configured for your company.

Response

Opportunity updated and returned