---
title: "Create new service"
method: POST
path: "/services/"
tags: ["Services"]
---

# Create new service

`POST /services/`

## Request body

- ModelsService
  - `hash` string, required
  - `id` integer
  - `info` ModelsServiceInfo
    - `db` ModelsServiceInfoDB, required
      - `host` string, required
      - `name` string, required
      - `pass` string, required
      - `port` integer, required
      - `user` string, required
    - `s3` ModelsServiceInfoS3, required
      - `access_key` string, required
      - `bucket_name` string, required
      - `endpoint` string, required
      - `secret_key` string, required
    - `server` ModelsServiceInfoServer, required
      - `host` string, required
      - `port` integer, required
      - `proto` 'ws' | 'wss', required
  - `name` string, required
  - `status` 'created' | 'active' | 'blocked' | 'removed', required
  - `tenant_id` integer
  - `type` 'vxmonitor', required

## Response `201`

service created successful

- object
  - `data` object
    - `hash` string, required
    - `id` integer
    - `info` ModelsServiceInfo
      - `db` ModelsServiceInfoDB, required
        - `host` string, required
        - `name` string, required
        - `pass` string, required
        - `port` integer, required
        - `user` string, required
      - `s3` ModelsServiceInfoS3, required
        - `access_key` string, required
        - `bucket_name` string, required
        - `endpoint` string, required
        - `secret_key` string, required
      - `server` ModelsServiceInfoServer, required
        - `host` string, required
        - `port` integer, required
        - `proto` 'ws' | 'wss', required
    - `name` string, required
    - `status` 'created' | 'active' | 'blocked' | 'removed', required
    - `tenant_id` integer
    - `type` 'vxmonitor', required
  - `status` string

## Other responses

- `400` — invalid service request data
- `403` — creating service not permitted
- `500` — internal error on creating service

---

[API](https://skmtc.net/vxcontrol/apis/soldr-swagger-api.md) · [All operations](https://skmtc.net/vxcontrol/apis/soldr-swagger-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vxcontrol/soldr-swagger-api/versions/ac519ec936b3/schema)