---
title: "Invoke a catalog API capability with POST"
method: POST
path: "/v1/api/{vendor}/{upstream_path}"
tags: ["Models"]
---

# Invoke a catalog API capability with POST

`POST /v1/api/{vendor}/{upstream_path}`

## Request

- Base URL: `https://api.sandbase.ai`
- URL: `https://api.sandbase.ai/v1/api/{vendor}/{upstream_path}`
- Auth: HTTP bearer

Resolves the enabled catalog model named vendor/upstream_path and executes a JSON object through the unified pipeline. When model is omitted, the URL-derived capability name is injected. A supplied model field is preserved and remains authoritative.

## Request body

- object

## Response `200`

Capability-specific synchronous response

- unknown

## Other responses

- `202`: Capability accepted for asynchronous execution
- `400`: Body is not a JSON object or capability input is invalid
- `401`: Missing or invalid API key
- `402`: Insufficient balance or spending limit reached
- `403`: API key or capability access is forbidden
- `404`: No enabled catalog capability matches the vendor and path
- `500`: Internal execution error
- `502`: Upstream provider returned an invalid response
- `503`: No provider is currently available

---

[API](https://skmtc.dev/sandbase/apis/sandbase-api.md) · [All operations](https://skmtc.dev/sandbase/apis/sandbase-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sandbase/apis/sandbase-api/revisions/d40df2467ba2?raw)