> ## 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. # Read metered database execution usage > Returns schedule runs and webhook attempts per time window. Only completed windows are final; the current window may still change. Windows are UTC and at most 31 days long. Rejected, skipped, event and delivery counts are reported but not billed. ## OpenAPI ````yaml /openapi.json get /v1/projects/{project_id}/database/execution-usage 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/execution-usage: get: summary: Read metered database execution usage description: >- Returns schedule runs and webhook attempts per time window. Only completed windows are final; the current window may still change. Windows are UTC and at most 31 days long. Rejected, skipped, event and delivery counts are reported but not billed. operationId: getProjectDatabaseExecutionUsage parameters: - $ref: '#/components/parameters/RequestId' - $ref: '#/components/parameters/ProjectId' - $ref: '#/components/parameters/DatabaseEnvironmentRead' - name: from in: query description: Inclusive window start in UTC, aligned to the granularity. required: true schema: type: string format: date-time pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\.[0-9]{3}Z$ - name: to in: query description: Exclusive window end in UTC, aligned to the granularity. required: true schema: type: string format: date-time pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\.[0-9]{3}Z$ - name: granularity in: query description: Length of each returned window. required: true schema: type: string enum: - hour - day - name: limit in: query description: Maximum number of windows in this page. required: false schema: type: integer minimum: 1 maximum: 100 default: 50 - name: cursor in: query description: Opaque cursor returned by the previous page. required: false schema: type: string minLength: 1 maxLength: 200 responses: '200': description: One page of execution usage windows. content: application/json: schema: $ref: '#/components/schemas/DatabaseExecutionUsagePage' '400': $ref: '#/components/responses/Problem' '401': $ref: '#/components/responses/Problem' '404': $ref: '#/components/responses/ResourceNotFound' '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' DatabaseEnvironmentRead: name: environment in: query description: Application environment to read; dev when omitted. required: false schema: type: string enum: - dev - prod default: dev schemas: DatabaseExecutionUsagePage: type: object additionalProperties: false required: - items - next_cursor properties: items: type: array maxItems: 100 items: $ref: '#/components/schemas/DatabaseExecutionUsageRow' next_cursor: type: - string - 'null' minLength: 1 maxLength: 200 Ulid: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ DatabaseExecutionUsageRow: type: object additionalProperties: false required: - start - end - final - metrics properties: start: type: string format: date-time end: type: string format: date-time final: type: boolean metrics: $ref: '#/components/schemas/DatabaseExecutionMetrics' 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 DatabaseExecutionMetrics: type: object additionalProperties: false required: - schedule_runs_succeeded - schedule_runs_failed - schedule_runs_timed_out - schedule_runs_outcome_unknown - schedule_runs_rejected - schedule_runs_skipped - events_emitted - event_bytes - webhook_attempts - webhook_deliveries_delivered - webhook_deliveries_dead_lettered properties: schedule_runs_succeeded: type: integer minimum: 0 schedule_runs_failed: type: integer minimum: 0 schedule_runs_timed_out: type: integer minimum: 0 schedule_runs_outcome_unknown: type: integer minimum: 0 schedule_runs_rejected: type: integer minimum: 0 schedule_runs_skipped: type: integer minimum: 0 events_emitted: type: integer minimum: 0 event_bytes: type: integer minimum: 0 webhook_attempts: type: integer minimum: 0 webhook_deliveries_delivered: type: integer minimum: 0 webhook_deliveries_dead_lettered: type: integer minimum: 0 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.