> ## Documentation Index > Fetch the complete documentation index at: https://docs.ohmyho.st/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > For account actions, read https://ohmyho.st/skills/ohmyhost-get-started/SKILL.md and use the authenticated ohmyho.st CLI, local product MCP or supported remote OAuth MCP. Read the current project source binding before choosing GitHub or managed versions. Mintlify search only reads documentation. Preserve the customer’s selected project, environment and authentication provider; keep private application values in the portal or local stdin flow. # Create or replace one database schedule > Creates the named schedule or replaces it. Each run executes the statements as the application's own runtime role, so row-level security applies as for the application. A run that does not finish within timeout_ms is cancelled. ## OpenAPI ````yaml /openapi.json put /v1/projects/{project_id}/database/schedules/{name} openapi: 3.1.2 info: title: ohmyho.st API version: 0.0.0 description: >- Public REST API for ohmyho.st hosting, projects, domains, email, credits and exports. servers: - url: https://app.ohmyho.st description: Production control API - url: https://dev.app.ohmyho.st description: Development control API security: - BearerAuth: [] paths: /v1/projects/{project_id}/database/schedules/{name}: put: summary: Create or replace one database schedule description: >- Creates the named schedule or replaces it. Each run executes the statements as the application's own runtime role, so row-level security applies as for the application. A run that does not finish within timeout_ms is cancelled. operationId: setProjectDatabaseSchedule parameters: - $ref: '#/components/parameters/RequestId' - $ref: '#/components/parameters/ProjectId' - $ref: '#/components/parameters/DatabaseScheduleName' - $ref: '#/components/parameters/DatabaseEnvironment' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/DatabaseScheduleSetRequest' responses: '200': description: The schedule as stored. content: application/json: schema: $ref: '#/components/schemas/DatabaseSchedule' '400': $ref: '#/components/responses/Problem' '401': $ref: '#/components/responses/Problem' '404': $ref: '#/components/responses/ResourceNotFound' '409': $ref: '#/components/responses/Problem' '429': $ref: '#/components/responses/Problem' '503': $ref: '#/components/responses/Problem' components: parameters: RequestId: name: X-Request-Id in: header description: Optional caller-provided correlation identifier. required: false schema: type: string minLength: 1 maxLength: 128 ProjectId: name: project_id in: path description: Project identifier. required: true schema: $ref: '#/components/schemas/Ulid' DatabaseScheduleName: name: name in: path description: Database schedule name, unique per project environment. required: true schema: type: string pattern: ^[a-z][a-z0-9_-]{0,62}$ DatabaseEnvironment: name: environment in: query description: Application environment the mutation applies to. required: true schema: type: string enum: - dev - prod schemas: DatabaseScheduleSetRequest: type: object additionalProperties: false required: - statements - confirm oneOf: - required: - cron - required: - every_seconds properties: cron: type: string minLength: 9 maxLength: 120 description: >- Five-field cron expression evaluated in UTC. Send exactly one of cron or every_seconds. every_seconds: type: integer minimum: 60 maximum: 2678400 description: >- Interval in seconds between runs. Send exactly one of cron or every_seconds. statements: type: array minItems: 1 maxItems: 20 description: >- Statements run in order by the application's runtime role. At most 16 KiB per statement and 64 KiB in total. items: type: string minLength: 1 maxLength: 16384 pattern: \S timeout_ms: type: integer minimum: 1000 maximum: 30000 default: 10000 enabled: type: boolean default: true confirm: type: boolean const: true description: >- Confirms that the statements run with the application's runtime role. DatabaseSchedule: type: object additionalProperties: false required: - name - environment - cron - every_seconds - statements - timeout_ms - enabled - next_run_at - created_at oneOf: - properties: cron: type: string minLength: 9 maxLength: 120 every_seconds: type: 'null' - properties: cron: type: 'null' every_seconds: type: integer minimum: 60 maximum: 2678400 properties: name: type: string pattern: ^[a-z][a-z0-9_-]{0,62}$ environment: type: string enum: - dev - prod cron: type: - string - 'null' every_seconds: type: - integer - 'null' statements: type: array maxItems: 20 items: type: string timeout_ms: type: integer minimum: 1000 maximum: 30000 enabled: type: boolean next_run_at: type: - string - 'null' format: date-time created_at: type: string format: date-time Ulid: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ ProblemDetails: type: object description: RFC 9457 Problem Details extended with stable ohmyhost recovery fields. additionalProperties: false required: - type - title - status - code - request_id - retryable - suggested_action properties: type: type: string format: uri-reference title: type: string minLength: 1 status: type: integer minimum: 400 maximum: 599 detail: type: string instance: type: string format: uri-reference code: type: string enum: - invalid_request - unauthenticated - forbidden - organization_required - resource_not_found - idempotency_key_reused - project_handle_unavailable - project_identity_unavailable - deployment_plan_expired - deployment_plan_incompatible - confirmation_expired - confirmation_invalid - etag_mismatch - promotion_source_stale - promotion_target_stale - promotion_invalid_target - mail_domain_conflict - mail_domain_required - mail_capacity_unavailable - storage_jurisdiction_conflict - shared_data_requires_promotion - production_deployment_required - framework_conversion_required - repository_configuration_missing - migration_filename_noncanonical - environment_secret_mutation_blocked - workers_runtime_incompatible - project_handle_invalid - project_handle_taken - project_handle_unchanged - project_rename_blocked - payload_too_large - rate_limited - insufficient_organization_credits - paid_plan_required - project_budget_exceeded - compute_performance_paid_required - compute_paid_required - compute_storage_shrink_requires_migration - compute_performance_unavailable - database_write_pending - database_access_limit - database_webhook_limit - database_schedule_limit - database_schedule_not_runnable - database_webhook_delivery_pending - compute_change_pending - compute_change_conflict - billing_purchase_conflict - billing_recharge_conflict - github_connection_required - github_connection_revoked - repository_not_installed - cloudflare_zone_not_bound - cloudflare_authorization_closed - project_notes_conflict - project_export_not_ready - powered_by_flag_required - interactive_login_required - api_key_creation_uncertain - api_key_permissions_unavailable - reconciliation_exhausted - service_unavailable - source_commit_not_found - domain_hostname_taken - domain_dns_conflict - data_change_blocked - data_change_in_progress - data_change_not_applicable - rollback_target_data_changed - project_domain_delete_required request_id: type: string minLength: 1 maxLength: 128 retryable: type: boolean retry_after_seconds: type: integer minimum: 1 maximum: 86400 description: >- Optional machine-readable retry delay for a rate limit, matching Retry-After. suggested_action: type: string minLength: 1 responses: Problem: description: The request failed. headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' ResourceNotFound: description: >- The resource does not exist or is not visible to the authenticated principal. headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' examples: resourceNotFound: value: type: https://docs.ohmyho.st/errors/resource-not-found title: Resource not found status: 404 code: resource_not_found request_id: req_01J00000000000000000000000 retryable: false suggested_action: Check the resource identifier and your access scope. headers: XRequestId: description: Correlates the request with operations, events, logs, and audit records. required: true schema: type: string minLength: 1 maxLength: 128 securitySchemes: BearerAuth: type: http scheme: bearer description: >- WorkOS access JWT or a user-owned WorkOS API key. User keys are bound to one organization and restricted to their enabled product permissions. Session-only onboarding and session revocation require an interactive access JWT. No cookie session is assumed. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.