Update a co-sell opportunity

post

https://aws.cosell.tackle.io/api/opportunities/{opportunity_id}

Queues a partial update against AWS Partner Central. The exact behavior depends on
the value of the tackle-operation-id header.

Production cloud operations: updateOpportunity (default), updateDraftOpportunity,
updateStartEngagementOpportunity, startEngagement, closeLostOpportunity,
launchOpportunity, updateOpportunityCRMID.
Test-environment-only: acceptOpportunity, rejectOpportunity. These simulate
AWS-side responses to an incoming engagement invitation/opportunity and are routable
only for vendor accounts provisioned for use in a test environment. Production vendor
accounts that send one of these operation IDs receive 400 Bad Request with the
message the requested operation is only supported in test or demo environments.

The success response is 202 Accepted with an empty body; poll getOpportunity or
listOpportunityEvents to observe the outcome of the queued request.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

opportunity_id

string

required

The Tackle identifier for the opportunity (for example, tackle-cosell-2jhD8b41CurTOqEsG2Soinublv3).
This is the value returned in the id field of listOpportunities rows and in metadata.id on
getOpportunity. The cloud-provider identifier (for example, O123456, returned in the response
body's top-level id field) is not accepted here.

Body Params

awsSubmission

object

This information is required to start engagement with AWS.

nationalSecurity

string

enum

Whether the opportunity is for a national-security or government
customer that AWS Partner Central treats as restricted. Submit Yes
for national-security workloads (which routes the opportunity through
AWS's restricted review path) and No otherwise.

Allowed:

customer

object

lifeCycle

object

marketing

object

opportunityType

string

enum

Allowed:

primaryNeedsFromAws

array of strings

primaryNeedsFromAws

project

object

softwareRevenue

object

solutions

array of strings

solutions

awsMarketplaceOffers

array of strings

Array of AWS Marketplace offer identifiers associated with the opportunity.

awsMarketplaceOffers

awsProducts

array of strings

Array of AWS product identifiers associated with the opportunity. These represent AWS services
or products that are part of the customer's solution (e.g., AmazonBedrock, AmazonS3, AmazonEC2Trn2).

awsProducts

dataMapper

object

Headers

tackle-operation-id

string

enum

required

Selects the operation to perform. The values acceptOpportunity and
rejectOpportunity are test-environment-only and return 400 Bad Request
for production vendors with the message
the requested operation is only supported in test or demo environments.

Responses

202

Accepted. The update request has been queued for asynchronous processing in AWS
Partner Central. The response body is empty; poll getOpportunity or
listOpportunityEvents to observe the result of the queued request.

401

Unauthorized. The request did not include valid Tackle MTM bearer credentials, or the
authenticated principal could not be resolved.

500

Internal Server Error. An unexpected error occurred while processing the request. Response
bodies for 5xx errors may be empty.

Language

Credentials

Bearer

MTM JWT

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

400Bad Request. The request was malformed or failed validation (for example, an invalid sortField/sortOrder value, an unsupported tackle-operation-id, or a request body that fails to parse as JSON).

404Not Found. No resource exists at the requested path for the authenticated vendor.

409Conflict. The request cannot be applied to the resource in its current state (for example, attempting updateDraftOpportunity on an opportunity that is no longer in draft state, or createOpportunity with a crmId that already maps to an existing co-sell opportunity).

423Locked. The request was rejected because the vendor is currently in a mid-reset state (for example, while the vendor's AWS Partner Central connection is being re-established). Retry the request once the vendor's reset has completed.