List all user crontabs

GET /crontab

Returns a paginated list of every system user that has a crontab file, along with each user’s full crontab text.

Parameters

Name	In	Type	Required	Description
page	query	integer	No	Page number (1-based)
limit	query	integer	No	Items per page (max 200)

cURL

curl -X GET "https://acme-web01-cron-1.eu-west-1.containers.hoody.icu/crontab?page=1&limit=50"

SDK

await client.cron.crontab.listGlobalIterator({ page: 1, limit: 50 })

Responses

200

{
  "items": [
    {
      "user": "root",
      "crontab": "0 5 * * * /usr/bin/backup.sh\n"
    },
    {
      "user": "app",
      "crontab": "@daily /opt/app/rotate-logs.sh\n"
    }
  ],
  "page": 1,
  "limit": 50,
  "total": 2
}

500

{
  "code": "BACKEND_ERROR",
  "message": "Internal server error"
}

Error Code	Title	Description	Resolution
BACKEND_ERROR	Backend error	Failed to read or write system crontab	Check crontab availability and permissions

Read raw crontab

GET /users/{user}/crontab

Returns the raw crontab text for a single system user.

Parameters

Name	In	Type	Required	Description
user	path	string	Yes	System username

cURL

curl -X GET "https://acme-web01-cron-1.eu-west-1.containers.hoody.icu/users/app/crontab"

SDK

await client.cron.crontab.get("app")

Responses

200

{
  "user": "app",
  "crontab": "@daily /opt/app/rotate-logs.sh\n"
}

400

{
  "code": "INVALID_USER",
  "message": "Invalid user"
}

Error Code	Title	Description	Resolution
INVALID_USER	Invalid user	User parameter failed validation	Provide a valid system username
INVALID_COMMENT	Invalid comment	Comment is empty, too long, or contains newlines	Provide a short single-line comment
INVALID_SCHEDULE	Invalid schedule	Schedule is not a valid cron expression	Use a standard 5-field cron expression or @daily style macros
INVALID_COMMAND	Invalid command	Command field is empty or contains invalid characters	Provide a command without newlines
INVALID_PAGINATION	Invalid pagination	Page or limit is out of range	Use page >= 1 and limit between 1 and 200

404

{
  "code": "USER_NOT_FOUND",
  "message": "User not found"
}

Error Code	Title	Description	Resolution
USER_NOT_FOUND	User not found	The requested system user does not exist	Create the user or choose an existing username
ENTRY_NOT_FOUND	Entry not found	No managed entry with the provided id exists	List entries and retry with a valid id

500

{
  "code": "BACKEND_ERROR",
  "message": "Internal server error"
}

Error Code	Title	Description	Resolution
BACKEND_ERROR	Backend error	Failed to read or write system crontab	Check crontab availability and permissions

Replace raw crontab

PUT /users/{user}/crontab

Replaces the user’s crontab with the provided text. The response includes the written crontab and a count of any expired entries that were removed during the replacement.

Parameters

Name	In	Type	Required	Description
user	path	string	Yes	System username

Request Body

Field	Type	Required	Description
crontab	string	Yes	Full crontab text to write for the user

cURL

curl -X PUT "https://acme-web01-cron-1.eu-west-1.containers.hoody.icu/users/app/crontab" \
  -H "Content-Type: application/json" \
  -d '{"crontab":"@daily /opt/app/rotate-logs.sh\n"}'

SDK

await client.cron.crontab.put("app", { crontab: "@daily /opt/app/rotate-logs.sh\n" })

Responses

200

{
  "user": "app",
  "crontab": "@daily /opt/app/rotate-logs.sh\n",
  "removed_expired": 0
}

400

{
  "code": "INVALID_USER",
  "message": "Invalid user"
}

Error Code	Title	Description	Resolution
INVALID_USER	Invalid user	User parameter failed validation	Provide a valid system username
INVALID_COMMENT	Invalid comment	Comment is empty, too long, or contains newlines	Provide a short single-line comment
INVALID_SCHEDULE	Invalid schedule	Schedule is not a valid cron expression	Use a standard 5-field cron expression or @daily style macros
INVALID_COMMAND	Invalid command	Command field is empty or contains invalid characters	Provide a command without newlines
INVALID_PAGINATION	Invalid pagination	Page or limit is out of range	Use page >= 1 and limit between 1 and 200

404

{
  "code": "USER_NOT_FOUND",
  "message": "User not found"
}

Error Code	Title	Description	Resolution
USER_NOT_FOUND	User not found	The requested system user does not exist	Create the user or choose an existing username
ENTRY_NOT_FOUND	Entry not found	No managed entry with the provided id exists	List entries and retry with a valid id

413

{
  "code": "PAYLOAD_TOO_LARGE",
  "message": "Payload too large"
}

500

{
  "code": "BACKEND_ERROR",
  "message": "Internal server error"
}

Error Code	Title	Description	Resolution
BACKEND_ERROR	Backend error	Failed to read or write system crontab	Check crontab availability and permissions