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

Tackle.io Private Offer Actions API

Private offer lifecycle actions such as archive, cancel, and sync.

Tackle.io Private Offer Actions 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 Offer Actions. The published artifact set on APIs.io includes an OpenAPI specification and an API reference.

This API exposes 4 operations across 4 paths, and defines 34 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.

4 operations 4 paths 34 schemas 4 POST

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 Offer Actions 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 4

Across 4 paths, the API surfaces 4 operations — 4 POST. Each is listed below with its method, path, parameters, and response codes.

Private Offer Actions 4

Private offer lifecycle actions such as archive, cancel, and sync.

POST
/api/private-offers/{id}/archive
Archive an offer
archivePrivateOffer 2 params → 200400401403404500
POST
/api/private-offers/{id}/unarchive
Unarchive an offer
unarchivePrivateOffer 2 params → 200400401403404500
POST
/api/private-offers/{id}/cancel
Cancel an offer
cancelPrivateOffer 2 params → 200400401403404500
POST
/api/private-offers/{id}/sync
Sync an offer from Microsoft
syncPrivateOffer 3 params → 200400401403404500

Schemas 34

The contract defines 34 schemas that model the data the API accepts and returns. The most detailed are PrivateOffer (63 properties), OfferPricing (10 properties), PrivateOfferActivity (5 properties), Dimension (5 properties). Each schema is shown below with its type and property counts.

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
OfferPricing
object
10 properties
PricingType
string
Dimension
object
5 properties
PlanTemplate
object
2 properties
ProductType
string
OfferType
string
Partner
object
2 properties
OfferStateValue
string
StartOn
string
ErrorResponse
object
1 property 1 required
PrivateOfferState
object
5 properties
PaymentSchedule
object
2 properties
ScheduleDetail
object
3 properties
PaymentModel
string
ContractDuration
object
2 properties
MsftResponse
object
4 properties
PreRegistrationDetails
object
2 properties
InitialCharge
object
2 properties
UserToNotify
object
5 properties
PrivateOfferStateDetail
object
1 property
Clone
object
2 properties
PrivateOfferActivity
object
5 properties
PrivateOfferError
object
3 properties
EULA
object
4 properties
BuyerDetails
object
3 properties
PrivateOfferSalesforce
object
3 properties
UserLimits
object
2 properties
PrivateOfferActivityUser
object
4 properties
Source
string
DimensionQuantity
object
3 properties
PaymentInstallment
object
1 property
PrivateOffer
object
Stored Tackle Microsoft private offer.
63 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

tackleio-private-offer-actions-api-openapi.yml Raw ↑

Other APIs Tackle.io publishes across the network.

Tackle.io Authentication API
Tackle.io Contracts API
Tackle.io Currencies API
Tackle.io Customers API
Tackle.io Disbursements API
Tackle.io Entitlements API
Tackle.io Groups API
Tackle.io Invitations API
Tackle.io Invoices API
Tackle.io Marketplace API
Tackle.io Metering API
Tackle.io Notifications API