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

# The schedule, with clashes

> The edition's events by day (the festival's own date) and venue, in time order. clashes.venues: events in one venue closer than the edition's gap between events (gap_minutes), or overlapping. clashes.people: someone on two overlapping events. Cancelled events are left out; events with no start time are listed in not_scheduled.



## OpenAPI

````yaml https://api-test.fesutibaru.com/api/v1/openapi.json get /schedule
openapi: 3.1.0
info:
  title: Fesutibaru Planner API
  version: 0.17.0
  description: >-
    The festival's working data, read as a signed-in person: what they can see
    in Planner, they can read here, and nothing else.


    Each festival has its own address: https://<festival>.fesutibaru.com/api/v1.


    Field names are the database's own, so a field you read is the field you
    change in a proposal. Times are instants (ISO 8601 with offset); the
    festival's own wall-clock time is alongside as <field>_local.


    Editions: event, travel, stay, pick-up, document and media records belong to
    one edition. Reads default to the current edition; ?edition=2027 reads
    another.


    Custom fields appear on records as cf_<field_key> (see /custom-fields).


    Changes are proposed, never made directly: POST /proposals, and the person
    accepts or rejects them in their Planner inbox.


    Public listings for websites, with an API key, are under /api/v1/public.
servers:
  - url: https://{festival}.fesutibaru.com/api/v1
    variables:
      festival:
        default: demo
        description: The festival's subdomain.
security:
  - agent:
      - planner:read
paths:
  /schedule:
    get:
      tags:
        - Schedule
      summary: The schedule, with clashes
      description: >-
        The edition's events by day (the festival's own date) and venue, in time
        order. clashes.venues: events in one venue closer than the edition's gap
        between events (gap_minutes), or overlapping. clashes.people: someone on
        two overlapping events. Cancelled events are left out; events with no
        start time are listed in not_scheduled.
      operationId: get_schedule
      parameters:
        - name: date
          in: query
          description: 'One day, e.g. 2027-08-21. Default: every day.'
          schema:
            type: string
            format: date
        - name: edition
          in: query
          description: >-
            Read another edition by its year, e.g. 2027. Default: the current
            edition.
          schema:
            type: integer
        - name: edition_id
          in: query
          description: Read another edition by its id.
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: The schedule.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
        '400':
          description: 'Something in the request is wrong: detail says what.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '401':
          description: Not signed in.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '403':
          description: Not allowed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '404':
          description: No such record, edition or resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '429':
          description: 'Too many requests: wait for Retry-After seconds.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
components:
  schemas:
    Problem:
      type: object
      description: 'An error (RFC 9457): detail says what went wrong and what to do.'
      properties:
        type:
          type: string
        title:
          type: string
        status:
          type: integer
        detail:
          type: string
      required:
        - title
        - status
        - detail
  securitySchemes:
    agent:
      type: oauth2
      description: >-
        Sign in as a person: Planner shows them what the agent asks for
        (planner:read, planner:propose) and they agree. The agent then sees what
        they can see. Discovery: /.well-known/oauth-protected-resource.
      flows:
        authorizationCode:
          authorizationUrl: https://clerk.fesutibaru.com/oauth/authorize
          tokenUrl: https://clerk.fesutibaru.com/oauth/token
          refreshUrl: https://clerk.fesutibaru.com/oauth/token
          scopes:
            planner:read: Read the festival records you can see in Planner.
            planner:propose: >-
              Propose changes for you to review in your Planner inbox. Nothing
              changes until you accept it.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.