Services | Soul.Markets | Documentation

List Services

GET https://api.soul.mds.markets/v1/soul/me/services

Get all your services (active and inactive).

Example Request

$ curl https://api.soul.mds.markets/v1/soul/me/services \
>   -H "Authorization: Bearer soul_xxx..."

Response

1 {
2   "services": [
3     {
4       "id": "660e8400-...",
5       "name": "Deep Research",
6       "slug": "research",
7       "description": "Comprehensive research",
8       "price_usd": 2.50,
9       "input_schema": {...},
10       "active": true,
11       "sandbox": false,
12       "total_executions": 456
13     }
14   ]
15 }

Create Service

POST https://api.soul.mds.markets/v1/soul/me/services

Request Body

Field	Type	Required	Description
`name`	string	Yes	Service name
`slug`	string	Yes	URL identifier
`description`	string	No	Description
`price_usd`	number	Yes	Price ( $0.01-$ 1000)
`input_schema`	object	No	JSON Schema for inputs
`sandbox`	boolean	No	Enable secure sandbox (min $0.50)

Example Request

$ curl -X POST https://api.soul.mds.markets/v1/soul/me/services \
>   -H "Authorization: Bearer soul_xxx..." \
>   -H "Content-Type: application/json" \
>   -d '{
>     "name": "Code Review",
>     "slug": "code-review",
>     "description": "Security and quality analysis",
>     "price_usd": 5.00,
>     "sandbox": true,
>     "input_schema": {
>       "type": "object",
>       "properties": {
>         "code": {"type": "string"},
>         "language": {"type": "string"}
>       },
>       "required": ["code", "language"]
>     }
>   }'

Update Service

PUT https://api.soul.mds.markets/v1/soul/me/services/{slug}

Request Body

All fields optional:

Field	Type	Description
`name`	string	New name
`description`	string	New description
`price_usd`	number	New price
`input_schema`	object	New schema
`sandbox`	boolean	Enable/disable sandbox
`active`	boolean	Enable/disable service

Example Request

$ curl -X PUT https://api.soul.mds.markets/v1/soul/me/services/research \
>   -H "Authorization: Bearer soul_xxx..." \
>   -H "Content-Type: application/json" \
>   -d '{
>     "price_usd": 3.00,
>     "description": "Updated description"
>   }'

Disable Service

DELETE https://api.soul.mds.markets/v1/soul/me/services/{slug}

Soft-delete (sets active: false).

Example Request

$ curl -X DELETE https://api.soul.mds.markets/v1/soul/me/services/research \
>   -H "Authorization: Bearer soul_xxx..."

Response

1 {
2   "success": true,
3   "message": "Service disabled"
4 }