---
title: "Set all AI agent configurations"
method: PUT
path: "/api/v1/layout/agents"
tags: ["Organization - Declarative APIs"]
---

# Set all AI agent configurations

`PUT /api/v1/layout/agents`

## Request

- Base URL: `https://www.gooddata.ai`
- URL: `https://www.gooddata.ai/api/v1/layout/agents`
- Auth: none declared

Sets AI agent configurations in organization.

## Request body

- DeclarativeAgents: AI agent configurations.
  - `agents` DeclarativeAgent[], required
    - `aiKnowledge` boolean: Whether AI knowledge is enabled.
    - `availableToAll` boolean: Whether the agent is available to all users.
    - `createdAt` string, nullable: Time of the entity creation.
    - `createdBy` DeclarativeUserIdentifier: A user identifier.
      - `id` string, required: User identifier.
      - `type` 'user', required: A type.
    - `customSkills` string[]: List of custom skills when skillsMode is CUSTOM.
    - `description` string: Description of the agent.
    - `enabled` boolean: Whether the agent is enabled.
    - `id` string, required: Identifier of an agent.
    - `instructions` Instruction[], nullable: Rules this agent follows when answering.
      - `content` string, required: The rule the agent follows when answering
      - `isDisabled` boolean, nullable: Whether the instruction is disabled
      - `strategy` 'ALWAYS' | 'AUTO', required: When an instruction is applied to a request
      - `title` string, nullable: Short name shown in the agent builder.
    - `modifiedAt` string, nullable: Time of the last entity modification.
    - `modifiedBy` DeclarativeUserIdentifier: A user identifier.
      - `id` string, required: User identifier.
      - `type` 'user', required: A type.
    - `name` string: Name of the agent.
    - `personality` string: Personality instructions for the agent.
    - `skillsMode` 'all' | 'custom': Skills mode: ALL or CUSTOM.
    - `userGroups` DeclarativeUserGroupIdentifier[]: User groups this agent is assigned to.
      - `id` string, required: Identifier of the user group.
      - `type` 'userGroup', required: A type.

## Response `204`

All AI agent configurations set.

---

[API](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api.md) - [All operations](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api/revisions/c728ef303bfb?raw)