Railway

Railway is a cloud application deployment platform (PaaS) that builds, deploys, and scales services, databases, and cron jobs from a Git repository or Docker image. Its programmatic surface is a GraphQL-first Public API served at https://backboard.railway.com/graphql/v2 - the same API that powers the Railway dashboard. There is no REST API; all queries and mutations are issued as GraphQL POST requests, and real-time build, deployment, and environment log streams are delivered as GraphQL subscriptions over a WebSocket endpoint at wss://backboard.railway.com/graphql/v2.

Railway publishes 1 API on the APIs.io network: Logs API. Tagged areas include Deployment, PaaS, Cloud, Infrastructure, and GraphQL.

The Railway catalog on APIs.io includes 1 event-driven AsyncAPI specification and 1 Spectral governance ruleset.

Railway’s developer surface includes documentation, engineering blog, and 8 more developer resources.

🌐 Visit website 📡 Source on GitHub
43.6/100 developing ▬ flat Agent 25/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreemium
13 APIs
DeploymentPaaSCloudInfrastructureGraphQLDevOps

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 43.6/100 · developing
Contract Quality 14.8 / 25
Developer Ergonomics 2.2 / 20
Commercial Clarity 9.5 / 20
Operational Transparency 4.8 / 13
Governance 5.0 / 12
Discoverability 7.4 / 10
Agent readiness — 25/100 · agent aware
Machine-Readable Contract 18 / 18
Agentic Access Contract 0 / 10
MCP Server 0 / 12
Machine-Readable Auth 0 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 6 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/railway-app: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 13

Individual APIs this provider publishes, each with its own machine-readable definition.

Railway Projects API

GraphQL operations for creating, reading, updating, and deleting Railway projects - the top-level container for services and environments. Queries include project and projects; ...

Railway Services API

GraphQL operations for managing services and their per-environment service instances. Queries include service and serviceInstance; mutations include serviceCreate, serviceUpdate...

Railway Deployments API

GraphQL operations for triggering and managing deployments. Queries include deployment and deployments; mutations include serviceInstanceDeployV2, serviceInstanceRedeploy, deplo...

Railway Environments API

GraphQL operations for isolated project environments (for example production and staging). Queries include environment and environments; mutations include environmentCreate, env...

Railway Variables API

GraphQL operations for service and environment configuration variables. Queries include variables; mutations include variableUpsert, variableDelete, and variableCollectionUpsert...

Railway Volumes API

GraphQL operations for persistent volumes attached to services. Queries include volume; mutations include volumeCreate, volumeUpdate, volumeDelete, and volumeInstanceUpdate for ...

Railway Plugins API

GraphQL operations for legacy plugins (managed database add-ons such as Postgres, MySQL, Redis, and MongoDB). Queries include plugin; mutations include pluginCreate, pluginUpdat...

Railway Custom Domains API

GraphQL operations for attaching custom and Railway-provided domains to a service. Queries include customDomain and domains; mutations include customDomainCreate, customDomainDe...

Railway TCP Proxies API

GraphQL operations for exposing a service over raw TCP. Queries include tcpProxies; mutations include tcpProxyCreate and tcpProxyDelete.

Railway Usage and Metrics API

GraphQL operations for reading resource consumption and cost. Queries include usage, estimatedUsage, and metrics for per-service vCPU, memory, network egress, and disk utilization.

Railway Teams and Workspaces API

GraphQL operations for the authenticated account, its workspaces, teams, and members. Queries include me, workspace, and workspaces; mutations include workspaceUpdate and teamMe...

Railway Webhooks API

GraphQL operations for project webhooks that notify external URLs of deployment status changes. Queries include projectWebhooks; mutations include webhookCreate, webhookUpdate, ...

Railway Logs API

GraphQL log surface for builds, deployments, environments, and HTTP traffic. Available both as point-in-time queries (buildLogs, deploymentLogs, environmentLogs, httpLogs) and a...

Scroll for all 13

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Railway GraphQL Public API

OPEN COLLECTION

GraphQL 1

GraphQL schemas published by this provider.

Railway GraphQL Public API

