Scope3

Scope3 Storefront Proposals API

The Storefront Proposals API from Scope3 — 3 operation(s) for storefront proposals.

GitHub OpenAPI

Operations 5

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /proposals Create a shareable proposal code for a buyer · Create storefront proposal #
Ask an LLM
“Can I package discovered products into a code a buyer can redeem?”
“Does a storefront proposal have to have an expiry date?”
Tell an agent
Create proposal {label} for operator {operator_id} from discovery {discovery_id} and proposal {proposal_id}, expiring {expires_at}.
Mint a proposal code for buyer {operator_id} labelled {label} with notes {notes}, using discovery {discovery_id}, proposal {proposal_id}, expiring {expires_at}.
GET /proposals List my storefront proposals · List storefront proposals #
Ask an LLM
“Which proposals has my storefront shared with buyers?”
“Can I filter my proposals by status or by the buyer they were made for?”
Tell an agent
List my storefront proposals.
Show {status} proposals for buyer operator {operator_id}.
GET /proposals/{id} View a storefront proposal · Get storefront proposal #
Ask an LLM
“What products did I include in a proposal I sent a buyer?”
“Can I see the saved discovery response behind one proposal?”
Tell an agent
Show storefront proposal {id}.
Get the saved discovery details for proposal {id}.
PATCH /proposals/{id} Change a proposal's label, notes or expiry · Update storefront proposal #
Ask an LLM
“Can I extend the expiry date on a proposal I already shared?”
“What can I edit on an existing storefront proposal?”
Tell an agent
Extend proposal {id} to expire at {expires_at}.
Rename proposal {id} to {label} and set its notes to {notes}.
POST /proposals/{id}/revoke Revoke a storefront proposal · Revoke storefront proposal #
Ask an LLM
“How do I stop a buyer from redeeming a proposal code?”
“Can I revoke a proposal that has already expired?”
Tell an agent destructive · confirm first
Revoke storefront proposal {id}.
Cancel proposal {id} so its code can no longer be redeemed.

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/scope3/refs/heads/main/openapi/scope3-storefront-proposals-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/scope3:scope3-storefront-proposals-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

scope3-storefront-proposals-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Scope3 Storefront Storefront Proposals API
  version: 2.0.0
  description: 'REST API for partners to manage storefronts, inventory sources, and billing.


    ## Authentication


    All endpoints require a Bearer token in the Authorization header:

    ```

    Authorization: Bearer your-api-key

    ```


    ## Base URL


    `https://api.interchange.io/api/v2/storefront`


    ## For AI Agents


    AI agents can use the MCP endpoint at `/mcp/v2/storefront` with three tools:

    - `initialize`: Start an MCP session

    - `api_call`: Make REST API calls

    - `ask_about_capability`: Learn about API features'
servers:
- url: https://api.interchange.io/api/v2/storefront
  description: Production server
tags:


# --- truncated at 32 KB (73 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/scope3/refs/heads/main/openapi/scope3-storefront-proposals-api-openapi.yml