> ## 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.

# List the ways a chat of a task can run

> Lists the ways a chat of the task can run: with which agent, the models, thinking levels and modes it may choose, and whether the caller can start one now. A task on a person's computer lists one option per agent on its computer, which takes no other chat: can.start reads unsupported chats_not_addable.

Use this tool when you need to:
- Choose agent_type, model, reasoning_effort and interaction_mode for createTaskChat
- Show the labels of the models and thinking levels the task's chats hold, offered or not

Examples:
- GET /tasks/6f1c2a9e-3b7d-4c55-9a2e-0d8b1f4e7c21/start-options

Hints:
- taskID is the task's lowercase uuid.
- Not paged. A sandbox's items hold one option per agent a cloud sandbox runs and a new selection may name, in the catalog's order (today codex and claude-code). An agent retired from new selections (today opencode) is listed only where a chat of the task already runs it. Each has machine ({"kind": "sandbox"} or {"kind": "computer", "computer_id": "..."}, exactly what a create will send as its machine; options with an equal machine are one place, offered once with a choice of agent), machine_label, agent_type, agent_label, can, choices and defaults.
- A computer's items hold one option per agent Aether runs on a person's computer (today claude-code). Its choices are what the agent's own CLI takes there: model default, the agent's own default there, then the models its CLI names (fable, opus, sonnet, haiku), each with thinking levels low to max, interaction mode default alone and no attachment types. Its defaults are model default, a null reasoning_effort and interaction_mode default: the computer's own settings. can.start reads unsupported with computer_cli_outdated or no_work_tree_folder when the computer's aether CLI cannot start a task, not_now with computer_unreachable, agent_starts_off or no_checkout_on_computer while it cannot now, and not_permitted credential_kind_not_admitted for a client app's grant or an agent. An agent the computer's bridge found signed out or missing reads available with the note not_signed_in or agent_not_installed: the start waits on the computer until it is put right. can.compose is what the bridge declared a run of the agent supports, and can.change_pr_automation reads unsupported pr_automation_unsupported.
- choices.models holds each model (id, label, selectable) with reasoning_efforts, the thinking levels it takes (id, label, description, selectable), empty when it takes none, and default_reasoning_effort, the words for what a null reasoning_effort runs (Codex chooses the level itself; Claude Code and OpenCode run their default level), null when it takes none. choices.interaction_modes holds each mode (id, label) and choices.attachment_types the media types a message may attach. Ids are open strings: show the label of an id you do not know.
- defaults is what a picker starts on: model, reasoning_effort (the agent's default level, null when the default model takes none) and interaction_mode. A request may also send no reasoning_effort, and the model's default_reasoning_effort says what that means. createTask and createTaskChat still require model and interaction_mode; a later change makes a create that leaves them out run with defaults.
- can holds start (whether a task or chat can be started with the option now: not_now or not_permitted with the account's standing, such as billing_blocked or org_suspended), compose (what its first message may carry: attach, reference_files, use_slash_commands, change_model, change_reasoning_effort, change_interaction_mode and change_connection) and change_pr_automation (whether the pull-request switches apply). Each is available with its notes, or not_now, unsupported or not_permitted with a reason: a code, an open set, and a sentence.
- VM sizes are getProjectRuntimeOptions', and the inference accounts an agent runs on are listConnections'. Computers are listComputers'.
- A model or thinking level a chat of the task holds that no new selection may name is listed with selectable false, after the selectable ones, so its label can be shown. A retired agent a chat of the task runs is offered like any other.
- can is for a chat of the task started by the caller: a reader who may not act in its chats reads can.start not_permitted with control_forbidden or org_role_insufficient.
- Any member of the task's organization may read it, a viewer included; a billing member is refused with 403 org_role_insufficient, a suspended organization with 403 org_suspended, and a task or chat outside the caller's reach is 404 not_found; 503 when the membership check is unavailable.



## OpenAPI

````yaml api-reference/openapi.json GET /tasks/{taskID}/start-options
openapi: 3.1.0
info:
  title: Aether API
  version: 0.1.0
servers:
  - url: https://api.runaether.dev
security:
  - bearerAuth: []
paths:
  /tasks/{taskID}/start-options:
    get:
      tags:
        - tasks
      summary: List the ways a chat of a task can run
      description: >-
        Lists the ways a chat of the task can run: with which agent, the models,
        thinking levels and modes it may choose, and whether the caller can
        start one now. A task on a person's computer lists one option per agent
        on its computer, which takes no other chat: can.start reads unsupported
        chats_not_addable.


        Use this tool when you need to:

        - Choose agent_type, model, reasoning_effort and interaction_mode for
        createTaskChat

        - Show the labels of the models and thinking levels the task's chats
        hold, offered or not


        Examples:

        - GET /tasks/6f1c2a9e-3b7d-4c55-9a2e-0d8b1f4e7c21/start-options


        Hints:

        - taskID is the task's lowercase uuid.

        - Not paged. A sandbox's items hold one option per agent a cloud sandbox
        runs and a new selection may name, in the catalog's order (today codex
        and claude-code). An agent retired from new selections (today opencode)
        is listed only where a chat of the task already runs it. Each has
        machine ({"kind": "sandbox"} or {"kind": "computer", "computer_id":
        "..."}, exactly what a create will send as its machine; options with an
        equal machine are one place, offered once with a choice of agent),
        machine_label, agent_type, agent_label, can, choices and defaults.

        - A computer's items hold one option per agent Aether runs on a person's
        computer (today claude-code). Its choices are what the agent's own CLI
        takes there: model default, the agent's own default there, then the
        models its CLI names (fable, opus, sonnet, haiku), each with thinking
        levels low to max, interaction mode default alone and no attachment
        types. Its defaults are model default, a null reasoning_effort and
        interaction_mode default: the computer's own settings. can.start reads
        unsupported with computer_cli_outdated or no_work_tree_folder when the
        computer's aether CLI cannot start a task, not_now with
        computer_unreachable, agent_starts_off or no_checkout_on_computer while
        it cannot now, and not_permitted credential_kind_not_admitted for a
        client app's grant or an agent. An agent the computer's bridge found
        signed out or missing reads available with the note not_signed_in or
        agent_not_installed: the start waits on the computer until it is put
        right. can.compose is what the bridge declared a run of the agent
        supports, and can.change_pr_automation reads unsupported
        pr_automation_unsupported.

        - choices.models holds each model (id, label, selectable) with
        reasoning_efforts, the thinking levels it takes (id, label, description,
        selectable), empty when it takes none, and default_reasoning_effort, the
        words for what a null reasoning_effort runs (Codex chooses the level
        itself; Claude Code and OpenCode run their default level), null when it
        takes none. choices.interaction_modes holds each mode (id, label) and
        choices.attachment_types the media types a message may attach. Ids are
        open strings: show the label of an id you do not know.

        - defaults is what a picker starts on: model, reasoning_effort (the
        agent's default level, null when the default model takes none) and
        interaction_mode. A request may also send no reasoning_effort, and the
        model's default_reasoning_effort says what that means. createTask and
        createTaskChat still require model and interaction_mode; a later change
        makes a create that leaves them out run with defaults.

        - can holds start (whether a task or chat can be started with the option
        now: not_now or not_permitted with the account's standing, such as
        billing_blocked or org_suspended), compose (what its first message may
        carry: attach, reference_files, use_slash_commands, change_model,
        change_reasoning_effort, change_interaction_mode and change_connection)
        and change_pr_automation (whether the pull-request switches apply). Each
        is available with its notes, or not_now, unsupported or not_permitted
        with a reason: a code, an open set, and a sentence.

        - VM sizes are getProjectRuntimeOptions', and the inference accounts an
        agent runs on are listConnections'. Computers are listComputers'.

        - A model or thinking level a chat of the task holds that no new
        selection may name is listed with selectable false, after the selectable
        ones, so its label can be shown. A retired agent a chat of the task runs
        is offered like any other.

        - can is for a chat of the task started by the caller: a reader who may
        not act in its chats reads can.start not_permitted with
        control_forbidden or org_role_insufficient.

        - Any member of the task's organization may read it, a viewer included;
        a billing member is refused with 403 org_role_insufficient, a suspended
        organization with 403 org_suspended, and a task or chat outside the
        caller's reach is 404 not_found; 503 when the membership check is
        unavailable.
      operationId: getTaskStartOptions
      parameters:
        - in: path
          name: taskID
          required: true
          schema:
            format: uuid
            pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListStartOption'
          description: OK
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TasksErrorResponse'
          description: Unauthorized
        '403':
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/TasksErrorResponse'
                  - $ref: '#/components/schemas/OrgAuthorizationErrorResponse'
          description: Forbidden
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TasksErrorResponse'
          description: Not Found
        '410':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TasksErrorResponse'
          description: Gone
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TasksErrorResponse'
          description: Unprocessable Entity
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TasksErrorResponse'
          description: Internal Server Error
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TasksErrorResponse'
          description: Service Unavailable
components:
  schemas:
    ListStartOption:
      additionalProperties: false
      properties:
        items:
          items:
            $ref: '#/components/schemas/StartOption'
          type: array
      required:
        - items
      type: object
    TasksErrorResponse:
      additionalProperties: false
      properties:
        code:
          enum:
            - account_deleting
            - aether_inference_unserved
            - agent_pr_blocked
            - agent_pr_pending
            - agent_profile_changed
            - agent_starts_off
            - agent_uses_own_sign_in
            - answer_on_its_way
            - app_identity_missing
            - attachments_unsupported
            - attribution_unavailable
            - bad_gateway
            - bad_request
            - base_branch_unusable
            - branch_exists
            - caller_inactive
            - chat_archived
            - chat_being_forked
            - chat_moved
            - chat_not_removable
            - chat_settings_fixed
            - chats_not_addable
            - checkout_not_archivable
            - cli_upgrade_required
            - client_outdated
            - computer_cli_outdated
            - computer_starts_no_agents
            - computer_starts_no_forks
            - computer_unreachable
            - conflict
            - connection_creator_only
            - connection_harness_mismatch
            - connection_not_held
            - contents_write_required
            - continuation_failed
            - continuation_unavailable
            - control_forbidden
            - creator_github_access_missing
            - credential_kind_not_admitted
            - credential_named_file
            - detached_head
            - download_unsupported
            - embeddings_unavailable
            - feature_unsupported
            - file_references_unsupported
            - fix_not_requested
            - fix_requests_unrecorded
            - forbidden
            - fork_branch_delete_unsupported
            - fork_forbidden
            - fork_in_progress
            - fork_unsupported
            - gateway_timeout
            - github_claim_unverified
            - github_failed
            - github_identity_mismatch
            - github_identity_required
            - github_push_access_required
            - github_reconnect_required
            - github_ref_not_found
            - gone
            - handed_branch_protected
            - head_moved
            - html_render_nul_byte
            - html_render_too_large
            - idempotency_key_conflict
            - idempotency_key_reused
            - idle_compaction_not_pending
            - idle_compaction_skipped
            - inference_proxy_unavailable
            - insufficient_credits
            - insufficient_inference_balance
            - interaction_mode_unsupported
            - internal_error
            - invalid_request
            - last_queued_message
            - live_protocol_unsupported
            - main_chat_permanent
            - mcp_server_not_connected
            - merge_when_ready_requires_pr_review
            - message_not_queued
            - method_not_allowed
            - mode_forbidden
            - name_follows_session
            - no_checkout_on_computer
            - no_checkpoint_yet
            - no_commit
            - no_dispatch_target
            - no_main_chat
            - no_origin
            - no_turn_running
            - no_work_tree_folder
            - not_acceptable
            - not_found
            - not_implemented
            - onboarding_already_completed
            - onboarding_requirements_missing
            - open_in_terminal
            - org_id_required
            - org_role_insufficient
            - org_suspended
            - payment_required
            - pending_input_answered
            - permission_prompt_answered_in_terminal
            - permission_prompt_expired
            - permission_prompt_open
            - permission_prompt_stopped
            - pr_automation_unsupported
            - pr_review_actor_required
            - pr_review_connection_spent
            - pr_review_publish_forbidden
            - precondition_failed
            - project_archived
            - project_has_no_repository
            - project_repo_disconnected
            - project_repository_differs
            - project_required
            - pull_request_closed
            - pull_request_mirror_failed
            - pull_request_not_mirrored
            - push_failed
            - push_file_too_large
            - push_rejected
            - push_secret_detected
            - question_answers
            - question_shortened
            - queue_for_later_unsupported
            - queued_stop_requires_discard
            - rate_limited
            - reasoning_effort_fixed
            - repository_administration_not_granted
            - repository_already_connected
            - repository_create_forbidden
            - repository_create_rejected
            - repository_created_not_linked
            - repository_not_connected
            - repository_owner_not_caller
            - request_canceled
            - request_expired
            - request_timeout
            - request_too_large
            - review_name_follows_pull_request
            - sandbox_deleted
            - sandbox_failed
            - sandbox_needs_message
            - save_in_progress
            - save_requires_task_creator
            - service_unavailable
            - session_file_missing
            - session_gone
            - session_not_started_by_aether
            - slash_command
            - slash_commands_unsupported
            - stack_cycle
            - stack_too_large
            - stack_two_parents
            - stale_execution
            - stale_or_indeterminate
            - stale_pending_input
            - stream_delivery_gap
            - stream_event_conflict
            - task_already_saved
            - task_archived
            - task_awaiting_message
            - task_awaiting_tool_response
            - task_backed_by_work_tree
            - task_bound_at_creation
            - task_branch_diverged
            - task_branch_is_default
            - task_branch_mismatch
            - task_branch_missing
            - task_connection_disconnected
            - task_creator_deleted
            - task_executing
            - task_file_too_large
            - task_has_no_branch
            - task_has_no_commits
            - task_has_no_files
            - task_has_no_repository
            - task_history_has_merges
            - task_ineligible
            - task_is_child
            - task_not_accepting_messages
            - task_not_pinnable
            - task_not_started
            - task_rebase_in_progress
            - task_settings_changed
            - task_start_failed
            - task_start_pending
            - teleport_unavailable
            - terminal_chat
            - terminal_chat_continuation_refused
            - terminal_chat_run_running
            - terminal_question
            - too_large
            - too_many_live_connections
            - too_many_waiting_messages
            - turn_running
            - unauthenticated
            - unsigned_aether_head
            - unsigned_commit
            - unsupported_changes
            - unsupported_media_type
            - untyped_error
            - user_suspended
            - validation_failed
            - working_tree_dirty
            - workspace_git_unavailable
            - workspace_gone
            - workspace_outdated
            - workspace_rejected
            - workspace_start_failed
          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
            - grant_scope_insufficient
          type: string
        error:
          minLength: 1
          type: string
      required:
        - error
        - code
      type: object
    StartOption:
      additionalProperties: false
      properties:
        agent_label:
          description: The agent's label.
          minLength: 1
          type: string
        agent_type:
          $ref: '#/components/schemas/AgentType'
        can:
          $ref: '#/components/schemas/StartAbilities'
        choices:
          $ref: '#/components/schemas/StartChoices'
        defaults:
          $ref: '#/components/schemas/StartDefaults'
        machine:
          $ref: '#/components/schemas/StartMachine'
        machine_label:
          description: The machine's label.
          minLength: 1
          type: string
      required:
        - machine
        - machine_label
        - can
        - agent_type
        - agent_label
        - choices
        - defaults
      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
    AgentType:
      description: >-
        The agent harness that runs a task, a profile or a connection:
        claude-code or claude_code is Claude Code, codex is Codex, opencode is
        OpenCode.
      enum:
        - codex
        - claude-code
        - opencode
        - claude_code
      type: string
    StartAbilities:
      additionalProperties: false
      description: >-
        What the caller can do with a start option as things stand: start,
        starting a task or chat with it now; compose, what its first message may
        carry; change_pr_automation, whether the pull-request switches
        (auto_fix_ci, auto_fix_pr_comments, auto_rebase, post_pr_screenshots,
        post_pr_demo_video, merge_when_ready) apply.
      properties:
        change_pr_automation:
          $ref: '#/components/schemas/Ability'
        compose:
          $ref: '#/components/schemas/ComposeAbilities'
        start:
          $ref: '#/components/schemas/Ability'
      required:
        - start
        - compose
        - change_pr_automation
      type: object
    StartChoices:
      additionalProperties: false
      properties:
        attachment_types:
          description: The media types a message may attach.
          items:
            type: string
          type: array
        interaction_modes:
          items:
            $ref: '#/components/schemas/ChoiceInteractionMode'
          type: array
        models:
          description: Each model with the thinking levels it takes.
          items:
            $ref: '#/components/schemas/ChoiceModel'
          type: array
      required:
        - models
        - interaction_modes
        - attachment_types
      type: object
    StartDefaults:
      additionalProperties: false
      description: >-
        What a picker starts on: the agent's own default model, thinking level
        and mode, the same in every project. Never a project's stored
        task_defaults, which a project read carries.
      properties:
        interaction_mode:
          description: The agent's default mode.
          pattern: ^[a-z][a-z0-9_]{0,31}$
          type: string
        model:
          description: The agent's default model.
          pattern: ^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$
          type: string
        reasoning_effort:
          description: >-
            The agent's default thinking level, which a picker starts on; null
            when the default model takes none. A request may also send no level:
            the model's default_reasoning_effort says what that means.
          pattern: ^[a-z][a-z0-9_]{0,31}$
          type:
            - string
            - 'null'
      required:
        - model
        - reasoning_effort
        - interaction_mode
      type: object
    StartMachine:
      description: >-
        Where a start option runs, a union on kind: sandbox, a cloud sandbox
        Aether runs, or computer, one of the caller's own computers. Options
        with an equal machine are one place, offered once with a choice of
        agent.
      discriminator:
        mapping:
          computer: '#/components/schemas/StartMachineComputer'
          sandbox: '#/components/schemas/StartMachineSandbox'
        propertyName: kind
      oneOf:
        - $ref: '#/components/schemas/StartMachineSandbox'
        - $ref: '#/components/schemas/StartMachineComputer'
    Ability:
      discriminator:
        mapping:
          available: '#/components/schemas/AbilityAvailable'
          not_now: '#/components/schemas/AbilityNotNow'
          not_permitted: '#/components/schemas/AbilityNotPermitted'
          unsupported: '#/components/schemas/AbilityUnsupported'
        propertyName: availability
      oneOf:
        - $ref: '#/components/schemas/AbilityAvailable'
        - $ref: '#/components/schemas/AbilityNotNow'
        - $ref: '#/components/schemas/AbilityUnsupported'
        - $ref: '#/components/schemas/AbilityNotPermitted'
    ComposeAbilities:
      additionalProperties: false
      description: >-
        What a message to a chat, or a new chat, may carry: attach, files
        attached to a message; reference_files, files of the repository a
        message references; use_slash_commands, a message that starts with /;
        change_model, the chat's model; change_reasoning_effort, its thinking
        level; change_interaction_mode, its mode; change_connection, the
        inference account it runs on.
      properties:
        attach:
          $ref: '#/components/schemas/Ability'
        change_connection:
          $ref: '#/components/schemas/Ability'
        change_interaction_mode:
          $ref: '#/components/schemas/Ability'
        change_model:
          $ref: '#/components/schemas/Ability'
        change_reasoning_effort:
          $ref: '#/components/schemas/Ability'
        reference_files:
          $ref: '#/components/schemas/Ability'
        use_slash_commands:
          $ref: '#/components/schemas/Ability'
      required:
        - attach
        - change_connection
        - change_interaction_mode
        - change_model
        - change_reasoning_effort
        - reference_files
        - use_slash_commands
      type: object
    ChoiceInteractionMode:
      additionalProperties: false
      properties:
        id:
          description: >-
            The mode's id, what a request names as interaction_mode: an open
            string.
          pattern: ^[a-z][a-z0-9_]{0,31}$
          type: string
        label:
          minLength: 1
          type: string
      required:
        - id
        - label
      type: object
    ChoiceModel:
      additionalProperties: false
      properties:
        default_reasoning_effort:
          anyOf:
            - $ref: '#/components/schemas/ChoiceWords'
            - type: 'null'
          description: >-
            What a null thinking level means for this model, with the words to
            show for it; null when the model takes no thinking level.
        id:
          description: 'The model''s id, what a request names: an open string.'
          pattern: ^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$
          type: string
        label:
          minLength: 1
          type: string
        reasoning_efforts:
          description: The thinking levels the model takes; empty when it takes none.
          items:
            $ref: '#/components/schemas/ChoiceReasoningEffort'
          type: array
        selectable:
          description: >-
            False for a model a chat of the task holds that no new selection may
            name: it is listed so its label can be shown.
          type: boolean
      required:
        - id
        - label
        - selectable
        - reasoning_efforts
        - default_reasoning_effort
      type: object
    StartMachineComputer:
      additionalProperties: false
      description: One of the caller's own computers.
      properties:
        computer_id:
          format: uuid
          type: string
        kind:
          enum:
            - computer
          type: string
      required:
        - kind
        - computer_id
      type: object
    StartMachineSandbox:
      additionalProperties: false
      description: A cloud sandbox Aether runs.
      properties:
        kind:
          enum:
            - sandbox
          type: string
      required:
        - kind
      type: object
    AbilityAvailable:
      additionalProperties: false
      description: The action will be carried out.
      properties:
        availability:
          enum:
            - available
          type: string
        notes:
          description: >-
            What a person reads before taking the action; empty when there is
            nothing to note.
          items:
            $ref: '#/components/schemas/AbilityMessage'
          type: array
      required:
        - availability
        - notes
      type: object
    AbilityNotNow:
      additionalProperties: false
      description: The action is possible for this chat or task, but not as things stand.
      properties:
        availability:
          enum:
            - not_now
          type: string
        reason:
          $ref: '#/components/schemas/AbilityMessage'
      required:
        - availability
        - reason
      type: object
    AbilityNotPermitted:
      additionalProperties: false
      description: The caller may not take the action.
      properties:
        availability:
          enum:
            - not_permitted
          type: string
        reason:
          $ref: '#/components/schemas/AbilityMessage'
      required:
        - availability
        - reason
      type: object
    AbilityUnsupported:
      additionalProperties: false
      description: >-
        The action is not possible for this chat or task as it is, and nothing
        the person does here changes that.
      properties:
        availability:
          enum:
            - unsupported
          type: string
        reason:
          $ref: '#/components/schemas/AbilityMessage'
      required:
        - availability
        - reason
      type: object
    ChoiceWords:
      additionalProperties: false
      description: 'The words shown for a choice: its label and a one-sentence description.'
      properties:
        description:
          minLength: 1
          type: string
        label:
          minLength: 1
          type: string
      required:
        - description
        - label
      type: object
    ChoiceReasoningEffort:
      additionalProperties: false
      properties:
        description:
          minLength: 1
          type: string
        id:
          description: >-
            The level's id, what a request names as reasoning_effort: an open
            string.
          pattern: ^[a-z][a-z0-9_]{0,31}$
          type: string
        label:
          minLength: 1
          type: string
        selectable:
          description: >-
            False for a level a chat of the task holds that no new selection may
            name: it is listed so its label can be shown.
          type: boolean
      required:
        - id
        - label
        - description
        - selectable
      type: object
    AbilityMessage:
      additionalProperties: false
      description: >-
        A note on an available ability, or the reason a refused ability is
        refused.
      properties:
        code:
          description: >-
            What the note or reason is, as a code a client may branch on. An
            open set: a client shows the message of a code it does not know.
          pattern: ^[a-z][a-z0-9_]*$
          type: string
        message:
          description: A full sentence in plain text, written for the person who reads it.
          maxLength: 200
          minLength: 1
          type: string
          x-aether-string-length-unit: unicode-code-point
      required:
        - code
        - message
      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.