action flat_list_organization_invitations {
  label: "List the organization invitations"
  provider: flat
  method: GET
  path: "/organizations/invitations"
  encoding: json
  input: {
    type: "object"
    properties: {
      limit: {
        type: "integer"
      }
      next: {
        type: "string"
      }
      previous: {
        type: "string"
      }
      role: {
        type: "string"
        enum: ["user", "teacher", "admin"]
      }
    }
    additionalProperties: false
  }
  output: {
    type: "array"
    items: {
      type: "object"
      description: "Details of an invitation to join an organization"
      properties: {
        customCode: {
          type: "string"
          description: "Enrollment code to use when joining this organization"
        }
        email: {
          type: "string"
          description: "The email address this invitation was sent to"
        }
        id: {
          type: "string"
          description: "The invitation unique identifier"
        }
        invitedBy: {
          type: "string"
          description: "The unique identifier of the User who created this invitation"
        }
        organization: {
          type: "string"
          description: "The unique identifier of the Organization owning this class"
        }
        organizationRole: {
          type: "string"
          description: "User's Organization Role (for Edu users only)"
          enum: ["admin", "billing", "teacher", "user"]
        }
        usedBy: {
          type: "string"
          description: "The unique identifier of the User who used this invitation"
        }
      }
    }
  }
}