API Documentation

Programmatic access to manage your PrinSoft Cloud instances.

Authentication

All API requests require your organization's API key in the header:

curl -H "Authorization: Bearer YOUR_API_KEY" https://prinsoft.cloud/api/...

Returns platform health status

Response:

{"status": "healthy", "database": "ok"}

Get real-time status of an instance

Response:

{"db_status": "running", "service_status": "active"}

Get recent logs for an instance

Response:

{"logs": "...", "status": "running"}

Start a stopped instance

Response:

{"message": "Instance started"}

Stop a running instance

Response:

{"message": "Instance stopped"}

Restart an instance

Response:

{"message": "Instance restarted"}

Create a manual backup

Response:

{"message": "Backup started", "backup_id": 1}

Create a copy of an instance

Response:

{"message": "Clone deployment started", "instance_id": 2}

Permanently delete an instance

Response:

{"message": "Instance deleted"}

Returns all plan pricing

Response:

{"odoo": {"standard": {"monthly": 99}}}

Configure a webhook URL in your profile to receive real-time notifications.

instance.deployed Instance deployment completed

instance.stopped Instance was stopped

payment.received Payment confirmed

backup.completed Backup finished

Webhooks include an X-PrinSoft-Signature header (HMAC-SHA256 signed with your API key).