---
title: "Push Team Config"
method: POST
path: "/api/v1/teams/config"
tags: ["teams"]
---

# Push Team Config

`POST /api/v1/teams/config`

## Request

- Base URL: `https://api.gnosari.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gnosari.com/api/v1/teams/config`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-AUTH-TOKEN`

Create a team from comprehensive JSON configuration.

Accepts JSON with complete modular team configuration including:
- Agents with events, traits, delegations
- Tools with MCP server configurations
- Knowledge sources with processing configurations
- Traits with categories and tags
- Hierarchical overrides
- Component inclusion/exclusion filters

Authentication:
- JWT Token: Authorization: Bearer <jwt_token>
- API Key: X-AUTH-TOKEN: <api_key>

Note: Master API keys cannot create teams. Use an account-specific API key or JWT token.

## Request body

- TeamConfigSchemaInput
  - `id` string, required
  - `name` string, required
  - `description` string, nullable
  - `version` string
  - `tags` string[]
  - `config` object, nullable
  - `agents` AgentConfigSchemaInput[], required
    - `id` string, required
    - `name` string, nullable
    - `description` string, nullable
    - `instructions` string, required
    - `model` string, nullable
    - `temperature` number
    - `reasoning_effort` string
    - `orchestrator` boolean
    - `memory` string, nullable
    - `tools` string[]
    - `knowledge` string[]
    - `traits` union[]
      - union
        - string
        - TraitReferenceSchema
          - `name` string, required
          - `weight` number, nullable
    - `delegation` DelegationConfigSchema[]
      - `agent` string, required
      - `instructions` string, required
    - `events` EventConfigSchema[]
      - `id` string, required: Event identifier (e.g., 'conversation.completed')
      - `name` string, nullable: Display name
      - `description` string, nullable: What this event signals
      - `trigger` string, required: Instructions for when to emit
      - `metadata_schema` object, nullable: JSON schema for payload
    - `emits` string[]
    - `publication` PublicationConfigSchemaInput: Publication configuration for agent visibility.
      - `access_level` string, required: Agent visibility level
      - `chat_uri` string, nullable: URI slug for public access
      - `domain` string, nullable: Domain name (must exist in account)
      - `password` string, nullable: Password for password_protected access (write-only, never returned in responses)
    - `image_url` string, nullable
    - `configuration` object, nullable
    - `chat_ui` ChatUIConfigSchema: Chat UI configuration from push payload.
      - `image_url` string, nullable
      - `empty_title` string, nullable
      - `empty_description` string, nullable
      - `greeting` string, nullable
      - `suggested_prompts` CoreSchemasTeamConfigSuggestedPromptSchema[], nullable
        - `icon` string, nullable
        - `title` string, required
        - `text` string, required
  - `tools` ToolConfigSchema[], nullable
    - `id` string, required
    - `name` string, nullable
    - `description` string, nullable
    - `module` string, nullable
    - `class_name` string, nullable
    - `url` string, nullable
    - `command` string, nullable
    - `connection_type` string, nullable
    - `args` union
      - object
      - unknown[]
        - unknown
    - `headers` object, nullable
    - `timeout` integer, nullable
  - `knowledge` KnowledgeConfigSchema[], nullable
    - `id` string, required
    - `name` string, nullable
    - `description` string, nullable
    - `type` string, required
    - `data` string[], required
    - `config` object, nullable
  - `prompts` PromptConfigSchema[], nullable
    - `id` string, required
    - `template` string, nullable
    - `content` string, nullable
    - `instructions` string, nullable
    - `variables` object, nullable
  - `traits` TraitConfigSchema[], nullable
    - `id` string, required
    - `name` string, required
    - `description` string, nullable
    - `instructions` string, required
    - `weight` number
    - `category` string, nullable
    - `tags` string[]
  - `events` EventConfigSchema[], nullable
    - `id` string, required: Event identifier (e.g., 'conversation.completed')
    - `name` string, nullable: Display name
    - `description` string, nullable: What this event signals
    - `trigger` string, required: Instructions for when to emit
    - `metadata_schema` object, nullable: JSON schema for payload
  - `overrides` object, nullable
  - `components` object, nullable
  - `created_at` string, date-time, nullable
  - `updated_at` string, date-time, nullable
  - `created_by` string, nullable

## Response `200`

Successful Response

- Team: Full team schema with database fields and agent list.
  - `name` string, required
  - `description` string, nullable
  - `identifier` string, nullable
  - `parameters` unknown[], nullable
    - unknown
  - `image` string, nullable
  - `version` string
  - `tags` string[]
  - `config` object, nullable
  - `components_include` string[], nullable
  - `components_exclude` string[], nullable
  - `created_by` string, nullable
  - `access_level` 'PRIVATE' | 'PASSWORD_PROTECTED' | 'PUBLIC'
  - `access_password` string, nullable
  - `suggested_prompts` SuggestedPromptsConfigSchema: Schema for suggested prompts configuration. Used in Agent and Team create/update operations. Provides a complete configuration including enabled state and the list of prompts.
    - `enabled` boolean: Whether to show suggested prompts in chat
    - `prompts` CoreSchemasSuggestedPromptSuggestedPromptSchema[]: List of suggested prompts (max 8)
      - `id` union, required: Unique identifier for the prompt
        - integer
        - string
      - `icon` string: Heroicons icon name (e.g., 'i-heroicons-light-bulb')
      - `title` string, required: Short title displayed on the prompt button
      - `text` string, required: The actual prompt text sent when clicked
  - `id` integer, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, nullable
  - `agents` Agent[]

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/gnosari/apis/gnosari-api.md) · [All operations](https://skmtc.dev/gnosari/apis/gnosari-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gnosari/apis/gnosari-api/revisions/f299cf53ae5f?raw)