---
title: "Signup"
method: POST
path: "/gitpod.v1.RunnerInteractionService/Signup"
tags: ["gitpod.v1.RunnerInteractionService"]
---

# Signup

`POST /gitpod.v1.RunnerInteractionService/Signup`

Signup is called by a runner to sign up with the backend. This is the first call a runner makes.

## Request body

- GitpodV1SignupRequest
  - `environmentClasses` GitpodV1EnvironmentClass[] — The environment classes this runner has to offer
    - `configuration` GitpodV1FieldValue[] — configuration describes the configuration of the environment class
      - `key` string
      - `value` string
    - `description` string — description is a human readable description of the environment class
    - `displayName` string — display_name is the human readable name of the environment class
    - `enabled` boolean — enabled indicates whether the environment class can be used to create new environments.
    - `id` string, required — id is the unique identifier of the environment class
    - `runnerId` string — runner_id is the unique identifier of the runner the environment class belongs to
  - `publicKey` string, byte — The runner's public key. Must be an ECDH public key encoded in PKIX, ASN.1 DER format.

## Response `200`

Success

- GitpodV1SignupResponse
  - `runnerId` string, uuid — The runner's identity

## Other responses

- `default` — Error

## Changes

- **2025-02-18** `f6598ab5d682` — 1 breaking
  - the request property `environmentClasses/items/id` became required

[Change history](https://skmtc.dev/gitpod-io/apis/gitpod-v1/changes/gitpod.v1.RunnerInteractionService/Signup/post.md)

---

[API](https://skmtc.dev/gitpod-io/apis/gitpod-v1.md) · [All operations](https://skmtc.dev/gitpod-io/apis/gitpod-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gitpod-io/gitpod-v1/revisions/f6598ab5d682/schema)