Railway is a cloud application deployment platform (PaaS). Its entire programmatic surface is a **GraphQL API** - there is no REST API. The Public API is the same API that power...

GRAPHQL

Pricing Plans 1

Published pricing tiers and plan structures.

Railway App Plans Pricing

5 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Railway App Rate Limits

6 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Railway App Finops

FINOPS

Event Specifications 1

AsyncAPI definitions for this provider's event-driven and streaming APIs.

Railway GraphQL Subscriptions (WebSocket)

AsyncAPI 2.6 description of Railway's **real-time log streaming** surface. Unlike many providers in this catalog, Railway **does** publish a documented public WebSocket transpor...

ASYNCAPI

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

Railway API Rules

7 rules · 1 errors 6 warnings

SPECTRAL

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Railway App Domain Security

TLSv1.3 · DNSSEC · DMARC

SECURITY

Railway App Trust Center

SOC 2, HIPAA, GDPR

SECURITY

Resources

Documentation 1

Reference material describing how the API behaves

Documentation
Documentation

Build 1

SDKs, sample code, and the tooling you integrate with

GitHubOrganization
GitHubOrganization

Access & Security 2

Authentication, authorization, and security posture

TrustCenter
TrustCenter
 DomainSecurity
DomainSecurity

Operate 1

Status, limits, changes, and where to get help

RateLimits
RateLimits

Commercial 2

Pricing, plans, and the legal terms of use

Plans
Plans
 FinOps
FinOps

Company 3

The organization behind the API

LinkedIn
LinkedIn
 Website
Website
 Blog
Blog

Source (apis.yml)

apis.yml Raw ↑ 
aid: railway-app
url: https://raw.githubusercontent.com/api-evangelist/railway-app/refs/heads/main/apis.yml
name: Railway
kind: company
description: Railway is a cloud application deployment platform (PaaS) that builds, deploys, and scales services, databases,
  and cron jobs from a Git repository or Docker image. Its programmatic surface is a GraphQL-first Public API served at https://backboard.railway.com/graphql/v2
  - the same API that powers the Railway dashboard. There is no REST API; all queries and mutations are issued as GraphQL
  POST requests, and real-time build, deployment, and environment log streams are delivered as GraphQL subscriptions over
  a WebSocket endpoint at wss://backboard.railway.com/graphql/v2.
accessModel:
  pricing: freemium
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Freemium
  confidence: medium
  source:
  - plans
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/railway-app.png
tags:
- Deployment
- PaaS
- Cloud
- Infrastructure
- GraphQL
- DevOps
created: '2026-07-02'
modified: '2026-07-02'
specificationVersion: '0.19'
apis:
- aid: railway-app:railway-app-projects-api
  name: Railway Projects API
  tags:
  - Projects
  - GraphQL
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://docs.railway.com/reference/public-api
  baseURL: https://backboard.railway.com/graphql/v2
  properties:
  - url: https://docs.railway.com/reference/public-api
    type: Documentation
  - url: https://docs.railway.com/integrations/api/graphql-overview
    type: APIReference
  - url: graphql/railway-app-graphql.md
    type: GraphQL
  - url: graphql/railway-app-schema.graphql
    type: GraphQL
  description: GraphQL operations for creating, reading, updating, and deleting Railway projects - the top-level container
    for services and environments. Queries include project and projects; mutations include projectCreate, projectUpdate, and
    projectDelete.
- aid: railway-app:railway-app-services-api
  name: Railway Services API
  tags:
  - Services
  - GraphQL
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://docs.railway.com/integrations/api/manage-services
  baseURL: https://backboard.railway.com/graphql/v2
  properties:
  - url: https://docs.railway.com/integrations/api/manage-services
    type: Documentation
  - url: https://docs.railway.com/integrations/api/manage-services
    type: APIReference
  - url: graphql/railway-app-graphql.md
    type: GraphQL
  - url: graphql/railway-app-schema.graphql
    type: GraphQL
  description: GraphQL operations for managing services and their per-environment service instances. Queries include service
    and serviceInstance; mutations include serviceCreate, serviceUpdate, serviceInstanceUpdate, serviceConnect, serviceDisconnect,
    and serviceDelete.
