Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Kin Lane

Chat with Kin

AI assistant · trained on my blog

Tackle.io

Tackle.io Private Offers API

AWS private-offer lifecycle (create, read, update, cancel, push to marketplace).

Documentation Provider Profile APIs.io OpenAPI GitHub

Tackle.io Private Offers API is one of 28 APIs that Tackle.io publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Private Offers. The published artifact set on APIs.io includes an OpenAPI specification and an API reference.

This API exposes 11 operations across 6 paths, and defines 66 schemas. It is described by OpenAPI 3.0.3, at version 1.0.0.

Requests are made against a single base URL, https://contracts.tackle.io.

11 operations 6 paths 66 schemas 1 DELETE4 GET5 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0.0
Base URL
https://api.tackle.io
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Tackle.io Private Offers API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (tackleJwt). By default, every request must be authenticated.

  • tackleJwt — Tackle-issued JWT (interactive user or MTM token).

Paths & Operations 11

Across 6 paths, the API surfaces 11 operations — 1 DELETE, 4 GET, 5 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Private Offers 11

AWS private-offer lifecycle (create, read, update, cancel, push to marketplace).

GET
/private-offers
List Private Offers
listPrivateOffers 11 params → 200400401403500
POST
/private-offers
Create Private Offer
createPrivateOffer body → 200201400401403500
GET
/private-offers/{id}
Get Private Offer
getPrivateOffer 1 param → 200401403404
PUT
/private-offers/{id}
Update Private Offer
updatePrivateOffer 1 param body → 200400401403404
DELETE
/private-offers/{id}
Delete Private Offer
deletePrivateOffer 1 param → 204401403404
POST
/private-offers/{id}/cancel
Cancel Private Offer
cancelPrivateOffer 1 param → 200400401403404409
POST
/private-offers/{id}/marketplace-create
Push Private Offer to AWS Marketplace
marketplaceCreatePrivateOffer 1 param body → 200201400401403404409
POST
/api/private-offers/{id}
Update a Microsoft offer
updatePrivateOffer 2 params body → 200400401403404500
GET
/api/private-offers/{id}
Get an offer
getPrivateOffer 2 params → 200401403404500
POST
/api/private-offers
Create or import a Microsoft offer
createPrivateOffer 1 param body → 200400401403500
GET
/api/private-offers
List offers
listPrivateOffers 3 params → 200401403500

Schemas 66

The contract defines 66 schemas that model the data the API accepts and returns. The most detailed are PrivateOffer_2 (63 properties), PrivateOffer (40 properties), CreateOffer (29 properties), UpdateOffer (24 properties). Each schema is shown below with its type and property counts.

UpdateUserToNotify
object
3 properties
Salesforce
object
3 properties
Pricing
object
Pricing configuration for an offer. Used for all cloud marketplaces, offer types, and product types. Many fields are conditional on paymentmodel and billingter…
19 properties
EULA_2
object
4 properties
UpdateContractDuration
object
2 properties
Error
object
Error response. Endpoints in the Private Offers and Marketplace tags return the error in a message field. The Partners endpoint returns the error in an error f…
2 properties
OfferStateValue
string
StartOn
string
ScheduleDetail
object
3 properties
ScheduledPayment
object
2 properties
PreRegistrationDetails
object
2 properties
ExtraData
object
1 property
PrivateOfferList
object
Paginated list of private offers.
4 properties 4 required
UserLimits
object
2 properties
PrivateOfferActivityUser
object
4 properties
OfferStatus
string
Controls the offer workflow. Use draftstatus to save the offer in Tackle only. Use submittocloud to validate the offer and prepare it for Microsoft marketplace…
Buyer
object
3 properties 1 required
OfferPricing
object
10 properties
PlanTemplate
object
2 properties
OfferType
string
PricingUnit
object
AMI-only pricing unit.
3 properties
UpdateDimension
object
5 properties
CreatePrivateOfferRequest
object
Request body for creating or updating a private offer. The wrapper controls how the request is processed; the privateoffer field carries the offer payload. For…
5 properties 4 required
PrivateOfferState
object
5 properties
PaymentModel
string
UserToNotify
object
5 properties
Buyer_2
object
3 properties
ExtraDataUser
object
1 property 1 required
PartnerOffer
object
Details about a partner (resale) offer. Only set when offertype is partnerresale.
7 properties
PrivateOfferActivity
object
5 properties
Source
string
UpdateOffer
object
Partial request body for updating a Microsoft SaaS private offer.
24 properties
UsageDimension
object
4 properties
UpdateOfferPricing
object
9 properties
UpdateBuyerDetails
object
3 properties
ProductType
string
Partner
object
2 properties
ErrorResponse
object
1 property 1 required
PaymentSchedule
object
2 properties
Activity
object
5 properties
MsftResponse
object
4 properties
InitialCharge
object
2 properties
CreatePrivateOfferResponse
object
2 properties 2 required
CreateSalesforce
object
2 properties
PrivateOfferStateDetail
object
1 property
CreateUserToNotify
object
3 properties
Clone
object
2 properties
MarketplaceCreatePrivateOfferRequest
object
Request body for promoting an existing Tackle draft offer into AWS Marketplace. Only the wrapper options are accepted; the offer payload is taken from the exis…
2 properties 2 required
DimensionQuantity
object
3 properties
PaymentInstallment
object
1 property
PricingDimension
object
6 properties
PrivateOffer
object
Represents a private offer for any cloud marketplace and product type. Field shapes are backward-compatible with the privateoffermetadata object documented in…
40 properties 7 required
PricingType
string
UpdatePaymentInstallment
object
1 property
Dimension
object
5 properties
PositiveTargeting
object
Positive targeting constraints (currently country allow-lists).
1 property
ContractDuration
object
2 properties
ResellerAgreement
object
3 properties 1 required
PrivateOfferError
object
3 properties
EULA
object
EULA configuration for the offer.
3 properties
BuyerDetails
object
3 properties
UpdateSalesforce
object
2 properties
PrivateOfferSalesforce
object
3 properties
PrivateOffer_2
object
Stored Tackle Microsoft private offer.
63 properties
CreateOffer
object
Request body for creating a Microsoft SaaS private offer.
29 properties
ImportMicrosoftOfferRequest
object
3 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

tackleio-private-offers-api-openapi.yml Raw ↑

Other APIs Tackle.io publishes across the network.

Tackle.io Authentication API
AE Profile APIs.io
Tackle.io Contracts API
AE Profile APIs.io
Tackle.io Currencies API
AE Profile APIs.io
Tackle.io Customers API
AE Profile APIs.io
Tackle.io Disbursements API
AE Profile APIs.io
Tackle.io Entitlements API
AE Profile APIs.io
Tackle.io Groups API
AE Profile APIs.io
Tackle.io Invitations API
AE Profile APIs.io
Tackle.io Invoices API
AE Profile APIs.io
Tackle.io Marketplace API
AE Profile APIs.io
Tackle.io Metering API
AE Profile APIs.io
Tackle.io Notifications API
AE Profile APIs.io
#Private Offers
← Back to T APIs
API Details
ID
tackleio:tackleio-private-offers-api
Base URL
https://api.tackle.io
Docs
https://developers.tackle.io/reference/v1-get-version
Provider
Tackle.io
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network