{"openapi":"3.0.3","info":{"title":"YARD API","version":"2.0.0"},"components":{"securitySchemes":{"yardSession":{"type":"apiKey","in":"cookie","name":"yard_session","description":"Existing signed-in YARD browser session. Permissions are checked by each endpoint."}}},"paths":{"/v1/public-search":{"get":{"summary":"Search public YARD pages and Objects in Elasticsearch","tags":["Search"],"parameters":[{"schema":{"type":"string","minLength":2,"maxLength":120},"in":"query","name":"q","required":true},{"schema":{"type":"integer","minimum":1,"maximum":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["en","de","fr"]},"in":"query","name":"locale","required":false},{"schema":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,63}$"},"in":"query","name":"entity","required":false},{"schema":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,63}$"},"in":"query","name":"class","required":false},{"schema":{"type":"string","enum":["knowledge-base"]},"in":"query","name":"scope","required":false}],"responses":{"200":{"description":"Default Response"}},"x-yard-docs":"public","security":[]}},"/api/v1/get-code/":{"get":{"summary":"Legacy YARD calendar embed contract","tags":["Integrations"],"responses":{"200":{"description":"Default Response"}},"x-yard-docs":"public","security":[]}},"/api/v1/get-modal-js/":{"get":{"summary":"Legacy YARD event modal contract","tags":["Integrations"],"responses":{"200":{"description":"Default Response"}},"x-yard-docs":"public","security":[]}},"/v1/remote/calendars":{"get":{"summary":"Rendered public calendar for the YARD embed","tags":["Integrations"],"responses":{"200":{"description":"Default Response"}},"x-yard-docs":"public","security":[]}},"/v1/remote/events/{id}/modal":{"get":{"summary":"Rendered public event modal for the YARD embed","tags":["Integrations"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}},"x-yard-docs":"public","security":[]}},"/v1/events/{slug}/calendar.ics":{"get":{"summary":"Download an event as iCalendar","tags":["Events"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"slug","required":true}],"responses":{"200":{"description":"Default Response"}},"x-yard-docs":"public","security":[]}},"/v1/cards/{uuid}/contact.vcf":{"get":{"summary":"Download a public Card vCard","tags":["Cards"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"uuid","required":true}],"responses":{"200":{"description":"Default Response"}},"x-yard-docs":"public","security":[]}},"/v1/plugin/releases/latest":{"get":{"summary":"Latest YARD WordPress plugin release","tags":["Integrations"],"responses":{"200":{"description":"Default Response"}},"x-yard-docs":"public","security":[]}},"/v1/cards":{"get":{"summary":"Browse active YARD Cards","tags":["Cards"],"parameters":[{"schema":{"type":"string","maxLength":100},"in":"query","name":"q","required":false}],"responses":{"200":{"description":"Default Response"}},"x-yard-docs":"public","security":[]}},"/v1/cards/{uuid}":{"get":{"summary":"Read an active YARD Card","tags":["Cards"],"parameters":[{"schema":{"type":"string","pattern":"^[0-9a-fA-F-]{36}$"},"in":"path","name":"uuid","required":true}],"responses":{"200":{"description":"Default Response"}},"x-yard-docs":"public","security":[]}},"/v1/events":{"get":{"summary":"Published visible events","tags":["Events"],"parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"integer","minimum":0,"maximum":100000},"in":"query","name":"offset","required":false}],"responses":{"200":{"description":"Default Response"}},"x-yard-docs":"public","security":[]}},"/v1/search":{"get":{"summary":"Search published events","tags":["Search"],"parameters":[{"schema":{"type":"string","minLength":2,"maxLength":160},"in":"query","name":"q","required":true}],"responses":{"200":{"description":"Default Response"}},"x-yard-docs":"public","security":[]}},"/v1/explore":{"get":{"summary":"Filter published events","tags":["Search"],"responses":{"200":{"description":"Default Response"}},"x-yard-docs":"public","security":[]}},"/v1/collections":{"get":{"summary":"Collections","tags":["Collections"],"responses":{"200":{"description":"Default Response"}},"x-yard-docs":"public","security":[]}},"/v1/calendars":{"get":{"summary":"Public calendars","tags":["Calendars"],"responses":{"200":{"description":"Default Response"}},"x-yard-docs":"public","security":[]}},"/v1/calendars/{slug}":{"get":{"summary":"Calendar detail","tags":["Calendars"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"slug","required":true}],"responses":{"200":{"description":"Default Response"}},"x-yard-docs":"public","security":[]}},"/v1/collections/{slug}":{"get":{"summary":"Collection detail","tags":["Collections"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"slug","required":true}],"responses":{"200":{"description":"Default Response"}},"x-yard-docs":"public","security":[]}},"/v1/events/{slug}":{"get":{"summary":"Event detail","tags":["Events"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"slug","required":true}],"responses":{"200":{"description":"Default Response"}},"x-yard-docs":"public","security":[]}},"/v1/public-media/{id}":{"get":{"summary":"Published event or calendar image","tags":["Media"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}},"x-yard-docs":"public","security":[]}}},"servers":[{"url":"/api/reference"}],"tags":[{"name":"Events","description":"Published events, drafts, saved events and event submissions."},{"name":"Calendars","description":"Calendars, calendar ownership and event markings."},{"name":"Cards","description":"YARD Cards, contact downloads and contact requests."},{"name":"Collections","description":"Curated collections and their contents."},{"name":"Search","description":"Search, filters and discovery suggestions."},{"name":"Media","description":"Images, uploads and media metadata."},{"name":"Integrations","description":"Embedded views, remote dialogs and WordPress plugin releases."}]}