- aid: railway-app:railway-app-deployments-api
  name: Railway Deployments API
  tags:
  - Deployments
  - GraphQL
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://docs.railway.com/integrations/api/manage-services
  baseURL: https://backboard.railway.com/graphql/v2
  properties:
  - url: https://docs.railway.com/integrations/api/manage-services
    type: Documentation
  - url: graphql/railway-app-graphql.md
    type: GraphQL
  - url: graphql/railway-app-schema.graphql
    type: GraphQL
  description: GraphQL operations for triggering and managing deployments. Queries include deployment and deployments; mutations
    include serviceInstanceDeployV2, serviceInstanceRedeploy, deploymentRedeploy, deploymentRestart, deploymentStop, deploymentCancel,
    and deploymentRemove.
- aid: railway-app:railway-app-environments-api
  name: Railway Environments API
  tags:
  - Environments
  - GraphQL
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://docs.railway.com/reference/public-api
  baseURL: https://backboard.railway.com/graphql/v2
  properties:
  - url: https://docs.railway.com/reference/public-api
    type: Documentation
  - url: graphql/railway-app-graphql.md
    type: GraphQL
  - url: graphql/railway-app-schema.graphql
    type: GraphQL
  description: GraphQL operations for isolated project environments (for example production and staging). Queries include
    environment and environments; mutations include environmentCreate, environmentDelete, and environmentPatchCommitStage.
- aid: railway-app:railway-app-variables-api
  name: Railway Variables API
  tags:
  - Variables
  - Configuration
  - GraphQL
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://docs.railway.com/reference/public-api
  baseURL: https://backboard.railway.com/graphql/v2
  properties:
  - url: https://docs.railway.com/reference/public-api
    type: Documentation
  - url: graphql/railway-app-graphql.md
    type: GraphQL
  - url: graphql/railway-app-schema.graphql
    type: GraphQL
  description: GraphQL operations for service and environment configuration variables. Queries include variables; mutations
    include variableUpsert, variableDelete, and variableCollectionUpsert for bulk updates.
- aid: railway-app:railway-app-volumes-api
  name: Railway Volumes API
  tags:
  - Volumes
  - Storage
  - GraphQL
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://docs.railway.com/reference/public-api
  baseURL: https://backboard.railway.com/graphql/v2
  properties:
  - url: https://docs.railway.com/reference/public-api
    type: Documentation
  - url: graphql/railway-app-graphql.md
    type: GraphQL
  - url: graphql/railway-app-schema.graphql
    type: GraphQL
  description: GraphQL operations for persistent volumes attached to services. Queries include volume; mutations include volumeCreate,
    volumeUpdate, volumeDelete, and volumeInstanceUpdate for per-environment mounts.
- aid: railway-app:railway-app-plugins-api
  name: Railway Plugins API
  tags:
  - Plugins
  - Databases
  - GraphQL
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://docs.railway.com/reference/public-api
  baseURL: https://backboard.railway.com/graphql/v2
  properties:
  - url: https://docs.railway.com/reference/public-api
    type: Documentation
  - url: graphql/railway-app-graphql.md
    type: GraphQL
  - url: graphql/railway-app-schema.graphql
    type: GraphQL
  description: GraphQL operations for legacy plugins (managed database add-ons such as Postgres, MySQL, Redis, and MongoDB).
    Queries include plugin; mutations include pluginCreate, pluginUpdate, pluginRestart, and pluginDelete.
- aid: railway-app:railway-app-custom-domains-api
  name: Railway Custom Domains API
  tags:
  - Custom Domains
  - Networking
  - GraphQL
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://docs.railway.com/reference/public-api
  baseURL: https://backboard.railway.com/graphql/v2
  properties:
  - url: https://docs.railway.com/reference/public-api
    type: Documentation
  - url: graphql/railway-app-graphql.md
    type: GraphQL
  - url: graphql/railway-app-schema.graphql
    type: GraphQL
  description: GraphQL operations for attaching custom and Railway-provided domains to a service. Queries include customDomain
    and domains; mutations include customDomainCreate, customDomainDelete, and serviceDomainCreate.
