> ## Documentation Index > Fetch the complete documentation index at: https://docs.runaether.dev/llms.txt > Use this file to discover all available pages before exploring further. # Set your agent's daily spend cap > Sets the most your personal agent may spend on inference in a day, over every model call it makes; the day ends at midnight in your timezone. A model call is admitted while the day's settled spend plus what the agent's calls in flight hold (each its most possible cost) is under the cap, so the day overruns the cap by at most the last call admitted. The cap holds from the agent's next model call: a refused agent thinks again once the cap is raised past the day's spend and holds, once its calls in flight settle under it, or at midnight. ## OpenAPI ````yaml api-reference/openapi.json PUT /agent/daily-cap openapi: 3.1.0 info: title: Aether API version: 0.1.0 servers: - url: https://api.runaether.dev security: - bearerAuth: [] paths: /agent/daily-cap: put: tags: - agent summary: Set your agent's daily spend cap description: >- Sets the most your personal agent may spend on inference in a day, over every model call it makes; the day ends at midnight in your timezone. A model call is admitted while the day's settled spend plus what the agent's calls in flight hold (each its most possible cost) is under the cap, so the day overruns the cap by at most the last call admitted. The cap holds from the agent's next model call: a refused agent thinks again once the cap is raised past the day's spend and holds, once its calls in flight settle under it, or at midnight. operationId: setAgentDailyCap requestBody: content: application/json: schema: $ref: '#/components/schemas/SetAgentDailyCapRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/AgentDailyCap' description: OK '400': content: application/json: schema: $ref: '#/components/schemas/AgentErrorResponse' description: Bad Request '401': content: application/json: schema: $ref: '#/components/schemas/AgentErrorResponse' description: Unauthorized '403': content: application/json: schema: $ref: '#/components/schemas/OrgAuthorizationErrorResponse' description: Forbidden '404': content: application/json: schema: $ref: '#/components/schemas/AgentErrorResponse' description: Not Found '422': content: application/json: schema: $ref: '#/components/schemas/AgentErrorResponse' description: Unprocessable Entity '500': content: application/json: schema: $ref: '#/components/schemas/AgentErrorResponse' description: Internal Server Error components: schemas: SetAgentDailyCapRequest: additionalProperties: false properties: daily_cap_cents: description: >- The most your agent may spend from your balance in a day, on Aether inference and on its tool calls while they are charged, in US cents. It holds from the agent's next such call. format: int64 maximum: 2147483647 minimum: 1 type: integer required: - daily_cap_cents type: object AgentDailyCap: additionalProperties: false properties: daily_cap_cents: description: >- The most the agent may spend from its owner's balance in a day, over every model call it makes on Aether inference and every tool call while tool calls are charged, in US cents. Such a call is refused (402 agent_host_daily_cap_reached) once the day's settled spend plus what the agent's calls in flight hold reaches it, until midnight in the timezone, until calls in flight settle under it, or until the cap is raised past them. format: int32 type: integer day: description: >- Today in the agent's timezone, as YYYY-MM-DD: the day spent_microdollars is for. pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$ type: string spent_microdollars: description: >- What the agent's model calls, and its tool calls while they are charged, settled today, in millionths of a US dollar. format: int64 type: integer timezone: description: The owner's IANA timezone, whose midnight starts the next day. type: string required: - daily_cap_cents - day - timezone - spent_microdollars type: object AgentErrorResponse: additionalProperties: false properties: code: enum: - account_deleting - aether_inference_unavailable - aether_inference_unserved - agent_connector_not_found - agent_credential_unreadable - agent_default_project_archived - agent_event_not_found - agent_host_account_deleting - agent_host_command_not_found - agent_host_creation_disabled - agent_host_exists - agent_host_illegal_transition - agent_host_not_allowlisted - agent_host_not_found - agent_host_not_ready - agent_host_other_provider_app - agent_host_project_not_eligible - agent_host_provisioning_failed - agent_host_state_changed - agent_host_wake_failed - agent_line_unavailable - agent_link_code_picked_up - agent_link_expired - agent_link_invalid_code - agent_link_needs_web_session - agent_link_no_verified_phone - agent_link_not_found - agent_link_other_account - agent_link_takes_a_code - agent_link_takes_no_code - agent_link_used - agent_message_not_found - agent_message_pending - agent_not_found - bad_gateway - bad_request - conflict - connection_account_held - connection_agent_only - connection_harness_mismatch - connection_is_default - connection_kind_not_runnable - connection_name_taken - connection_not_found - connection_not_held - connection_not_of_agent_family - connection_option_mismatch - connection_runs_agent - connection_runs_profiles - control_forbidden - default_skill_required - forbidden - gateway_timeout - github_auth_check_unavailable - github_claim_unverified - github_identity_mismatch - github_reconnect_required - github_ref_not_found - gone - integration_auth_unexpected - integration_not_in_directory - integration_shape_changed - internal_error - line_exists - line_not_found - line_not_imessage - mcp_connection_github_not_connected - mcp_connection_oauth_not_accepted - mcp_connection_org_not_offered - mcp_connection_secret_invalid - mcp_connection_server_changed - mcp_connection_static_secret_not_accepted - mcp_credential_policy_not_applicable - mcp_credential_policy_org_unavailable - mcp_credential_policy_required - mcp_oauth_app_auth_method_unsupported - mcp_oauth_app_invalid - mcp_oauth_app_issuer_invalid - mcp_oauth_app_required - mcp_oauth_not_advertised - mcp_oauth_pkce_unsupported - mcp_oauth_registration_failed - mcp_repo_config_invalid - mcp_server_address_refused - mcp_server_aether_managed - mcp_server_api_key_not_applicable - mcp_server_args_invalid - mcp_server_auth_discovery_failed - mcp_server_auth_unsupported - mcp_server_directory_managed - mcp_server_directory_moved - mcp_server_display_name_invalid - mcp_server_env_invalid - mcp_server_headers_invalid - mcp_server_key_invalid - mcp_server_key_reserved - mcp_server_key_taken - mcp_server_kind_change_refused - mcp_server_not_from_directory - mcp_server_not_mcp - mcp_server_package_invalid - mcp_server_plugin_bundled - mcp_server_plugin_off - mcp_server_response_too_large - mcp_server_return_to_invalid - mcp_server_runtime_invalid - mcp_server_switched_off - mcp_server_unreachable - mcp_server_url_invalid - mcp_server_version_unpinned - method_not_allowed - model_not_on_aether_inference - no_dispatch_target - not_acceptable - not_an_agent_host - not_found - not_implemented - org_role_insufficient - org_suspended - payment_required - plugin_moved - plugin_name_taken - plugin_request_invalid - plugin_server_key_reserved - plugin_server_key_taken - plugin_server_probe_failed - plugin_server_required - plugin_skill_invalid - plugin_source_address_refused - plugin_source_empty - plugin_source_invalid - plugin_source_not_found - plugin_source_not_public - plugin_source_too_large - plugin_source_unreachable - plugin_source_unsupported - plugin_switched_off - plugin_undeliverable - precondition_failed - rate_limited - repository_not_reachable - request_canceled - request_timeout - request_too_large - service_unavailable - skill_slug_reserved - unauthenticated - unsupported_media_type - validation_failed - whatsapp_not_enabled minLength: 1 type: string error: minLength: 1 type: string errors: items: $ref: '#/components/schemas/ErrorDetail' type: array required: - error - code type: object OrgAuthorizationErrorResponse: additionalProperties: false properties: code: enum: - org_membership_required - org_role_insufficient - org_suspended - account_deleting - agent_host_route_not_allowed - credential_kind_not_admitted type: string error: minLength: 1 type: string required: - error - code type: object ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object securitySchemes: bearerAuth: bearerFormat: JWT scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.