Vigil

Vigil Agent API

The Agent API from Vigil — 13 operation(s) for agent.

GitHub OpenAPI

Operations 15

GET /agent/site.json Site identity and every discovery link #
GET /agent/search Search the sitemap for pages by words in the URL path #
GET /agent/read Read one page on this host as Markdown or stripped text #
GET /agent/commerce/products Everything agents can buy here, with Stripe-verified prices and live… #
POST /agent/commerce/ucp/checkout-sessions UCP: create a checkout session for one offer (answers requires_escalation with… #
GET /agent/commerce/ucp/checkout-sessions/{id} UCP: read a checkout session #
PUT /agent/commerce/ucp/checkout-sessions/{id} UCP: replace the line item #
POST /agent/commerce/ucp/checkout-sessions/{id}/complete UCP: payment is not taken here; returns the session with its continue_url #
POST /agent/commerce/ucp/checkout-sessions/{id}/cancel UCP: cancel a checkout session #
POST /agent/commerce/acp/checkout_sessions ACP: create a checkout session for one offer (answers requires_escalation with… #
GET /agent/commerce/acp/checkout_sessions/{checkout_session_id} ACP: read a checkout session #
POST /agent/commerce/acp/checkout_sessions/{checkout_session_id} ACP: update the line item #
POST /agent/commerce/acp/checkout_sessions/{checkout_session_id}/complete ACP: delegated payment is not accepted; returns the session with its… #
POST /agent/commerce/acp/checkout_sessions/{checkout_session_id}/cancel ACP: cancel a checkout session #
GET /agent/commerce/continue/{checkout_id} Buyer handoff: 303 redirect to this store's checkout for the session #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/blvigil-com/openapi/blvigil-com-agent-api-openapi.yml

Other Resources

🔗
APIsJSON
https://artifacts.apis.io/blvigil-com/apis.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/blvigil-com:blvigil-com-agent-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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

blvigil-com-agent-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Vigil Agent API
  version: 2026.09.15
  description: 'Public endpoints for agents on blvigil.com, including checkout: UCP and ACP sessions answer requires_escalation with a continue_url where the buyer pays on the Stripe-hosted checkout page. No credentials; rate limited per client. Registration statement: https://blvigil.com/auth.md.'
  contact:
    url: https://blvigil.com/support
servers:
- url: https://blvigil.com
tags:
- name: Agent
paths:
  /agent/site.json:
    get:
      operationId: siteInfo
      summary: Site identity and every discovery link
      responses:
        '200':
          description: Site info
          content:
            application/json:
              schema:
                type: object
      tags:
      - Agent
  /agent/search:
    get:
      operationId: searchPages
      summary: Search the sitemap for pages by words in the URL path
      parameters:
      - name: q
        in: query
        required: true
        schema:
          type: string
      - name: limit
        in: query
        schema:
          type: integer
          minimum: 1
          maximum: 50
          default: 20
      responses:
        '200':
          description: Matching pages
          content:
            application/json:
              schema:
                type: object
                properties:
                  query:
                    type: string
                  count:
                    type: integer
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        url:
                          type: string
                        score:
                          type: integer
      tags:
      - Agent
  /agent/read:
    get:
      operationId: readPage
      summary: Read one page on this host as Markdown or stripped text
      parameters:
      - name: url
        in: query
        required: true
        schema:
          type: string
          format: uri
      responses:
        '200':
          description: Page content
          content:
            application/json:
              schema:
                type: object
                properties:
                  url:
                    type: string
                  status:
                    type: integer
                  format:
                    type: string
                    enum:
                    - markdown
                    - text
                  content:
                    type: string
                  truncated:
                    type: boolean
      tags:
      - Agent
  /agent/commerce/products:
    get:
      operationId: listProducts
      summary: Everything agents can buy here, with Stripe-verified prices and live…
      responses:
        '200':
          description: Catalog
          content:
            application/json:
              schema:
                type: object
      tags:
      - Agent
  /agent/commerce/ucp/checkout-sessions:
    post:
      operationId: ucpCreateCheckout
      summary: 'UCP: create a checkout session for one offer (answers requires_escalation with…'
      parameters:
      - name: Idempotency-Key
        in: header
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
            example:
              line_items:
              - item:
                  id: vigil-mac
                quantity: 1
      responses:
        '201':
          description: Checkout session
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Unknown item or invalid quantity
      tags:
      - Agent
  /agent/commerce/ucp/checkout-sessions/{id}:
    get:
      operationId: ucpGetCheckout
      summary: 'UCP: read a checkout session'
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Checkout session
          content:
            application/json:
              schema:
                type: object
      tags:
      - Agent
    put:
      operationId: ucpUpdateCheckout
      summary: 'UCP: replace the line item'
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
            example:
              line_items:
              - item:
                  id: vigil-mac
                quantity: 1
      responses:
        '200':
          description: Checkout session
          content:
            application/json:
              schema:
                type: object
      tags:
      - Agent
  /agent/commerce/ucp/checkout-sessions/{id}/complete:
    post:
      operationId: ucpCompleteCheckout
      summary: 'UCP: payment is not taken here; returns the session with its continue_url'
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Checkout session
          content:
            application/json:
              schema:
                type: object
      tags:
      - Agent
  /agent/commerce/ucp/checkout-sessions/{id}/cancel:
    post:
      operationId: ucpCancelCheckout
      summary: 'UCP: cancel a checkout session'
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Checkout session
          content:
            application/json:
              schema:
                type: object
      tags:
      - Agent
  /agent/commerce/acp/checkout_sessions:
    post:
      operationId: acpCreateCheckoutSession
      summary: 'ACP: create a checkout session for one offer (answers requires_escalation with…'
      parameters:
      - name: Idempotency-Key
        in: header
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
            example:
              line_items:
              - id: vigil-mac
      responses:
        '201':
          description: Checkout session
          content:
            application/json:
              schema:
                type: object
        '400':
          description: invalid_request
      tags:
      - Agent
  /agent/commerce/acp/checkout_sessions/{checkout_session_id}:
    get:
      operationId: acpGetCheckoutSession
      summary: 'ACP: read a checkout session'
      parameters:
      - name: checkout_session_id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Checkout session
          content:
            application/json:
              schema:
                type: object
      tags:
      - Agent
    post:
      operationId: acpUpdateCheckoutSession
      summary: 'ACP: update the line item'
      parameters:
      - name: checkout_session_id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
            example:
              line_items:
              - id: vigil-mac
      responses:
        '200':
          description: Checkout session
          content:
            application/json:
              schema:
                type: object
      tags:
      - Agent
  /agent/commerce/acp/checkout_sessions/{checkout_session_id}/complete:
    post:
      operationId: acpCompleteCheckoutSession
      summary: 'ACP: delegated payment is not accepted; returns the session with its…'
      parameters:
      - name: checkout_session_id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Checkout session
          content:
            application/json:
              schema:
                type: object
      tags:
      - Agent
  /agent/commerce/acp/checkout_sessions/{checkout_session_id}/cancel:
    post:
      operationId: acpCancelCheckoutSession
      summary: 'ACP: cancel a checkout session'
      parameters:
      - name: checkout_session_id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Checkout session
          content:
            application/json:
              schema:
                type: object
      tags:
      - Agent
  /agent/commerce/continue/{checkout_id}:
    get:
      operationId: continueCheckout
      summary: 'Buyer handoff: 303 redirect to this store''s checkout for the session'
      parameters:
      - name: checkout_id
        in: path
        required: true
        schema:
          type: string
      responses:
        '303':
          description: Redirect to checkout
        '404':
          description: Unknown session
        '409':
          description: Offer not currently sold
        '410':
          description: Canceled or expired
      tags:
      - Agent