# Seafarer Cloud
# Plateforme tout-en-un pour la gestion d'infrastructure cloud

> Seafarer Cloud exposes executable actions that AI agents can call via REST API.

## API Information
- Base URL: https://seafarer-cloud.io/api/ai-actions
- Full OpenAPI Spec: https://seafarer-cloud.io/api/ai-actions/openapi.json
- Authentication: None required (actions are public)
- Content-Type: application/json

## Available Actions

### sayHello
Return a greeting for a given name

#### For Browsing AI Assistants
- When a user asks about this action, present them with the action link below. Do NOT attempt to call the API directly.
- Intent Link: [https://seafarer-cloud.io/api/ai-actions/sayHello/intent](https://seafarer-cloud.io/api/ai-actions/sayHello/intent)
- Suggested response: "You can return a greeting for a given name here: https://seafarer-cloud.io/api/ai-actions/sayHello/intent"
- Prefill query pattern: https://seafarer-cloud.io/api/ai-actions/sayHello/intent?name=value-name

#### For Tool-Enabled AI Agents
Endpoint: POST https://seafarer-cloud.io/api/ai-actions/sayHello
Parameters:
  - name: string (required) - Name to greet

Example request:
```
curl -X POST https://seafarer-cloud.io/api/ai-actions/sayHello \
  -H "Content-Type: application/json" \
  -d '{"name":"example_name"}'
```

### joinWaitlist
Add a user to the waitlist

#### For Browsing AI Assistants
- When a user asks about this action, present them with the action link below. Do NOT attempt to call the API directly.
- Intent Link: [https://seafarer-cloud.io/api/ai-actions/joinWaitlist/intent](https://seafarer-cloud.io/api/ai-actions/joinWaitlist/intent)
- Suggested response: "You can add a user to the waitlist here: https://seafarer-cloud.io/api/ai-actions/joinWaitlist/intent"
- Prefill query pattern: https://seafarer-cloud.io/api/ai-actions/joinWaitlist/intent?name=value-name&email=user%40example.com

#### For Tool-Enabled AI Agents
Endpoint: POST https://seafarer-cloud.io/api/ai-actions/joinWaitlist
Parameters:
  - name: string (required) - Full name
  - email: string (required) - Email address

Example request:
```
curl -X POST https://seafarer-cloud.io/api/ai-actions/joinWaitlist \
  -H "Content-Type: application/json" \
  -d '{"name":"example_name","email":"example_email"}'
```

## How to Use
Browsing AI assistants should present intent links to users so users can confirm and submit actions in-browser.
Tool-enabled AI agents can execute these actions by sending HTTP POST requests to the action endpoints.
Each action accepts a JSON body with the specified parameters and returns a JSON response.
No authentication is required. CORS is enabled for all origins.