Deutsche Telekom

Deutsche Telekom ApiRoadmap API

Manage ApiRoadmaps

GitHub OpenAPI

Operations 6

GET /apiroadmaps Find all ApiRoadmaps #
POST /apiroadmaps Create an ApiRoadmap #
GET /apiroadmaps/{apiRoadmapId} Find an existing ApiRoadmap #
PUT /apiroadmaps/{apiRoadmapId} Update an existing ApiRoadmap #
DELETE /apiroadmaps/{apiRoadmapId} Delete an ApiRoadmap #
GET /apiroadmaps/{apiRoadmapId}/status Find an existing ApiRoadmap and return its status #

Documentation

📖
Documentation
https://developer.telekom.de/docs/src/tardis_customer_handbook

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/deutsche-telekom/refs/heads/main/openapi/deutsche-telekom-apiroadmap-api-openapi.yml

Other Resources

🔗
SourceCode
https://github.com/telekom/controlplane

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/deutsche-telekom-apiroadmap-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

deutsche-telekom-apiroadmap-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Rover API Roadmap API
  description: API of the TARDIS control plane. With this API, you can manage your Rovers, ApiSpecifications, ApiRoadmaps, FileSpecifications and EventSpecifications.
  contact:
    name: TARDIS
    url: https://developer.telekom.de/docs/src/tardis_customer_handbook/support/
    email: FMB_TARDIS_Support@telekom.de
  version: 3.0.0
  x-api-category: Infrastructure
