IGNOREO Lockbox API

The Lockbox API from IGNOREO — 9 operation(s) for lockbox.

GitHub OpenAPI

Operations 9

POST /v1/lockbox/workspaces Lockbox: Create a workspace. #
POST /v1/lockbox/acquire Lockbox: Take a lock on a resource for ttl_seconds (default 300, max 3600) #
POST /v1/lockbox/renew Lockbox: Extend a lock you hold #
POST /v1/lockbox/release Lockbox: Release a lock you hold #
POST /v1/lockbox/status Lockbox: List current locks, state keys and the note count #
POST /v1/lockbox/get Lockbox: Read a shared value #
POST /v1/lockbox/set Lockbox: Write a shared value (pass if_version to refuse overwriting a change… #
POST /v1/lockbox/note Lockbox: Leave a handoff note #
POST /v1/lockbox/notes Lockbox: Read recent notes (optionally only those for one recipient) #

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/ignoreo-com:ignoreo-com-lockbox-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.

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

OpenAPI Specification

ignoreo-com-lockbox-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: IGNOREO Lockbox API
  version: 1.0.0
  description: Tools for AI agents. Paid operations are paid per call in USDC over x402 (v2); the free shelf (paths under /v1/free/) needs no payment. No accounts or API keys.
servers:
- url: https://ignoreo.com
tags:
- name: Lockbox
paths:
  /v1/lockbox/workspaces:
    post:
      operationId: lockbox.create
      summary: 'Lockbox: Create a workspace.'
      description: Price $0.01 per call, paid in USDC over x402 on Base. Call without payment to receive a 402 with the payment requirements in the PAYMENT-REQUIRED header.
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties: {}
            example: {}
      responses:
        '200':
          description: Success (payment settled)
          content:
            application/json:
              schema:
                type: object
                properties:
                  workspace_id:
                    type: string
                  workspace_secret:
                    type: string
              example:
                ok: true
                workspace_id: wsp_9f2c…
                workspace_secret: sec_41aa…
        '400':
          description: Bad request (not charged)
        '401':
          description: Wrong or missing workspace secret (not charged)
        '402':
          description: 'Payment required: see the PAYMENT-REQUIRED header'
      x-price-usd: '0.01'
      tags:
      - Lockbox
  /v1/lockbox/acquire:
    post:
      operationId: lockbox.acquire
      summary: 'Lockbox: Take a lock on a resource for ttl_seconds (default 300, max 3600)'
      description: Price $0.001 per call, paid in USDC over x402 on Base. Call without payment to receive a 402 with the payment requirements in the PAYMENT-REQUIRED header.
      parameters:
      - name: X-Workspace-Secret
        in: header
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - workspace_id
              - resource
              properties:
                workspace_id:
                  type: string
                request_id:
                  type: string
                  maxLength: 64
                  description: Your id for this operation. Reuse it when retrying.
                resource:
                  type: string
                  description: Any name, e.g. a file path
                ttl_seconds:
                  type: integer
                  description: 1-3600
                holder:
                  type: string
                  description: Label shown to others. Any label; never needs to be a real name
            example:
              workspace_id: wsp_9f2c…
              resource: …
      responses:
        '200':
          description: Success (payment settled)
          content:
            application/json:
              schema:
                type: object
              example:
                ok: true
                resource: src/app.js
                lock_id: lck_…
                expires_at: '2026-10-07T12:05:00.000Z'
        '400':
          description: Bad request (not charged)
        '401':
          description: Wrong or missing workspace secret (not charged)
        '402':
          description: 'Payment required: see the PAYMENT-REQUIRED header'
      x-price-usd: '0.001'
      tags:
      - Lockbox
  /v1/lockbox/renew:
    post:
      operationId: lockbox.renew
      summary: 'Lockbox: Extend a lock you hold'
      description: Price $0.001 per call, paid in USDC over x402 on Base. Call without payment to receive a 402 with the payment requirements in the PAYMENT-REQUIRED header.
      parameters:
      - name: X-Workspace-Secret
        in: header
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - workspace_id
              - resource
              - lock_id
              properties:
                workspace_id:
                  type: string
                request_id:
                  type: string
                  maxLength: 64
                  description: Your id for this operation. Reuse it when retrying.
                resource:
                  type: string
                lock_id:
                  type: string
                ttl_seconds:
                  type: integer
                  description: 1-3600
            example:
              workspace_id: wsp_9f2c…
              resource: …
              lock_id: …
      responses:
        '200':
          description: Success (payment settled)
          content:
            application/json:
              schema:
                type: object
              example:
                ok: true
                resource: src/app.js
                lock_id: lck_…
                expires_at: '2026-10-07T12:10:00.000Z'
        '400':
          description: Bad request (not charged)
        '401':
          description: Wrong or missing workspace secret (not charged)
        '402':
          description: 'Payment required: see the PAYMENT-REQUIRED header'
      x-price-usd: '0.001'
      tags:
      - Lockbox
  /v1/lockbox/release:
    post:
      operationId: lockbox.release
      summary: 'Lockbox: Release a lock you hold'
      description: Price $0.001 per call, paid in USDC over x402 on Base. Call without payment to receive a 402 with the payment requirements in the PAYMENT-REQUIRED header.
      parameters:
      - name: X-Workspace-Secret
        in: header
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - workspace_id
              - resource
              - lock_id
              properties:
                workspace_id:
                  type: string
                request_id:
                  type: string
                  maxLength: 64
                  description: Your id for this operation. Reuse it when retrying.
                resource:
                  type: string
                lock_id:
                  type: string
            example:
              workspace_id: wsp_9f2c…
              resource: …
              lock_id: …
      responses:
        '200':
          description: Success (payment settled)
          content:
            application/json:
              schema:
                type: object
              example:
                ok: true
                resource: src/app.js
                released: true
        '400':
          description: Bad request (not charged)
        '401':
          description: Wrong or missing workspace secret (not charged)
        '402':
          description: 'Payment required: see the PAYMENT-REQUIRED header'
      x-price-usd: '0.001'
      tags:
      - Lockbox
  /v1/lockbox/status:
    post:
      operationId: lockbox.status
      summary: 'Lockbox: List current locks, state keys and the note count'
      description: Price $0.001 per call, paid in USDC over x402 on Base. Call without payment to receive a 402 with the payment requirements in the PAYMENT-REQUIRED header.
      parameters:
      - name: X-Workspace-Secret
        in: header
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - workspace_id
              properties:
                workspace_id:
                  type: string
                request_id:
                  type: string
                  maxLength: 64
                  description: Your id for this operation. Reuse it when retrying.
            example:
              workspace_id: wsp_9f2c…
      responses:
        '200':
          description: Success (payment settled)
          content:
            application/json:
              schema:
                type: object
              example:
                ok: true
                locks:
                - resource: src/app.js
                  holder: builder-2
                  expires_at: …
                state_keys: []
                notes: 0
        '400':
          description: Bad request (not charged)
        '401':
          description: Wrong or missing workspace secret (not charged)
        '402':
          description: 'Payment required: see the PAYMENT-REQUIRED header'
      x-price-usd: '0.001'
      tags:
      - Lockbox
  /v1/lockbox/get:
    post:
      operationId: lockbox.get
      summary: 'Lockbox: Read a shared value'
      description: Price $0.001 per call, paid in USDC over x402 on Base. Call without payment to receive a 402 with the payment requirements in the PAYMENT-REQUIRED header.
      parameters:
      - name: X-Workspace-Secret
        in: header
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - workspace_id
              - key
              properties:
                workspace_id:
                  type: string
                request_id:
                  type: string
                  maxLength: 64
                  description: Your id for this operation. Reuse it when retrying.
                key:
                  type: string
            example:
              workspace_id: wsp_9f2c…
              key: …
      responses:
        '200':
          description: Success (payment settled)
          content:
            application/json:
              schema:
                type: object
              example:
                ok: true
                key: plan
                found: true
                value:
                  step: 3
                version: 4
        '400':
          description: Bad request (not charged)
        '401':
          description: Wrong or missing workspace secret (not charged)
        '402':
          description: 'Payment required: see the PAYMENT-REQUIRED header'
      x-price-usd: '0.001'
      tags:
      - Lockbox
  /v1/lockbox/set:
    post:
      operationId: lockbox.set
      summary: 'Lockbox: Write a shared value (pass if_version to refuse overwriting a change…'
      description: Price $0.001 per call, paid in USDC over x402 on Base. Call without payment to receive a 402 with the payment requirements in the PAYMENT-REQUIRED header.
      parameters:
      - name: X-Workspace-Secret
        in: header
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - workspace_id
              - key
              - value
              properties:
                workspace_id:
                  type: string
                request_id:
                  type: string
                  maxLength: 64
                  description: Your id for this operation. Reuse it when retrying.
                key:
                  type: string
                value:
                  description: Any JSON value, up to 16 KB
                if_version:
                  type: integer
                  description: Version you last read
            example:
              workspace_id: wsp_9f2c…
              key: …
              value: …
      responses:
        '200':
          description: Success (payment settled)
          content:
            application/json:
              schema:
                type: object
              example:
                ok: true
                key: plan
                version: 5
        '400':
          description: Bad request (not charged)
        '401':
          description: Wrong or missing workspace secret (not charged)
        '402':
          description: 'Payment required: see the PAYMENT-REQUIRED header'
      x-price-usd: '0.001'
      tags:
      - Lockbox
  /v1/lockbox/note:
    post:
      operationId: lockbox.note
      summary: 'Lockbox: Leave a handoff note'
      description: Price $0.001 per call, paid in USDC over x402 on Base. Call without payment to receive a 402 with the payment requirements in the PAYMENT-REQUIRED header.
      parameters:
      - name: X-Workspace-Secret
        in: header
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - workspace_id
              - text
              properties:
                workspace_id:
                  type: string
                request_id:
                  type: string
                  maxLength: 64
                  description: Your id for this operation. Reuse it when retrying.
                text:
                  type: string
                  description: Up to 4000 characters
                from:
                  type: string
                to:
                  type: string
            example:
              workspace_id: wsp_9f2c…
              text: …
      responses:
        '200':
          description: Success (payment settled)
          content:
            application/json:
              schema:
                type: object
              example:
                ok: true
                id: note_…
        '400':
          description: Bad request (not charged)
        '401':
          description: Wrong or missing workspace secret (not charged)
        '402':
          description: 'Payment required: see the PAYMENT-REQUIRED header'
      x-price-usd: '0.001'
      tags:
      - Lockbox
  /v1/lockbox/notes:
    post:
      operationId: lockbox.notes
      summary: 'Lockbox: Read recent notes (optionally only those for one recipient)'
      description: Price $0.001 per call, paid in USDC over x402 on Base. Call without payment to receive a 402 with the payment requirements in the PAYMENT-REQUIRED header.
      parameters:
      - name: X-Workspace-Secret
        in: header
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - workspace_id
              properties:
                workspace_id:
                  type: string
                request_id:
                  type: string
                  maxLength: 64
                  description: Your id for this operation. Reuse it when retrying.
                to:
                  type: string
                limit:
                  type: integer
                  description: 1-200
            example:
              workspace_id: wsp_9f2c…
      responses:
        '200':
          description: Success (payment settled)
          content:
            application/json:
              schema:
                type: object
              example:
                ok: true
                notes:
                - id: note_…
                  from: a
                  to: b
                  text: …
                  at: …
        '400':
          description: Bad request (not charged)
        '401':
          description: Wrong or missing workspace secret (not charged)
        '402':
          description: 'Payment required: see the PAYMENT-REQUIRED header'
      x-price-usd: '0.001'
      tags:
      - Lockbox