aria.provision

Create a draft hosted MCP service owned by the calling organization.

Create a draft hosted MCP service.

Overview

Property	Value
Workflow type	Atomic
Library	App-aria
Version	1.0

Input Schema

Field	Type	Required	Default	Description
slug	string	Yes	—	Endpoint path segment (/t/<slug>/mcp). Immutable after the first publish.
display_name	string	Yes	—	What the service calls itself
instructions	string	No	—	The service's voice. Required before it can be published.
locale	string	No	—	Default pt-BR

Output Schema

Field	Type	Required	Default	Description
service	json	No	—	The service after the change
failure_reason	string	No	—	—
failed_at_state	string	No	—	—
failed_step	json	No	—	—
failed_layer	integer	No	—	—
error	string	No	—	—
error_type	string	No	—	—
failed_at	string	No	—	—

States

State	Initial	Terminal	Success	Auto-advance	Description
pending	Yes	No	—	execute	—
completed	No	Yes	Yes	—	—
failed	No	Yes	No	—	—

State Diagram

Transitions

From	Action	To	Description
pending	execute	completed	—
* (any state)	fail	failed	—

Outcomes

Outcome	Type	Description	State Data Keys
provisioned	SUCCESS	The draft service was created	service
failed	FAILURE	The action was refused or failed	failure_reason

Business Errors

Code	Message Template
ARIA_SLUG_UNAVAILABLE	That slug is taken, reserved, or not a usable endpoint path segment
ARIA_REFUSED	The action was refused

API Usage

POST /api/workflows/start
Content-Type: application/json

{
  "workflow_type": "aria.provision",
  "initial_data": {
    "slug": "value",
    "display_name": "value"
  }
}