servers:
- url: https://{host}/rover/v3
  description: API where access must be approved. Supports more access-scopes.
  variables:
    host:
      default: api.telekom.de
      description: The Stargate host, see [docs](https://developer.telekom.de/docs/src/tardis_customer_handbook/StarGate_Environment_Overview/#stargate-and-iris)
- url: https://{host}/rover/api
  description: Team-API that every team may use automatically, but supports only team-access. This API is also used by rover-ctl.
  variables:
    host:
      default: api.telekom.de
      description: The Stargate host, see [docs](https://developer.telekom.de/docs/src/tardis_customer_handbook/StarGate_Environment_Overview/#stargate-and-iris)
security:
- OAuth2:
  - tardis:admin:all
tags:
- name: ApiRoadmap
  description: Manage ApiRoadmaps
paths:
  /apiroadmaps:
    get:
      tags:
      - ApiRoadmap
      summary: Find all ApiRoadmaps
      description: Find all ApiRoadmaps of a Team
      operationId: getAllApiRoadmaps
      parameters:
      - name: cursor
        in: query
        description: cursor for pagination
        required: false
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiRoadmapListResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '415':
          $ref: '#/components/responses/UnsupportedMediaType'
        '500':
          $ref: '#/components/responses/ServerError'
      security:
      - OAuth2:
        - tardis:admin:all
        - tardis:admin:read
        - tardis:hub:all
        - tardis:hub:read
        - tardis:team:all
        - tardis:team:read
    post:
      tags:
      - ApiRoadmap
      summary: Create an ApiRoadmap
      description: Create an ApiRoadmap resource
      operationId: createApiRoadmap
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ApiRoadmapCreateRequest'
      responses:
        '202':
          description: ACCEPTED
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiRoadmapResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '415':
          $ref: '#/components/responses/UnsupportedMediaType'
        '500':
          $ref: '#/components/responses/ServerError'
      security:
      - OAuth2:
        - tardis:admin:all
        - tardis:hub:all
        - tardis:team:all
  /apiroadmaps/{apiRoadmapId}:
    get:
      tags:
      - ApiRoadmap
      summary: Find an existing ApiRoadmap
      description: Find an existing ApiRoadmap
      operationId: getApiRoadmap
      parameters:
      - $ref: '#/components/parameters/ApiRoadmapId'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiRoadmapResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '415':
          $ref: '#/components/responses/UnsupportedMediaType'
        '500':
          $ref: '#/components/responses/ServerError'
      security:
      - OAuth2:
        - tardis:admin:all
        - tardis:admin:read
        - tardis:hub:all
        - tardis:hub:read
        - tardis:team:all
        - tardis:team:read
    put:
      tags:
      - ApiRoadmap
      summary: Update an existing ApiRoadmap
      description: Update an existing ApiRoadmap
      operationId: updateApiRoadmap
      parameters:
      - $ref: '#/components/parameters/ApiRoadmapId'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ApiRoadmapUpdateRequest'
      responses:
        '202':
          description: ACCEPTED
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiRoadmapResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '415':
          $ref: '#/components/responses/UnsupportedMediaType'
        '500':
          $ref: '#/components/responses/ServerError'
      security:
      - OAuth2:
        - tardis:admin:all
        - tardis:hub:all
        - tardis:team:all
    delete:
      tags:
      - ApiRoadmap
      summary: Delete an ApiRoadmap
      description: Delete an ApiRoadmap
      operationId: deleteApiRoadmap
      parameters:
      - $ref: '#/components/parameters/ApiRoadmapId'
      responses:
        '204':
          description: DELETED
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '415':
          $ref: '#/components/responses/UnsupportedMediaType'
        '500':
          $ref: '#/components/responses/ServerError'
      security:
      - OAuth2:
        - tardis:admin:all
        - tardis:hub:all
        - tardis:team:all
  /apiroadmaps/{apiRoadmapId}/status:
    get:
      tags:
      - ApiRoadmap
      summary: Find an existing ApiRoadmap and return its status
      description: Find an existing ApiRoadmap and return its status
      operationId: getApiRoadmapStatus
      parameters:
      - $ref: '#/components/parameters/ApiRoadmapId'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceStatusResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '415':
          $ref: '#/components/responses/UnsupportedMediaType'
        '500':
          $ref: '#/components/responses/ServerError'
      security:
      - OAuth2:
        - tardis:admin:all
        - tardis:admin:read
        - tardis:hub:all
        - tardis:hub:read
        - tardis:team:all
        - tardis:team:read
components:
  schemas:
    Error:
      description: RFC-7807 conform object sent on any error
      type: object
      required:
      - type
      - title
      properties:
        type:
          type: string
        title:
          type: string
        status:
          type: number
        detail:
          type: string
        instance:
          type: string
        errorCode:
          type: string
        fields:
          type: array
          items:
            $ref: '#/components/schemas/FieldProblem'
    ApiRoadmap:
      type: object
      required:
      - basePath
      - items
      properties:
        basePath:
          description: The API basePath
          type: string
          example: /eni/test-api/v1
        items:
          description: List of roadmap timeline entries
          type: array
          minItems: 1
          items:
            $ref: '#/components/schemas/ApiRoadmapItem'
    ApiRoadmapResponse:
      allOf:
      - $ref: '#/components/schemas/ApiRoadmap'
      - type: object
        properties:
          id:
            description: Unique id of this resource
            type: string
            readOnly: true
            example: my-hub--my-team--my-roadmap
          name:
            description: Name of the roadmap
            type: string
            readOnly: true
            example: my-roadmap
          status:
            $ref: '#/components/schemas/Status'
    StateInfo:
      type: object
      readOnly: true
      required:
      - message
      properties:
        message:
          type: string
        cause:
          type: string
    Problem:
      type: object
      required:
      - message
      - cause
      properties:
        resource:
          $ref: '#/components/schemas/ResourceRef'
        context:
          type: string
        message:
          type: string
        cause:
          type: string
        details:
          type: string
    ApiRoadmapCreateRequest:
      allOf:
      - $ref: '#/components/schemas/ApiRoadmap'
      - type: object
        properties:
          team:
            type: string
            example: hyperion
            description: This field is only used for hub-scoped access to control the target team of the resource. For everything else, it can be ignored
    ApiRoadmapUpdateRequest:
      allOf:
      - $ref: '#/components/schemas/ApiRoadmap'
    OverallStatus:
      description: Status of this resource and all its relevant sub-resources
      enum:
      - invalid
      - processing
      - failed
      - blocked
      - pending
      - complete
      - done
      - none
      type: string
    Status:
      type: object
      readOnly: true
      required:
      - processingState
      - state
      - time
      properties:
        processingState:
          $ref: '#/components/schemas/ProcessingState'
        state:
          $ref: '#/components/schemas/State'
        errors:
          type: array
          items:
            $ref: '#/components/schemas/StateInfo'
        warnings:
          type: array
          items:
            $ref: '#/components/schemas/StateInfo'
        infos:
          type: array
          items:
            $ref: '#/components/schemas/StateInfo'
    ProcessingState:
      enum:
      - none
      - pending
      - processing
      - failed
      - done
      type: string
    ResourceRef:
      type: object
      readOnly: true
      required:
      - apiVersion
      - kind
      - name
      - namespace
      properties:
        apiVersion:
          type: string
        kind:
          type: string
        name:
          type: string
        namespace:
          type: string
        path:
          type: string
    FieldProblem:
      type: object
      required:
      - title
      properties:
        title:
          type: string
        detail:
          type: string
        path:
          type: string
    Links:
      description: HATEOAS links for pagination
      type: object
      required:
      - self
      - next
      properties:
        self:
          type: string
          format: uri
          description: the URI for the current page for requested pagination
        next:
          type: string
          format: uri
          description: the URI for the next page for requested pagination, based on the requested limit value
    ResourceStatusResponse:
      description: Response resource which contains information about the status of the resource and all its relevant sub-resources
      required:
      - state
      - processingState
      - overallStatus
      type: object
      properties:
        createdAt:
          type: string
          format: date-time
          description: Time when the resource was created
        processedAt:
          type: string
          format: date-time
          description: Time when the resource was last processed
        state:
          $ref: '#/components/schemas/State'
        processingState:
          $ref: '#/components/schemas/ProcessingState'
        overallStatus:
          $ref: '#/components/schemas/OverallStatus'
        errors:
          description: List of errors that resulted while processing this resource
          type: array
          items:
            $ref: '#/components/schemas/Problem'
        warnings:
          description: List of warnings that resulted while processing this resource
          type: array
          items:
            $ref: '#/components/schemas/Problem'
        infos:
          description: List of infos that resulted while processing this resource
          type: array
          items:
            $ref: '#/components/schemas/Problem'
    ApiRoadmapListResponse:
      type: object
      required:
      - items
      properties:
        _links:
          $ref: '#/components/schemas/Links'
        items:
          type: array
          items:
            $ref: '#/components/schemas/ApiRoadmapResponse'
    ApiRoadmapItem:
      type: object
      required:
      - date
      - title
      - description
      properties:
        date:
          description: Timeline date or period
          type: string
          example: Q1 2024
        title:
          description: Milestone title
          type: string
          example: MVP Release
        description:
          description: Detailed description of the milestone
          type: string
          example: Initial release with core features
        titleUrl:
          description: Optional URL for more information
          type: string
          format: uri
          example: https://example.com/mvp
    State:
      enum:
      - none
      - invalid
      - blocked
      - complete
      type: string
  responses:
    ServerError:
      description: SERVER_ERROR
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: UNAUTHORIZED
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Error'
    BadRequest:
      description: BAD_REQUEST
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: FORBIDDEN
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Error'
    UnsupportedMediaType:
      description: UNSUPPORTED_MEDIATYPE
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: NOT_FOUND
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Error'
  parameters:
    ApiRoadmapId:
      name: apiRoadmapId
      description: The unique id of this resource following the pattern group--team--basePath
      in: path
      required: true
      schema:
        type: string
  securitySchemes:
    OAuth2:
      type: oauth2
      description: OAuth2 client_credentials flow
      flows:
        clientCredentials:
          tokenUrl: https://example.com/auth/realms/realm//protocol/openid-connect/token
          scopes:
            tardis:admin:all: Admin access to all resources
            tardis:admin:read: Admin read access to all resources
            tardis:admin:obfuscated: Admin obfuscated access to all resources
            tardis:supervisor:read: (deprecated) Admin obfuscated access to all resources
            tardis:hub:all: Access to all resources of a hub
            tardis:hub:read: Read access to all resources of a hub
            tardis:hub:obfuscated: Obfuscated access to all resources of a hub
            tardis:team:all: Access to all resources of a team
            tardis:team:read: Read access to all resources of a team
            tardis:team:obfuscated: Obfuscated access to all resources of a team
            tardis:user:all: (deprecated) Access to all resources of a team
            tardis:user:read: (deprecated) Read access to all resources of a team
            tardis:user:obfuscated: (deprecated) Obfuscated access to all resources of a team