Service Tools

create_service

Create and deploy a service. Use host='ink' (default) for Ink managed repos or host='github' for GitHub.

Parameter	Type	Required	Default	Description
`name`	string	yes	—	Name for the deployment
`repo`	string	yes	—	Repository as returned by `create_repo` (e.g. `ink/myapp` or `user/myapp`)
`workspace`	string	no	`default`	Workspace slug
`project`	string	no	`default`	Project name
`host`	string	no	`ink`	Git host. Values: `ink`, `github`
`branch`	string	no	`main`	Branch to deploy
`region`	string	no	`eu-central-1`	Cluster region. Values: `eu-central-1`
`build_pack`	string	no	`railpack`	Build strategy. Values: `railpack`, `dockerfile`, `static`, `dockercompose`. `railpack` auto-detects and builds most apps. `static` serves files as-is with no build step. `dockerfile` uses a custom Dockerfile. Use `railpack` with `publish_directory` for Vite/React/Vue SPAs that need a build step then static serving via nginx.
`port`	integer	no	—	Port the application listens on
`env_vars`	array	no	—	Environment variables. Each element: `{ "key": "...", "value": "..." }`
`memory`	string	no	`256Mi`	Memory limit. Values: `256Mi`, `512Mi`, `1024Mi`, `2048Mi`, `4096Mi`
`vcpus`	string	no	`0.25`	vCPUs. Values: `0.25`, `0.5`, `1`, `2`, `4`
`build_command`	string	no	—	Custom build command (overrides auto-detected). Only used with `build_pack=railpack`
`start_command`	string	no	—	Custom start command (overrides auto-detected). Only used with `build_pack=railpack`
`publish_directory`	string	no	—	Directory containing built static files (e.g. `dist`). When set with `build_pack=railpack`, the app is built then served as static files via nginx. Recommended for Vite/React/Vue SPAs
`root_directory`	string	no	—	Subdirectory within the repo to use as build context (e.g. `frontend` or `services/api`). For monorepo deployments
`dockerfile_path`	string	no	—	Path to Dockerfile relative to `root_directory` (e.g. `worker.Dockerfile`). Only used with `build_pack=dockerfile`

Returns: service_id, name, status, repo, message with workflow ID

list_services

List all deployed services with their status and URLs.

Parameter	Type	Required	Default	Description
`workspace`	string	no	`default`	Workspace slug

Returns: Array of services with service_id, name, repo, status, url

get_service

Get full service details including status, URL, environment variables, and logs. This is the primary tool for observing and debugging deployed applications.

Status values: queued, building, deploying, active, failed, cancelled, superseded, crashed, completed, removed

Parameter	Type	Required	Default	Description
`name`	string	yes	—	Service name
`workspace`	string	no	`default`	Workspace slug
`project`	string	no	`default`	Project name
`include_env`	boolean	no	`false`	Include environment variables in response
`deploy_log_lines`	integer	no	`0`	Number of deployment log lines to fetch (max 500)
`runtime_log_lines`	integer	no	`0`	Number of runtime log lines to fetch (max 500)

Returns: service_id, name, project, repo, branch, status, error_message, url, created_at, updated_at, deploy_logs, runtime_logs, env_vars, custom_domain

update_service

Update configuration of an existing service and redeploy. Only specify fields you want to change. Can also be used to redeploy without changes (e.g. to pull latest code).

Parameter	Type	Required	Default	Description
`name`	string	yes	—	Name of the service to update
`workspace`	string	no	`default`	Workspace slug
`project`	string	no	`default`	Project name
`repo`	string	no	—	New repository name
`host`	string	no	—	Git host for new repo. Values: `ink`, `github`
`branch`	string	no	—	Branch to deploy
`port`	integer	no	—	Port the application listens on
`env_vars`	array	no	—	Environment variables (replaces all existing). Each element: `{ "key": "...", "value": "..." }`
`build_pack`	string	no	—	Build strategy. Values: `railpack`, `dockerfile`, `static`, `dockercompose`
`memory`	string	no	—	Memory limit. Values: `256Mi`, `512Mi`, `1024Mi`, `2048Mi`, `4096Mi`
`vcpus`	string	no	—	vCPUs. Values: `0.25`, `0.5`, `1`, `2`, `4`
`build_command`	string	no	—	Custom build command. Only used with `build_pack=railpack`
`start_command`	string	no	—	Custom start command. Only used with `build_pack=railpack`
`publish_directory`	string	no	—	Directory containing built static files (e.g. `dist`). When set with `build_pack=railpack`, the app is built then served as static files via nginx
`root_directory`	string	no	—	Subdirectory within the repo to use as build context
`dockerfile_path`	string	no	—	Path to Dockerfile relative to `root_directory`. Only used with `build_pack=dockerfile`

Returns: service_id, name, status, message

delete_service

Permanently delete a service and stop its container. This action is irreversible.

Parameter	Type	Required	Default	Description
`name`	string	yes	—	Name of the service to delete
`workspace`	string	no	`default`	Workspace slug
`project`	string	no	`default`	Project name

Returns: service_id, name, message