REST API

The REST API lets you build custom integrations, automate workflows, and embed Sempleo capabilities in your own applications.

Prerequisites

• Sempleo workspace on Starter plan or above
• API key generated in Settings → API Keys

Getting Started

1. Generate an API Key

1. Go to Settings → API Keys
2. Click Create Key
3. Name your key and select permissions
4. Copy the key (it won't be shown again)

2. Make Your First Request

curl -H "Authorization: Bearer sk_live_your_api_key" \
  https://api.sempleo.ai/api/v1/agents

3. Run an Agent

curl -X POST \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Summarize recent industry trends"}' \
  https://api.sempleo.ai/api/v1/agents/{agent-id}/run

Common Use Cases

Embedding Agent Conversations

Build a custom UI that talks to Sempleo agents:

1. List available agents with GET /agents
2. Start a conversation with POST /agents/:id/run
3. Display the result in your application

Automating Knowledge Updates

Programmatically upload documents:

curl -X POST \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -F "file=@report.pdf" \
  -F "collectionId=collection-uuid" \
  https://api.sempleo.ai/api/v1/knowledge/documents

Building Integrations

Use the API to build custom connectors that Sempleo doesn't natively support:

1. Fetch data from your system
2. Upload as knowledge documents
3. Trigger agents to process the data
4. Retrieve results

Rate Limits

Full API Reference

See the complete API Reference for all available endpoints, request/response schemas, and authentication details.