Documentation Index
Fetch the complete documentation index at: https://docs.msgflash.com/llms.txt
Use this file to discover all available pages before exploring further.
Endpoint
Authentication: x-api-key: <api_key>
Statuses require the Starter plan or higher.
Parameters
Body
| Field | Type | Required | Description |
|---|
instanceId | UUID | yes | Instance source |
type | text | image | yes | Status type |
content | string | yes | Texte ou URL publique de l’image |
caption | string | no | Légende si image |
backgroundColor | string | no | Color hex si texte |
Status texte
curl -X POST https://srv.msgflash.com/api/v1/statuses \
-H "x-api-key: msgf_live_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"instanceId": "YOUR_INSTANCE_ID",
"type": "text",
"content": "Nouvelle collection disponible.",
"backgroundColor": "#00a884"
}'
Status image
curl -X POST https://srv.msgflash.com/api/v1/statuses \
-H "x-api-key: msgf_live_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"instanceId": "YOUR_INSTANCE_ID",
"type": "image",
"content": "https://cdn.example.com/promo.jpg",
"caption": "Promo du weekend"
}'
Response
{
"data": {
"instanceId": "YOUR_INSTANCE_ID",
"providerMessageId": "BAE5D1A2B3C4D5E6"
}
}
Statuses consume the same monthly quota as messages.
Common errors
| Code | HTTP | When |
|---|
STATUSES_NOT_AVAILABLE_ON_PLAN | 403 | Plan trop faible |
NOT_FOUND | 404 | Instance not found |
MONTHLY_OUTBOUND_QUOTA_EXCEEDED | 429 | Monthly quota exhausted |