Update Cron Job

curl -X PATCH "https://api.a1base.com/v1/cron-jobs/{accountId}/update/550e8400-e29b-41d4-a716-446655440000" \
  -H "X-API-Key: your-api-key" \
  -H "X-API-Secret: your-api-secret" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Daily Report",
    "schedule_config": {
      "repeat_type": "weeks",
      "repeat_every": 1,
      "time": "10:00",
      "days_of_week": ["1", "3", "5"],
      "end_type": "never"
    },
    "is_active": false
  }'

const axios = require('axios');

const updateCronJob = async (cronJobId) => {
  const updates = {
    name: "Updated Daily Report",
    schedule_config: {
      repeat_type: "weeks",
      repeat_every: 1,
      time: "10:00",
      days_of_week: ["1", "3", "5"],
      end_type: "never"
    },
    is_active: false
  };

  try {
    const response = await axios.patch(
      `https://api.a1base.com/v1/cron-jobs/{accountId}/update/${cronJobId}`,
      updates,
      {
        headers: {
          'X-API-Key': 'your-api-key',
          'X-API-Secret': 'your-api-secret',
          'Content-Type': 'application/json'
        }
      }
    );
    
    console.log('Cron job updated:', response.data);
  } catch (error) {
    console.error('Error:', error.response.data);
  }
};

updateCronJob('550e8400-e29b-41d4-a716-446655440000');

import requests

def update_cron_job(cron_job_id):
    url = f"https://api.a1base.com/v1/cron-jobs/{{accountId}}/update/{cron_job_id}"
    
    headers = {
        "X-API-Key": "your-api-key",
        "X-API-Secret": "your-api-secret",
        "Content-Type": "application/json"
    }
    
    updates = {
        "name": "Updated Daily Report",
        "schedule_config": {
            "repeat_type": "weeks",
            "repeat_every": 1,
            "time": "10:00",
            "days_of_week": ["1", "3", "5"],
            "end_type": "never"
        },
        "is_active": False
    }
    
    response = requests.patch(url, headers=headers, json=updates)
    
    if response.status_code == 200:
        print("Cron job updated:", response.json())
    else:
        print("Error:", response.status_code, response.json())

update_cron_job("550e8400-e29b-41d4-a716-446655440000")

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Updated Daily Report",
    "description": "Generate comprehensive sales report",
    "endpoint_url": "https://api.company.com/reports/daily",
    "schedule": "0 10 * * 1,3,5",
    "method": "POST",
    "headers": {
      "Authorization": "Bearer report-token",
      "Content-Type": "application/json"
    },
    "body": "{\"report_type\": \"sales\", \"format\": \"pdf\"}",
    "is_active": false,
    "timezone": "America/New_York",
    "repeat_type": "weeks",
    "repeat_every": 1,
    "days_of_week": ["1", "3", "5"],
    "hours": 10,
    "minutes": 0,
    "end_type": "never",
    "end_date": null,
    "end_occurrences": null,
    "max_retries": 3,
    "retry_delay_seconds": 300,
    "timeout_seconds": 30,
    "success_callback_url": "https://webhooks.company.com/cron-success",
    "failure_callback_url": "https://webhooks.company.com/cron-failure",
    "tags": ["reports", "daily", "sales"],
    "next_run_at": null,
    "last_run_at": "2024-01-25T14:00:00Z",
    "consecutive_failures": 0,
    "created_at": "2024-01-01T00:00:00Z",
    "updated_at": "2024-01-25T15:30:00Z"
  }
}

Update an existing cron job. All fields are optional - only provide the fields you want to update.

Path Parameters

string

required

Your A1Base account ID

string

required

The unique identifier of the cron job to update (UUID format)

Request Body

All fields are optional. Only include the fields you want to update.

string

New name for the cron job

string

New description

string

New URL to call

string

New HTTP method: GET, POST, PUT, DELETE

object

New HTTP headers (replaces all existing headers)

string

New request body for POST/PUT methods

string

New timezone

object

New schedule configuration (replaces entire schedule)

Show Schedule Config Properties

string

Type of repetition: hourly, days, weeks, months, years

integer

Frequency of repetition

string

Time in 24-hour format “HH:MM”

array

For weekly schedules: array of day numbers (“0”-“6”)

string

How the schedule ends: never, on, after

string

ISO 8601 timestamp when to stop

integer

Number of occurrences before stopping

object

New retry configuration

Show Retry Config Properties

integer

Maximum retry attempts (0-10)

integer

Seconds between retries

integer

Response timeout in seconds

object

New webhook URLs

Show Callback Properties

string

Success webhook URL

string

Failure webhook URL

array

New array of tags (replaces all existing tags)

