---
title: "Create Service Endpoint"
method: POST
path: "/v1/services"
tags: ["services"]
---

# Create Service Endpoint

`POST /v1/services`

## Request

- Base URL: `https://docs.xenarch.com` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.xenarch.com/v1/services`
- Auth: none declared. Required headers: `authorization`

Register a new service for agent discovery.

## Headers

- `authorization` string, required

## Request body

- ServiceCreateRequest
  - `name` string, required
  - `url` string, required
  - `description` string
  - `price_per_request` union, required
    - number
    - string
  - `category` string
  - `pay_json_url` string, nullable

## Response `201`

Successful Response

- ServiceResponse
  - `id` string, uuid, required
  - `publisher_id` string, uuid, required
  - `name` string, required
  - `url` string, required
  - `description` string, required
  - `price_per_request` string, required
  - `category` string, required
  - `pay_json_url` string, nullable, required
  - `is_active` boolean, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/xenarch/apis/xenarch-platform.md) · [All operations](https://skmtc.dev/xenarch/apis/xenarch-platform/llms.txt) · [OpenAPI document](https://skmtc.dev/xenarch/apis/xenarch-platform/revisions/88121faafcbf?raw)