> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nuon.co/llms.txt
> Use this file to discover all available pages before exploring further.

# get runner settings

> Return runner settings for the provided runner.




## OpenAPI

````yaml get /v1/runners/{runner_id}/settings
openapi: 3.0.3
info:
  contact:
    email: support@nuon.co
    name: Nuon Support
  description: API for managing nuon apps, components, installs, and actions.
  title: Nuon
  version: 0.19.1037
servers:
  - url: https://api.nuon.co/
security: []
tags:
  - description: policy-reports
    name: policy-reports
  - description: general
    name: general
  - description: actions
    name: actions
  - description: runbooks
    name: runbooks
  - description: apps
    name: apps
  - description: components
    name: components
  - description: onboarding
    name: onboarding
  - description: slack
    name: slack
  - description: installs
    name: installs
  - description: orgs
    name: orgs
  - description: notebooks
    name: notebooks
  - description: runners/runner
    name: runners/runner
  - description: queues
    name: queues
  - description: actions/runner
    name: actions/runner
  - description: auth
    name: auth
  - description: runners
    name: runners
  - description: vcs
    name: vcs
  - description: accounts
    name: accounts
paths:
  /v1/runners/{runner_id}/settings:
    get:
      tags:
        - runners
      summary: get runner settings
      description: |
        Return runner settings for the provided runner.
      operationId: GetRunnerSettings
      parameters:
        - description: runner ID
          in: path
          name: runner_id
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/app.RunnerGroupSettings'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
          description: Unauthorized
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
          description: Forbidden
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
          description: Not Found
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/stderr.ErrResponse'
          description: Internal Server Error
      security:
        - APIKey: []
        - OrgID: []
components:
  schemas:
    app.RunnerGroupSettings:
      properties:
        aws_auth_method:
          enum:
            - iid
            - sts
          type: string
        aws_cloudformation_stack_type:
          type: string
        aws_instance_type:
          description: aws runner specifics runner-v2
          type: string
        aws_max_instance_lifetime:
          description: >-
            Deprecated: instance refresh is now handled by a backend cron, not
            ASG MaxInstanceLifetime.
          type: integer
        aws_tags:
          additionalProperties:
            type: string
          type: object
        binary_version:
          description: >-
            configuration for managing the runner binary version (for mng mode,
            not the install runner)
          type: string
        container_image_tag:
          type: string
        container_image_url:
          description: configuration for deploying the runner
          type: string
        container_max_uptime:
          type: integer
        created_at:
          type: string
        created_by_id:
          type: string
        enable_logging:
          type: boolean
        enable_metrics:
          type: boolean
        enable_sentry:
          type: boolean
        groups:
          description: the job loop groups the runner should poll for
          items:
            type: string
          type: array
        heart_beat_timeout:
          description: Various settings for the runner to handle internally
          type: integer
        id:
          type: string
        job_group_parallelism:
          additionalProperties:
            type: string
          description: >-
            JobGroupParallelism maps RunnerJobGroup names to max-in-flight
            counts for queue-based job routing.

            e.g., {"build": "2", "deploy": "1"}. Only used when
            parallel-runner-jobs feature flag is on.
          type: object
        local_aws_iam_role_arn:
          type: string
        logging_level:
          type: string
        long_poll_jobs:
          description: |-
            LongPollJobs mirrors the org's `runner-job-long-poll` feature flag
            so the runner can choose between the legacy idle-poll loop and the
            new long-poll endpoint at boot. Not persisted; populated by the
            runner-settings handler.
          type: boolean
        metadata:
          additionalProperties:
            type: string
          description: >-
            Metadata is used as both log and metric tags/attributes in the
            runner when emitting data
          type: object
        org_aws_iam_role_arn:
          description: org runner specifics
          type: string
        org_azure_client_id:
          type: string
        org_gcp_service_account:
          type: string
        org_id:
          type: string
        org_k8s_service_account_name:
          type: string
        otel_collector_config:
          type: string
        platform:
          description: platform variable for use in the runner
          type: string
        runner_api_url:
          type: string
        runner_binary_url:
          description: >-
            RunnerBinaryURL overrides the URL used to download the runner binary
            onto the

            host for mng mode. When empty, defaults to the S3 artifacts URL.
          type: string
        runner_group_id:
          type: string
        sandbox_mode:
          description: configuration for managing the runner server side
          type: boolean
        updated_at:
          type: string
        vm_max_uptime:
          type: integer
      type: object
    stderr.ErrResponse:
      properties:
        description:
          type: string
        error:
          type: string
        user_error:
          type: boolean
      type: object
  securitySchemes:
    APIKey:
      description: Type "Bearer" followed by a space and token.
      in: header
      name: Authorization
      type: apiKey
    OrgID:
      description: Nuon org ID
      in: header
      name: X-Nuon-Org-ID
      type: apiKey

````