boolean

Activate or deactivate the cron job

Response

Returns the updated cron job object with all current values.

curl -X PATCH "https://api.a1base.com/v1/cron-jobs/{accountId}/update/550e8400-e29b-41d4-a716-446655440000" \
  -H "X-API-Key: your-api-key" \
  -H "X-API-Secret: your-api-secret" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Daily Report",
    "schedule_config": {
      "repeat_type": "weeks",
      "repeat_every": 1,
      "time": "10:00",
      "days_of_week": ["1", "3", "5"],
      "end_type": "never"
    },
    "is_active": false
  }'

const axios = require('axios');

const updateCronJob = async (cronJobId) => {
  const updates = {
    name: "Updated Daily Report",
    schedule_config: {
      repeat_type: "weeks",
      repeat_every: 1,
      time: "10:00",
      days_of_week: ["1", "3", "5"],
      end_type: "never"
    },
    is_active: false
  };

  try {
    const response = await axios.patch(
      `https://api.a1base.com/v1/cron-jobs/{accountId}/update/${cronJobId}`,
      updates,
      {
        headers: {
          'X-API-Key': 'your-api-key',
          'X-API-Secret': 'your-api-secret',
          'Content-Type': 'application/json'
        }
      }
    );
    
    console.log('Cron job updated:', response.data);
  } catch (error) {
    console.error('Error:', error.response.data);
  }
};

updateCronJob('550e8400-e29b-41d4-a716-446655440000');

import requests

def update_cron_job(cron_job_id):
    url = f"https://api.a1base.com/v1/cron-jobs/{{accountId}}/update/{cron_job_id}"
    
    headers = {
        "X-API-Key": "your-api-key",
        "X-API-Secret": "your-api-secret",
        "Content-Type": "application/json"
    }
    
    updates = {
        "name": "Updated Daily Report",
        "schedule_config": {
            "repeat_type": "weeks",
            "repeat_every": 1,
            "time": "10:00",
            "days_of_week": ["1", "3", "5"],
            "end_type": "never"
        },
        "is_active": False
    }
    
    response = requests.patch(url, headers=headers, json=updates)
    
    if response.status_code == 200:
        print("Cron job updated:", response.json())
    else:
        print("Error:", response.status_code, response.json())

update_cron_job("550e8400-e29b-41d4-a716-446655440000")

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Updated Daily Report",
    "description": "Generate comprehensive sales report",
    "endpoint_url": "https://api.company.com/reports/daily",
    "schedule": "0 10 * * 1,3,5",
    "method": "POST",
    "headers": {
      "Authorization": "Bearer report-token",
      "Content-Type": "application/json"
    },
    "body": "{\"report_type\": \"sales\", \"format\": \"pdf\"}",
    "is_active": false,
    "timezone": "America/New_York",
    "repeat_type": "weeks",
    "repeat_every": 1,
    "days_of_week": ["1", "3", "5"],
    "hours": 10,
    "minutes": 0,
    "end_type": "never",
    "end_date": null,
    "end_occurrences": null,
    "max_retries": 3,
    "retry_delay_seconds": 300,
    "timeout_seconds": 30,
    "success_callback_url": "https://webhooks.company.com/cron-success",
    "failure_callback_url": "https://webhooks.company.com/cron-failure",
    "tags": ["reports", "daily", "sales"],
    "next_run_at": null,
    "last_run_at": "2024-01-25T14:00:00Z",
    "consecutive_failures": 0,
    "created_at": "2024-01-01T00:00:00Z",
    "updated_at": "2024-01-25T15:30:00Z"
  }
}

Common Update Scenarios

Change Schedule Time

{
  "schedule_config": {
    "time": "14:30"
  }
}

Note: When updating schedule_config, you must provide all required fields for the schedule type.

Pause/Resume

{
  "is_active": false
}

Update Headers

{
  "headers": {
    "Authorization": "Bearer new-token",
    "Content-Type": "application/json",
    "X-Custom-Header": "value"
  }
}

Change Tags

{
  "tags": ["updated", "production", "critical"]
}

Update Callbacks

{
  "callbacks": {
    "success_url": "https://new-webhook.com/success",
    "failure_url": "https://new-webhook.com/failure"
  }
}

When updating schedule_config, provide the complete configuration object with all required fields for the schedule type, not just the fields you want to change.

Create Cron Job Delete Cron Job

A1Cron

Getting Started with A1Cron

Cron Job Management

Monitoring & Logs

Update Cron Job

Path Parameters

Request Body

Response

Common Update Scenarios

​Path Parameters

​Request Body

​Response

​Common Update Scenarios

Path Parameters

Request Body

Response

Common Update Scenarios