---
title: "Update DAG settings"
method: PUT
path: "/dags/{fileName}/settings"
tags: ["dags"]
---

# Update DAG settings

`PUT /dags/{fileName}/settings`

Creates or replaces server-side settings for a specific DAG. Manager or admin only; protected profiles require admin.

## Path parameters

- `fileName` string, regex, required — Name of the DAG file

## Query parameters

- `remoteNode` string

## Request body

- UpdateDAGSettingsRequest — Request to replace DAG settings. Omit `profile` to clear the DAG default profile.
  - `profile` string — Runtime profile name.

## Response `200`

DAG settings updated

- DAGSettings — Server-side DAG settings
  - `dagName` string, required — DAG file identifier these settings apply to
  - `profile` string — Runtime profile name.
  - `updatedAt` string, date-time
  - `updatedBy` string — User ID that last updated the settings

## Other responses

- `400` — Invalid DAG settings
- `403` — Forbidden - insufficient permissions
- `404` — DAG or runtime profile not found
- `default` — Unexpected error

---

[API](https://skmtc.net/dagucloud/apis/dagu.md) · [All operations](https://skmtc.net/dagucloud/apis/dagu/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dagucloud/dagu/revisions/93cc41f2018a/schema)