Manage Projects with the Public API

Here are some examples to help you get started managing your projects using the Public API.

Note: Authenticate your requests with your workspace token by setting the Authorization header to Bearer <your-workspace-token>.

Fetch All Your Projects

The query below will fetch all projects in a workspace along with their services and environments.

query Projects {
  workspace(workspaceId: "<workspace_id>") {
    projects {
      edges {
        node {
          id
          name
          services {
            edges {
              node {
                id
                name
              }
            }
          }
          environments {
            edges {
              node {
                id
                name
              }
            }
          }
        }
      }
    }
  }
}

Replace <workspace_id> with your active workspace ID.

You can find your current workspace's ID by:

1. Pressing Cmd/Ctrl + K in the Railway dashboard
2. Searching for and selecting the "Copy Active Workspace ID" option

Delete a Project

The mutation below will delete the project with the specified id.

mutation projectDelete {
  projectDelete(id: "5e594338-0faa-415f-b2a7-2b5f2d4ec11a")
}