---
title: "Create Peer"
method: POST
path: "/api/v1/peers"
tags: ["Peer"]
---

# Create Peer

`POST /api/v1/peers`

Create by json config

## Request body

- D7yIoDragonflyV2ManagerTypesCreatePeerRequest
  - `build_platform` string
  - `download_port` integer, required
  - `git_commit` string
  - `git_version` string
  - `host_name` string, required
  - `idc` string
  - `ip` string, required
  - `kernel_version` string
  - `location` string
  - `object_storage_port` integer
  - `os` string
  - `platform` string
  - `platform_family` string
  - `platform_version` string
  - `port` integer, required
  - `proxy_port` integer, required
  - `scheduler_cluster_id` integer, required
  - `state` 'active' | 'inactive'
  - `type` 'super' | 'normal', required

## Response `200`

OK

- D7yIoDragonflyV2ManagerModelsPeer
  - `build_platform` string
  - `created_at` string
  - `download_port` integer
  - `git_commit` string
  - `git_version` string
  - `host_name` string
  - `id` integer
  - `idc` string
  - `ip` string
  - `is_del` integer
  - `kernel_version` string
  - `location` string
  - `object_storage_port` integer
  - `os` string
  - `platform` string
  - `platform_family` string
  - `platform_version` string
  - `port` integer
  - `proxy_port` integer
  - `scheduler_cluster` D7yIoDragonflyV2ManagerModelsSchedulerCluster
    - `bio` string
    - `client_config` D7yIoDragonflyV2ManagerModelsJSONMap
    - `config` D7yIoDragonflyV2ManagerModelsJSONMap
    - `created_at` string
    - `id` integer
    - `is_default` boolean
    - `is_del` integer
    - `jobs` D7yIoDragonflyV2ManagerModelsJob[]
      - `args` D7yIoDragonflyV2ManagerModelsJSONMap
      - `bio` string
      - `created_at` string
      - `id` integer
      - `is_del` integer
      - `result` D7yIoDragonflyV2ManagerModelsJSONMap
      - `scheduler_clusters` D7yIoDragonflyV2ManagerModelsSchedulerCluster[]
      - `seed_peer_clusters` D7yIoDragonflyV2ManagerModelsSeedPeerCluster[]
        - `bio` string
        - `config` D7yIoDragonflyV2ManagerModelsJSONMap
        - `created_at` string
        - `id` integer
        - `is_del` integer
        - `jobs` D7yIoDragonflyV2ManagerModelsJob[]
        - `name` string
        - `scheduler_clusters` D7yIoDragonflyV2ManagerModelsSchedulerCluster[]
        - `seed_peer` D7yIoDragonflyV2ManagerModelsSeedPeer[]
          - `created_at` string
          - `download_port` integer
          - `host_name` string
          - `id` integer
          - `idc` string
          - `ip` string
          - `is_del` integer
          - `location` string
          - `object_storage_port` integer
          - `port` integer
          - `seed_peer_cluster` D7yIoDragonflyV2ManagerModelsSeedPeerCluster — recursive
          - `seed_peer_cluster_id` integer
          - `state` string
          - `type` string
          - `updated_at` string
        - `updated_at` string
      - `state` string
      - `task_id` string
      - `type` string
      - `updated_at` string
      - `user` D7yIoDragonflyV2ManagerModelsUser
        - `avatar` string
        - `bio` string
        - `configs` D7yIoDragonflyV2ManagerModelsConfig[]
          - `bio` string
          - `created_at` string
          - `id` integer
          - `is_del` integer
          - `name` string
          - `updated_at` string
          - `user` D7yIoDragonflyV2ManagerModelsUser — recursive
          - `user_id` integer
          - `value` string
        - `created_at` string
        - `email` string
        - `id` integer
        - `is_del` integer
        - `location` string
        - `name` string
        - `phone` string
        - `state` string
        - `updated_at` string
      - `user_id` integer
    - `name` string
    - `peers` D7yIoDragonflyV2ManagerModelsPeer[]
    - `schedulers` D7yIoDragonflyV2ManagerModelsScheduler[]
      - `config` D7yIoDragonflyV2ManagerModelsJSONMap
      - `created_at` string
      - `features` string[]
      - `host_name` string
      - `id` integer
      - `idc` string
      - `ip` string
      - `is_del` integer
      - `last_keep_alive_at` string
      - `location` string
      - `port` integer
      - `scheduler_cluster` D7yIoDragonflyV2ManagerModelsSchedulerCluster — recursive
      - `scheduler_cluster_id` integer
      - `state` string
      - `updated_at` string
    - `scopes` D7yIoDragonflyV2ManagerModelsJSONMap
    - `seed_peer_clusters` D7yIoDragonflyV2ManagerModelsSeedPeerCluster[]
      - `bio` string
      - `config` D7yIoDragonflyV2ManagerModelsJSONMap
      - `created_at` string
      - `id` integer
      - `is_del` integer
      - `jobs` D7yIoDragonflyV2ManagerModelsJob[]
        - `args` D7yIoDragonflyV2ManagerModelsJSONMap
        - `bio` string
        - `created_at` string
        - `id` integer
        - `is_del` integer
        - `result` D7yIoDragonflyV2ManagerModelsJSONMap
        - `scheduler_clusters` D7yIoDragonflyV2ManagerModelsSchedulerCluster[]
        - `seed_peer_clusters` D7yIoDragonflyV2ManagerModelsSeedPeerCluster[]
        - `state` string
        - `task_id` string
        - `type` string
        - `updated_at` string
        - `user` D7yIoDragonflyV2ManagerModelsUser
          - `avatar` string
          - `bio` string
          - `configs` D7yIoDragonflyV2ManagerModelsConfig[]
            - `bio` string
            - `created_at` string
            - `id` integer
            - `is_del` integer
            - `name` string
            - `updated_at` string
            - `user` D7yIoDragonflyV2ManagerModelsUser — recursive
            - `user_id` integer
            - `value` string
          - `created_at` string
          - `email` string
          - `id` integer
          - `is_del` integer
          - `location` string
          - `name` string
          - `phone` string
          - `state` string
          - `updated_at` string
        - `user_id` integer
      - `name` string
      - `scheduler_clusters` D7yIoDragonflyV2ManagerModelsSchedulerCluster[]
      - `seed_peer` D7yIoDragonflyV2ManagerModelsSeedPeer[]
        - `created_at` string
        - `download_port` integer
        - `host_name` string
        - `id` integer
        - `idc` string
        - `ip` string
        - `is_del` integer
        - `location` string
        - `object_storage_port` integer
        - `port` integer
        - `seed_peer_cluster` D7yIoDragonflyV2ManagerModelsSeedPeerCluster — recursive
        - `seed_peer_cluster_id` integer
        - `state` string
        - `type` string
        - `updated_at` string
      - `updated_at` string
    - `updated_at` string
  - `scheduler_cluster_id` integer
  - `state` string
  - `type` string
  - `updated_at` string

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/dragonflyoss/apis/dragonfly-manager.md) · [All operations](https://skmtc.net/dragonflyoss/apis/dragonfly-manager/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dragonflyoss/dragonfly-manager/revisions/d9b0d442c9f4/schema)