# API

In the Marketplace edition you call your Agent from your own application with the Chat API (SSE). Conversation history, file management, artifact retrieval, search and project operations are also available as REST APIs. MCP-capable AI clients (such as Claude Code and Codex) can connect with MCP. External agents that support A2A can call registered Agents and published workflows with A2A.

## Getting started

There are two ways to use the API. What you prepare differs ([API Setup Guide](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/marketplace/api/guide/setup-guide.md)).

| Usage              | Who uses it                                              | Getting started                                                                                                                                                                                                                                                                                                 |
| ------------------ | -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| System integration | Your company's systems                                   | Create a service account in the admin console, then follow [Call the API](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/marketplace/api/quickstart/call-api.md) to send your first request                                                                                                           |
| Application        | Employees (from external tools, with their own accounts) | After an administrator opens the entrance for sign-in from an external tool and creates an external tool client in the authorization server console, connect by following [AI Client Connection Guide (MCP)](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/marketplace/api/guide/ai-client-guide.md) |

## Guides and references

- [API Setup Guide](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/marketplace/api/guide/setup-guide.md) — creating external tool clients and service accounts
- [Authentication Guide](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/marketplace/api/guide/auth-guide.md) — obtaining tokens
- [Connection Methods Guide](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/marketplace/api/guide/connection-guide.md) — choosing among the Chat API, MCP, and A2A
- [Streaming Guide](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/marketplace/api/guide/streaming-guide.md) — SSE lifecycle, response objects, and event handling
- [Project API Guide](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/marketplace/api/guide/project-api-guide.md) — finding and fixing executions that did not go well
- [AI Client Connection Guide (MCP)](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/marketplace/api/guide/ai-client-guide.md) — connecting from AI clients such as Claude Code (plugin, people, system integrations)
- [User API Reference (Conversations, Organizations)](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/marketplace/api/reference/user-api-reference.md) and [User API Reference (Projects)](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/marketplace/api/reference/user-api-reference-projects.md) — specification of the endpoints called with an application token
- [System Integration API Reference](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/marketplace/api/reference/api-reference.md) — specification of the endpoints called with a system integration token
- [Authentication API Reference](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/marketplace/api/reference/auth-mp-ref.md) — token retrieval specification
- [MCP API Reference](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/marketplace/api/reference/mcp-ref.md) — specification of the MCP tools
- [A2A API Reference](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/marketplace/api/reference/a2a-ref.md) — specification of the A2A endpoints

> **Differences from the SaaS edition**
>
> The LLM Gateway — as well as the Library, Library Agent, Skills, Playbooks, Persona, master data (organizations and job types) management, User Management, Logs and Shared Memory APIs — are published as SaaS edition APIs. The list of registered agents used in chat (`GET /v1/marketplace-agents`) is also available in the Marketplace edition. See [SaaS > API](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/api.md) for those.