- aid: railway-app:railway-app-tcp-proxies-api
  name: Railway TCP Proxies API
  tags:
  - TCP Proxy
  - Networking
  - GraphQL
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://docs.railway.com/reference/public-api
  baseURL: https://backboard.railway.com/graphql/v2
  properties:
  - url: https://docs.railway.com/reference/public-api
    type: Documentation
  - url: graphql/railway-app-graphql.md
    type: GraphQL
  - url: graphql/railway-app-schema.graphql
    type: GraphQL
  description: GraphQL operations for exposing a service over raw TCP. Queries include tcpProxies; mutations include tcpProxyCreate
    and tcpProxyDelete.
- aid: railway-app:railway-app-usage-metrics-api
  name: Railway Usage and Metrics API
  tags:
  - Usage
  - Metrics
  - Billing
  - GraphQL
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://docs.railway.com/reference/public-api
  baseURL: https://backboard.railway.com/graphql/v2
  properties:
  - url: https://docs.railway.com/reference/public-api
    type: Documentation
  - url: graphql/railway-app-graphql.md
    type: GraphQL
  - url: graphql/railway-app-schema.graphql
    type: GraphQL
  description: GraphQL operations for reading resource consumption and cost. Queries include usage, estimatedUsage, and metrics
    for per-service vCPU, memory, network egress, and disk utilization.
- aid: railway-app:railway-app-teams-api
  name: Railway Teams and Workspaces API
  tags:
  - Teams
  - Workspaces
  - Members
  - GraphQL
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://docs.railway.com/reference/public-api
  baseURL: https://backboard.railway.com/graphql/v2
  properties:
  - url: https://docs.railway.com/reference/public-api
    type: Documentation
  - url: graphql/railway-app-graphql.md
    type: GraphQL
  - url: graphql/railway-app-schema.graphql
    type: GraphQL
  description: GraphQL operations for the authenticated account, its workspaces, teams, and members. Queries include me, workspace,
    and workspaces; mutations include workspaceUpdate and teamMemberInvite.
- aid: railway-app:railway-app-webhooks-api
  name: Railway Webhooks API
  tags:
  - Webhooks
  - Events
  - GraphQL
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://docs.railway.com/reference/public-api
  baseURL: https://backboard.railway.com/graphql/v2
  properties:
  - url: https://docs.railway.com/reference/public-api
    type: Documentation
  - url: graphql/railway-app-graphql.md
    type: GraphQL
  - url: graphql/railway-app-schema.graphql
    type: GraphQL
  description: GraphQL operations for project webhooks that notify external URLs of deployment status changes. Queries include
    projectWebhooks; mutations include webhookCreate, webhookUpdate, and webhookDelete.
- aid: railway-app:railway-app-logs-api
  name: Railway Logs API
  tags:
  - Logs
  - Subscriptions
  - WebSocket
  - GraphQL
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://docs.railway.com/reference/public-api
  baseURL: https://backboard.railway.com/graphql/v2
  properties:
  - url: https://docs.railway.com/reference/public-api
    type: Documentation
  - url: graphql/railway-app-graphql.md
    type: GraphQL
  - url: graphql/railway-app-schema.graphql
    type: GraphQL
  - url: asyncapi/railway-app-asyncapi.yml
    type: AsyncAPI
  description: GraphQL log surface for builds, deployments, environments, and HTTP traffic. Available both as point-in-time
    queries (buildLogs, deploymentLogs, environmentLogs, httpLogs) and as real-time GraphQL subscriptions over WebSocket at
    wss://backboard.railway.com/graphql/v2.
common:
- type: TrustCenter
  url: security/railway-app-trust-center.yml
- type: DomainSecurity
  url: security/railway-app-domain-security.yml
- type: GitHubOrganization
  url: https://github.com/railwayapp
- type: LinkedIn
  url: https://www.linkedin.com/company/railwayapp
- type: Website
  url: https://railway.com/
- type: Documentation
  url: https://docs.railway.com
- type: Plans
  url: plans/railway-app-plans-pricing.yml
- type: RateLimits
  url: rate-limits/railway-app-rate-limits.yml
- type: FinOps
  url: finops/railway-app-finops.yml
- type: Blog
  url: https://blog.railway.com/rss.xml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com