> ## Documentation Index
> Fetch the complete documentation index at: https://docs.olostep.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Zeitplan abrufen

> Ruft einen einzelnen Zeitplan anhand seiner ID ab.



## OpenAPI

````yaml de/openapi/schedules.json GET /v1/schedules/{schedule_id}
openapi: 3.0.3
info:
  title: Zeitpläne API
  version: 1.0.0
servers:
  - url: https://api.olostep.com
security: []
paths:
  /v1/schedules/{schedule_id}:
    get:
      summary: Zeitplan abrufen
      description: Ruft einen einzelnen Zeitplan anhand seiner ID ab.
      parameters:
        - name: schedule_id
          in: path
          required: true
          description: >-
            Eindeutiger Bezeichner für den Zeitplan. Muss mit 'schedule_'
            beginnen.
          schema:
            type: string
            pattern: ^schedule_
      responses:
        '200':
          description: Zeitplan erfolgreich abgerufen.
          content:
            application/json:
              schema:
                type: object
                properties:
                  schedule:
                    type: object
                    properties:
                      team_id:
                        type: string
                        description: Team-Identifikator
                      schedule_id:
                        type: string
                        description: Eindeutige Zeitplan-ID
                      type:
                        type: string
                        enum:
                          - recurring
                          - onetime
                        description: Art des Zeitplans
                      endpoint:
                        type: string
                        description: Die Endpoint-URL
                      payload:
                        type: object
                        description: Die Nutzlast, die mit dem API-Aufruf gesendet wird
                      cron_expression:
                        type: string
                        description: >-
                          Cron-Ausdruck (nur bei wiederkehrenden Zeitplänen
                          vorhanden)
                      execute_at:
                        type: string
                        format: date-time
                        description: >-
                          Ausführungs-Datetime (nur bei einmaligen Zeitplänen
                          vorhanden)
                      expression_timezone:
                        type: string
                        description: Zeitzone für den Zeitplan
                      text:
                        type: string
                        description: >-
                          In natürlicher Sprache verfasster Text zur Generierung
                          des Cron-Ausdrucks
                      schedule_name:
                        type: string
                        description: Interner Zeitplanname in EventBridge
                      schedule_group:
                        type: string
                        description: Name der Zeitplangruppe
                      created_at:
                        type: string
                        format: date-time
                        description: ISO 8601-Datetime, wann der Zeitplan erstellt wurde
                      updated_at:
                        type: string
                        format: date-time
                        description: >-
                          ISO 8601-Datum und -Uhrzeit, wann der Zeitplan zuletzt
                          aktualisiert wurde
                      state:
                        type: string
                        enum:
                          - ENABLED
                          - DELETED
                        description: Aktueller Zustand des Zeitplans
                      method:
                        type: string
                        enum:
                          - GET
                          - POST
                        description: HTTP-Methode für den geplanten Aufruf
        '400':
          description: >-
            Ungültige Anfrage aufgrund eines falschen schedule_id-Formats. Die
            Schedule ID muss mit 'schedule_' beginnen.
        '401':
          description: Ungültiger API-Schlüssel.
        '404':
          description: Zeitplan für die angegebene ID nicht gefunden.
        '500':
          description: Interner Serverfehler beim Abrufen des Zeitplans.
      security:
        - Authorization: []
components:
  securitySchemes:
    Authorization:
      type: http
      scheme: bearer
      description: >-
        Bearer-Authentifizierungsheader in der Form Bearer <token>, wobei
        <token> dein Authentifizierungstoken ist.

````