v18

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-014211,6201.8 MB
gitpod.v1.IdentityService

GetIDToken

Gets an ID token for authenticating with other services.

Use this method to:

  • Obtain authentication tokens for service-to-service calls
  • Access protected resources
  • Generate scoped access tokens

Examples

  • Get token for single service:

    Retrieves a token for authenticating with one service.

    audience:
      - "https://api.gitpod.io"
    
  • Get token for multiple services:

    Retrieves a token valid for multiple services.

    audience:
      - "https://api.gitpod.io"
      - "https://ws.gitpod.io"
    
post/gitpod.v1.IdentityService/GetIDToken

Request body

audiencestring[]
version'ID_TOKEN_VERSION_UNSPECIFIED' | 'ID_TOKEN_VERSION_V1' | 'ID_TOKEN_VERSION_V2'

Response

Success

tokenstring