API Documentation

Overview

The Rumlin API provides programmatic access to upload audio files for transcription and analysis. All endpoints return JSON responses and use standard HTTP status codes.

Base URL

https://rumlin.io

What You Can Do

• Upload audio files for transcription and analysis
• Assign uploads to specific spaces and agents

Authentication

The Rumlin API supports Bearer token authentication using API keys. You can obtain an API key from your organisation settings in the Rumlin dashboard.

API Key Authentication

Include your API key in the Authorization header of your requests:

curl -X POST https://rumlin.io/api/upload \ -H "Authorization: Bearer YOUR_API_KEY" \ -F "[email protected]"

Security Best Practices

• Never expose your API key in client-side code
• Use HTTPS for all API requests
• Rotate your API keys regularly
• Monitor API key usage in your dashboard

Upload Endpoint

POST /api/upload

Upload Audio File

Upload one or more audio files for transcription and analysis. Files are processed asynchronously.

Request Parameters

Parameter	Type	Required	Description
`files`	File(s)	Required	Audio file(s) to upload. Supported formats: MP3, WAV, MP4, M4A, FLAC
`space_id`	String	Optional	UUID of the space to assign the transcript to
`agent_id`	String	Optional	UUID of the agent to assign the transcript to
`custom_name`	String	Optional	Custom name for the transcript

Example Request

curl -X POST https://rumlin.io/api/upload \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "files=@meeting_recording.mp3" \
  -F "space_id=123e4567-e89b-12d3-a456-426614174000" \
  -F "custom_name=Sales Call - Acme Corp"
                    

Example Response

{
  "success": true,
  "message": "1 file(s) uploaded successfully",
  "upload_ids": [
    {
      "filename": "meeting_recording.mp3",
      "upload_id": "456e7890-e89b-12d3-a456-426614174001"
    }
  ],
  "queue_positions": [1]
}
                        

Error Handling

The API uses standard HTTP status codes to indicate success or failure. Error responses include a JSON object with an error message.

HTTP Status Codes

Status Code	Description
`200`	OK - Request successful
`400`	Bad Request - Invalid request parameters
`401`	Unauthorized - Invalid or missing API key
`404`	Not Found - Resource not found
`429`	Too Many Requests - Rate limit exceeded
`500`	Internal Server Error - Server error

Error Response Format

{
  "error": "Invalid API key",
  "code": "INVALID_API_KEY"
}
                