Skip to content

API Reference

This page provides comprehensive API documentation for integrating with Urwave.

All API requests require authentication using an API key.

  1. Log in to your Urwave account
  2. Navigate to Settings > API
  3. Generate a new API key
  4. Store it securely

Include your API key in the request header:

Terminal window
Authorization: Bearer YOUR_API_KEY

Retrieve a list of users.

Parameters:

  • limit (integer): Number of results to return
  • offset (integer): Pagination offset

Response:

{
"users": [
{
"id": "123",
"name": "John Doe",
"email": "john@example.com"
}
],
"total": 100
}

Create a new user.

Request Body:

{
"name": "Jane Doe",
"email": "jane@example.com",
"role": "user"
}

Retrieve all projects.

Create a new project.

API requests are limited to:

  • 1000 requests per hour for authenticated users
  • 100 requests per hour for unauthenticated requests

Configure webhooks to receive real-time notifications:

  1. Navigate to Settings > Webhooks
  2. Add your webhook URL
  3. Select events to subscribe to
  4. Save configuration

Common HTTP status codes:

  • 200 - Success
  • 400 - Bad Request
  • 401 - Unauthorized
  • 403 - Forbidden
  • 404 - Not Found
  • 429 - Too Many Requests
  • 500 - Internal Server Error

Official SDKs are available for:

  • JavaScript/TypeScript
  • Python
  • Ruby
  • PHP
  • Go

Visit our GitHub for SDK documentation and examples.