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 Invitations API

Create (test-environment-only), read, update, and list co-sellinvitations — AWS-led requests to partner with you on a specificopportunity. Use the update operation to accept or reject aninvitation, and the history endpoint to inspect cloud-side detail.

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

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

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

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

5 operations 3 paths 11 schemas 3 GET2 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, HTTP Basic, API Key, OAuth 2.0
Resource Areas
1

Authentication & Security 4

Tackle Invitations API declares 4 security schemes for authenticating requests. It accepts HTTP bearer tokens (JWT) (BearerAuth). It accepts HTTP basic authentication (BasicAuthCallback). An API key is passed in the header as subscription-key (HeaderApiKeyAuthCallback). It supports OAuth 2.0 (Oauth2AuthCallback) using the clientCredentials flow.

  • BearerAuth — The Tackle API requires a JWT for authentication. You can get this by [getting your API credentials](https://developers.tackle.io/docs/how-to-get-an-m2m-client…
  • BasicAuthCallback — Use basic for [basic HTTP authentication](https://en.wikipedia.org/wiki/Basicaccessauthentication); this is only used for callbacks
  • HeaderApiKeyAuthCallback — Use headerapikey to specify a custom HTTP request header for authentication. Requests from Tackle will use the specified HTTP header for outbound requests to y…
  • Oauth2AuthCallback — This auth-type is for oauth2 client credentials flow. We will use the clientid and clientsecret to call the tokenurl to get an access token; this is only used…

Paths & Operations 5

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

Invitations 5

Create (test-environment-only), read, update, and list co-sell invitations — AWS-led requests to partner with you on a specific opportunity. Use the update operation to accept or…

GET
/api/invitations/{invitation_id}/events
List invitation events
listInvitationEvents 2 params → 200401500
GET
/api/invitations
List co-sell invitations
listInvitations 17 params → 200400401500
POST
/api/invitations
Create a co-sell invitation (test-environment-only)
createInvitation 1 param body → 200400401403500
GET
/api/invitations/{invitation_id}
Get a co-sell invitation
getInvitation 1 param → 200401404500
POST
/api/invitations/{invitation_id}
Update a co-sell invitation
updateInvitation 2 params body → 202400401404423500

Schemas 11

The contract defines 11 schemas that model the data the API accepts and returns. The most detailed are ListInvitationsResponseItem (19 properties), InvitationResponse (15 properties), ListInvitationEvents (8 properties), CreateInvitationRequest (6 properties). Each schema is shown below with its type and property counts.

OpportunityInvitationPayload
object
4 properties
InvitationResponse
object
15 properties
ListInvitationEvents
object
8 properties 3 required
ListInvitationsResponse
object
5 properties
InvitationProject
object
4 properties
InvitationReceiver
object
2 properties
InvitationMetadata
object
5 properties
InvitationCustomer
object
4 properties
CreateInvitationRequest
object
Request body for createInvitation (test-environment-only). The required fields are the values consumed when constructing the simulated invitation; other fields…
6 properties 2 required
Error
object
Error envelope returned for typed error responses. Some 4xx and 5xx responses (such as direct Unauthorized and Internal Server Error responses) may instead ret…
1 property
ListInvitationsResponseItem
object
19 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

tackle-invitations-api-openapi.yml Raw ↑

Other APIs Tackle publishes across the network.

Tackle Authentication API
Tackle Contracts API
Tackle Currencies API
Tackle Disbursements API
Tackle Entitlements API
Tackle Groups API
Tackle Invoices API
Tackle Marketplace API
Tackle Metering API
Tackle Notifications API
Tackle Opportunities API
Tackle Partners API