Update your own service

PATCH/v1/services/{service_id}

Partial update. Omitted fields are left unchanged. Requires a signed-in developer who is a member of the owner named in X-Varis-Owner-Identifier, and the service must belong to that owner.

slug is immutable. Publishing under a new slug creates a second service.

Headers

AuthorizationBearer <token>required

A device token, prefixed var_dt_, issued by varis login to one machine and stored there. Identifies the human; carries no permissions of its own. Expires 180 days after its last use, and can be revoked from the dashboard.

X-Varis-Owner-Identifierstringrequired

The owner the developer is acting for, from varis.json. Only accepted when the device token's user is a member of it.

Body

application/json

namestring

descriptionstring

instructionsstring | null

Omitted means unchanged. null or an empty string removes them.

service_typeenum<string>

What shape of thing this is, as opposed to what domain it is about. Categories answer the domain question. A market data feed is service_type data with categories finance, media, and politics.

Available options: data, content, tool, skill, compute, memory, storage, model, messaging

categoriesenum<string>[]

Replaces the existing list wholesale, so a shorter list removes categories.

Available options: accounting, advertising, aerospace, agents, agriculture, ai, analytics, animation, apis, architecture, art, astrology, astronomy, audio, audio-processing, authentication, automation, automotive, aviation, banking, beauty, biology, biotech, blockchain, books, branding, browser-automation, business-intelligence, calendar, careers, census, charity, chemistry, civil-engineering, climate, clinical-trials, cloud, code-generation, code-review, collaboration, comics, commodities, compliance, computer-vision, construction, consulting, contracts, copywriting, credit, crm, crypto, culture, customer-support, databases, datasets, dating, defense, demographics, design, developer-tools, devops, diy, documents, earth-science, ecology, ecommerce, economics, education, elections, electrical-engineering, email, embeddings, employment, energy, entertainment, environment, esports, evaluation, events, family, fashion, file-conversion, film, finance, fitness, food, forex, fraud-detection, gaming, gardening, genealogy, genomics, geolocation, geopolitics, geospatial, governance, government, graphic-design, hardware, health, healthcare, higher-education, history, home, hospitality, housing, human-resources, human-rights, humor, identity-verification, image-generation, image-processing, immigration, infrastructure, insurance, intellectual-property, international-relations, inventory, investing, invoicing, iot, journalism, k12, knowledge-base, kyc, language-learning, law-enforcement, legal, lending, lifestyle, llm, localization, logistics, machine-learning, manufacturing, maps, maritime, market-research, marketing, marketplace, materials-science, mathematics, mechanical-engineering, media, medical-imaging, medicine, mental-health, military, mobile-development, monitoring, mortgage, music, networking, news, nlp, nonprofit, notifications, nutrition, observability, ocr, oil-and-gas, open-data, open-source, outdoors, parenting, patents, payments, payroll, pdf, personal-finance, pets, pharmaceuticals, philosophy, photography, physics, podcasts, policy, politics, pricing, privacy, procurement, productivity, project-management, prompts, psychology, public-health, public-records, public-relations, public-safety, public-transit, publishing, quantum-computing, real-estate, recipes, recruiting, reference, relationships, religion, renewable-energy, research, restaurants, retail, robotics, sales, sanctions, scheduling, science, scraping, search, security, semiconductors, seo, shipping, shopping, small-business, sms, social-media, sociology, software-engineering, space, speech, sports, startups, statistics, stocks, supply-chain, sustainability, tax, telecommunications, television, testing, text-to-speech, ticketing, time-series, trading, transcription, translation, transportation, travel, ui-design, urban-planning, utilities, vector-search, venture-capital, veterinary, video, video-processing, weather, web-development, web3, wellness, writing

endpoint_urlstring<uri>

No query string or fragment.

methodobject

Omitted means unchanged. Switching to GET is a 400 when the stored or submitted input_schema is not flat.

price_centsinteger

Your price, in US cents. Takes effect on the next invocation. Agents pay this plus the 5% Varis fee.

versionstring

statusenum<string>

draft is not discoverable and not invocable. published is both. disabled stops new invocations without removing the service from anyone's transaction history.

Available options: draft, published, disabled

input_schemaobject

output_schemaobject

Response

application/json

The updated service.

idstringrequired

Pass this to /v1/invoke, not the slug.

slugstringrequired

namestringrequired

descriptionstringrequired

instructionsstring | nullrequired

How to use the service, from its provider. Read it before invoking: it may name another service to call first. null when the provider gave none.

service_typeenum<string>required

What shape of thing this is, as opposed to what domain it is about. Categories answer the domain question. A market data feed is service_type data with categories finance, media, and politics.

Available options: data, content, tool, skill, compute, memory, storage, model, messaging

provider_namestring

The publishing owner's display name.

versionstring

categoriesenum<string>[]

input_schemaobjectrequired

output_schemaobjectrequired

statusenum<string>required

draft is not discoverable and not invocable. published is both. disabled stops new invocations without removing the service from anyone's transaction history.

Available options: draft, published, disabled

endpoint_urlstring<uri>

Returned only to the service's own owner.

methodobject

Returned only to the service's own owner.

created_atstring<date-time>

updated_atstring<date-time>

price_centsintegerrequired

Your price per invocation, in US cents. Agents pay this plus the 5% Varis fee; you receive all of it.

curl -X PATCH 'https://api.usevaris.com/v1/services/var_serv_ydZfZ9gKKe1tQe' \  -H 'Content-Type: application/json' \  -d '{}'

{  "id": "string",  "slug": "string",  "name": "string",  "description": "string",  "instructions": "string",  "service_type": "data",  "provider_name": "string",  "version": "string",  "categories": [    "accounting"  ],  "input_schema": {},  "output_schema": {},  "status": "draft",  "endpoint_url": "http://example.com",  "method": "GET",  "created_at": "2019-08-24T14:15:22Z",  "updated_at": "2019-08-24T14:15:22Z",  "price_cents": 0}