API Stock Agent API

The Agent API from API Stock — 45 operation(s) for agent.

GitHub OpenAPI

Operations 58

GET /api/v1/agent/visibility Get hidden-conversation permissions #
GET /api/v1/agent/settings Get saved model and budget preferences #
PUT /api/v1/agent/settings Update model and budget preferences with version checking #
GET /api/v1/agent/projects List projects with cursor pagination #
POST /api/v1/agent/projects Create a project #
POST /api/v1/agent/projects/{id}/assets/import Retain an artifact as a project asset #
GET /api/v1/agent/profiles List available agent profiles #
POST /api/v1/agent/projects/{id}/assets Request a project asset upload URL #
DELETE /api/v1/agent/attachments/{id} Revoke access to an attachment #
GET /api/v1/agent/attachments/{id} Get attachment metadata and availability #
GET /api/v1/agent/workflows List available workflows #
GET /api/v1/agent/workflows/{id} Get a workflow and its versioned definition #
GET /api/v1/agent/webhooks List registered lifecycle webhooks #
POST /api/v1/agent/webhooks Register a signed lifecycle webhook #
DELETE /api/v1/agent/webhooks/{id} Revoke a webhook and cancel pending deliveries #
GET /api/v1/agent/webhooks/{id}/deliveries List recent webhook delivery attempts #
GET /api/v1/agent/projects/{id} Get a project, version and assets #
PATCH /api/v1/agent/projects/{id} Update a project with version checking #
DELETE /api/v1/agent/projects/{id} Delete a project and stop its active runs #
GET /api/v1/agent/conversations/{id}/context-references List conversation context references #
PUT /api/v1/agent/conversations/{id}/context-references Replace conversation context references with version checking #
GET /api/v1/agent/runs/{id}/context/{referenceId} Read a context-reference snapshot #
GET /api/v1/agent/storage/files List retained files with cursor pagination #
DELETE /api/v1/agent/storage/files/{id} Revoke access to a retained file #
POST /api/v1/agent/storage/retain Request an idempotent retained copy of a file #
GET /api/v1/agent/storage/operations/{id} Get retained-copy operation status #
GET /api/v1/agent/models List agent models, capabilities and prices #
GET /api/v1/agent/conversations Search conversations with cursor pagination #
POST /api/v1/agent/conversations Create a conversation #
GET /api/v1/agent/conversations/{id} Get a conversation and queued messages #
PATCH /api/v1/agent/conversations/{id} Update conversation settings with version checking #
DELETE /api/v1/agent/conversations/{id} Delete a conversation and stop its active runs #
POST /api/v1/agent/conversations/{id}/read Advance the last-read message sequence #
GET /api/v1/agent/conversations/{id}/messages List earlier conversation messages by sequence #
POST /api/v1/agent/conversations/{id}/messages Start a billed run within an explicit micro-USD budget #
GET /api/v1/agent/conversations/{id}/event-history Replay conversation events after a sequence #
GET /api/v1/agent/conversations/{id}/events Stream conversation events with resumable SSE #
GET /api/v1/agent/runs/{id} Get a run, budget, steps and pending actions #
POST /api/v1/agent/runs/{id}/stop Request a run stop at the next safe boundary #
POST /api/v1/agent/runs/{id}/cancel-queued Cancel a queued run before execution #
POST /api/v1/agent/runs/{id}/resume Resume a run waiting for budget #
PATCH /api/v1/agent/runs/{id}/budget Update a run budget with version checking #
GET /api/v1/agent/storage/plans List current retained-storage plans #
GET /api/v1/agent/storage Get retained-storage usage and billing period #
POST /api/v1/agent/storage/quote Quote a retained-storage plan change without charging #
POST /api/v1/agent/storage/subscribe Apply an idempotent retained-storage plan change #
POST /api/v1/agent/storage/cancel-renewal Disable automatic retained-storage renewal #
POST /api/v1/agent/storage/enable-renewal Enable automatic retained-storage renewal #
POST /api/v1/agent/conversations/{id}/attachments Request a conversation attachment upload URL #
POST /api/v1/agent/attachments/{id}/complete Validate and complete an attachment upload #
GET /api/v1/agent/runs/{id}/costs Get run budget and per-step charges #
GET /api/v1/agent/runs/{id}/result Get sanitized run results and artifacts #
POST /api/v1/agent/runs/{id}/decisions Resolve a pending action idempotently #
GET /api/v1/agent/artifacts Search generated artifacts with cursor pagination #
GET /api/v1/agent/artifacts/{id} Get artifact metadata or an unavailable tombstone #
GET /api/v1/agent/artifacts/{id}/content Retrieve artifact media or redirect to its public URL #
GET /api/v1/agent/attachments List available uploaded attachments #
GET /api/v1/agent/attachments/{id}/content Retrieve attachment media or redirect to its public URL #

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/api-stock-com:api-stock-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.

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

OpenAPI Specification

api-stock-com-agent-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Stock Agent API
  description: ''
  version: '1.0'
  contact: {}
servers:
- url: https://api.api-stock.com
  description: Production
tags:


# --- truncated at 32 KB (271 KB total) ---
# Full source: https://artifacts.apis.io/api-stock-com/openapi/api-stock-com-agent-api-openapi.yml