Blocked Periods

Custom no-post periods

Create custom blocked periods for company events, maintenance windows, or specific dates when you don't want any posts to go out.

List Blocked Periods

GET /v1/workspaces/{id}/schedule/blocked/

Response

{
  "blocked_periods": [
    {
      "id": 1,
      "name": "Company Retreat",
      "start_datetime": "2025-03-15T00:00:00Z",
      "end_datetime": "2025-03-17T23:59:59Z",
      "platforms": [],
      "is_recurring": false
    },
    {
      "id": 2,
      "name": "System Maintenance",
      "start_datetime": "2025-04-01T02:00:00Z",
      "end_datetime": "2025-04-01T06:00:00Z",
      "platforms": ["twitter", "linkedin"],
      "is_recurring": false
    }
  ]
}

Create Blocked Period

POST /v1/workspaces/{id}/schedule/blocked/

Request Body

{
  "name": "Product Transition Week",
  "start_datetime": "2025-05-10T00:00:00Z",
  "end_datetime": "2025-05-16T23:59:59Z",
  "platforms": [],
  "is_recurring": false
}

Example

curl -X POST "https://api.missinglettr.com/v1/workspaces/1/schedule/blocked/" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Company Conference",
    "start_datetime": "2025-06-20T00:00:00Z",
    "end_datetime": "2025-06-22T23:59:59Z",
    "platforms": [],
    "is_recurring": false
  }'

Parameters

name: Description of the blocked period
start_datetime: When the block starts (ISO 8601 format)
end_datetime: When the block ends
platforms: Empty array = block all platforms, or specify specific ones
is_recurring: If true, block repeats annually

Platform-Specific Blocking

Block specific platforms while allowing others:

{
  "name": "Twitter API Maintenance",
  "start_datetime": "2025-04-15T10:00:00Z",
  "end_datetime": "2025-04-15T12:00:00Z",
  "platforms": ["twitter"],
  "is_recurring": false
}

Recurring Blocks

Create annually recurring blocked periods:

{
  "name": "Annual Company Shutdown",
  "start_datetime": "2025-12-24T00:00:00Z",
  "end_datetime": "2025-12-31T23:59:59Z",
  "platforms": [],
  "is_recurring": true
}

Use Cases: Company events, product transitions, rebranding periods, crisis management, or any time you need complete control over when posts go out.

Holiday Settings Calendar & Utilities