openapi: 3.0.0 info: version: 1.0.0 title: The Events Calendar REST API description: The Events Calendar REST API allows accessing upcoming events information easily and conveniently. x-api-evangelist-note: 'Published verbatim by the site itself at https://impossiblemetals.com/wp-json/tribe/events/v1/doc (HTTP 200, application/json, 2026-08-23). Content is unchanged; only the serialization was converted from JSON to YAML. The verbatim JSON is kept at openapi/_original/impossible-metals-tribe-events-v1-openapi.json. OWNERSHIP: servers[] names https://impossiblemetals.com/wp-json/tribe/events/v1/ — the document is generated and served by Impossible Metals'' own host and describes Impossible Metals'' own event, venue and organizer records. info.contact is absent here; the sibling tec/v1 document names The Events Calendar (StellarWP) because the WordPress plugin generates the description, exactly as a self-hosted/templated server does.' x-captured-on: '2026-08-23' components: schemas: ImageSize: type: object properties: width: type: integer description: The image width in pixels in the specified size height: type: integer description: The image height in pixels in the specified size mime-type: type: string description: The image mime-type url: type: string format: uri description: The link to the image in the specified size on the site CostDetails: type: object properties: currency_symbol: type: string description: The cost currency symbol 'currency_position ': type: string description: The position of the currency symbol in the cost string enum: - prefix - postfix values: type: array items: type: integer description: A sorted array of all the numeric values for the cost Term: type: object properties: id: type: integer description: The WordPress term ID name: type: string description: The term name slug: type: string description: The term slug taxonomy: type: string description: The taxonomy the term belongs to description: type: string description: The term description parent: type: integer description: The term parent term if any count: type: integer description: The number of posts associated with the term url: type: string description: The URL to the term archive page urls: type: array items: type: string description: A list of links to the term own, archive and parent REST URL Image: type: object properties: url: type: string format: uri description: The URL to the full size version of the image id: type: integer description: The image WordPress post ID extension: type: string description: The image file extension width: type: integer description: The image natural width in pixels height: type: integer description: The image natural height in pixels sizes: type: array description: The details about each size available for the image items: $ref: '#/components/schemas/ImageSize' DateDetails: type: object properties: year: type: integer description: The date year month: type: integer description: The date month day: type: integer description: The date day hour: type: integer description: The date hour minutes: type: integer description: The date minutes seconds: type: integer description: The date seconds Event: type: object properties: id: type: integer description: The event WordPress post ID global_id: type: string description: The event ID used to globally identify in Event Aggregator global_id_lineage: type: array items: type: string description: An Array containing the lineage of where this event comes from, this should not change after the event is created. author: type: integer description: The event author WordPress post ID date: type: string description: The event creation date in the site time zone date_utc: type: string description: The event creation date in UTC time modified: type: string description: The event last modification date in the site time zone modified_utc: type: string description: The event last modification date in UTC time status: type: string description: The event status url: type: string description: The URL to the event page rest_url: type: string description: The TEC REST API link to fetch this event title: type: string description: The event name description: type: string description: The event long description excerpt: type: string description: The event short description slug: type: string description: The event slug image: type: object description: The event featured image details if set $ref: '#/components/schemas/Image' all_day: type: boolean description: Whether or not this event is an all day Event start_date: type: string description: The event start date in the event or site time zone start_date_details: type: array description: An array of each component of the event start date items: $ref: '#/components/schemas/DateDetails' end_date: type: string description: The event end date in the event or site time zone end_date_details: type: array description: An array of each component of the event end date items: $ref: '#/components/schemas/DateDetails' utc_start_date: type: string description: The event start date in UTC time utc_start_date_details: type: array description: An array of each component of the event start date in UTC time items: $ref: '#/components/schemas/DateDetails' utc_end_date: type: string description: The event end date in UTC time utc_end_date_details: type: array description: An array of each component of the event end date in UTC time items: $ref: '#/components/schemas/DateDetails' timezone: type: string description: The event time zone string timezone_abbr: type: string description: The abbreviated event time zone string cost: type: string description: The event cost including the currency symbol cost_details: type: array description: The event cost details items: $ref: '#/components/schemas/CostDetails' website: type: string description: The event website URL show_map: type: boolean description: Whether the map should be shown for the event or not show_map_link: type: boolean description: Whether the map link should be shown for the event or not hide_from_listings: type: boolean description: Whether an event should be hidden from the calendar view or not sticky: type: boolean description: Whether an event is sticky in the calendar view or not featured: type: boolean description: Whether the event is featured in the calendar or not categories: type: array description: The event categories items: $ref: '#/components/schemas/Term' tags: type: array description: The event tags items: $ref: '#/components/schemas/Term' venue: type: object description: The event venue $ref: '#/components/schemas/Venue' organizer: type: array description: The event organizers items: $ref: '#/components/schemas/Organizer' Venue: type: object properties: id: type: integer description: The venue WordPress post ID global_id: type: string description: The venue ID used to globally identify in Event Aggregator global_id_lineage: type: array items: type: string description: An Array containing the lineage of where this organizer comes from, this should not change after the organizer is created. author: type: integer description: The venue author WordPress post ID date: type: string description: The venue creation date in the site time zone date_utc: type: string description: The venue creation date in UTC time modified: type: string description: The venue last modification date in the site time zone modified_utc: type: string description: The venue last modification date in UTC time status: type: string description: The venue status url: type: string description: The URL to the venue page venue: type: string description: The venue name description: type: string description: The venue long description excerpt: type: string description: The venue short description slug: type: string description: The venue slug image: type: string description: The event featured image details if set $ref: '#/components/schemas/Image' show_map: type: boolean description: Whether the map should be shown for the venue or not show_map_link: type: boolean description: Whether the map link should be shown for the venue or not address: type: string description: The venue address city: type: string description: The venue city country: type: string description: The venue country province: type: string description: The venue province state: type: string description: The venue state zip: type: string description: The venue ZIP code phone: type: string description: The venue phone number website: type: string description: The venue website URL stateprovince: type: string description: The venue state or province geo_lat: type: number format: double description: The venue geo latitude geo_lng: type: number format: double description: The venue geo longitude Organizer: type: object properties: id: type: integer description: The organizer WordPress post ID global_id: type: string description: The organizer ID used to globally identify in Event Aggregator global_id_lineage: type: array items: type: string description: An Array containing the lineage of where this organizer comes from, this should not change after the organizer is created. author: type: integer description: The organizer author WordPress post ID date: type: string description: The organizer creation date in the site time zone date_utc: type: string description: The organizer creation date in UTC time modified: type: string description: The organizer last modification date in the site time zone modified_utc: type: string description: The organizer last modification date in UTC time status: type: string description: The organizer status url: type: string description: The URL to the organizer page organizer: type: string description: The organizer name description: type: string description: The organizer long description excerpt: type: string description: The organizer short description slug: type: string description: The organizer slug image: type: string description: The event featured image details if set $ref: '#/components/schemas/Image' phone: type: string description: The organizer phone number website: type: string description: The organizer website email: type: string description: The organizer email address servers: - url: https://impossiblemetals.com/wp-json/tribe/events/v1/ paths: /doc: get: responses: '200': description: Returns the documentation for The Events Calendar REST API in Swagger consumable format. /events: get: parameters: - in: query schema: type: integer description: The archive page to return required: false name: page - in: query schema: type: integer description: The number of events to return on each page required: false name: per_page - in: query schema: type: string description: Events that start on the specified date required: false name: start_date - in: query schema: type: string description: Events that end on the specified date required: false name: end_date - in: query schema: type: string description: Events that start before the specified date required: false name: starts_before - in: query schema: type: string description: Events that start after the specified date required: false name: starts_after - in: query schema: type: string description: Events that end before the specified date required: false name: ends_before - in: query schema: type: string description: Events that end after the specified date required: false name: ends_after - in: query schema: type: string description: Dates set using the start_date/end_date, starts_*/ends_* are set to start at the specified times. The default behavior is to include the entire days. required: false name: strict_dates - in: query schema: type: string description: Events should contain the specified string in the title or description required: false name: search - in: query schema: type: array items: type: integer description: Events should be assigned one of the specified categories slugs or IDs required: false name: categories style: form - in: query schema: type: array items: type: integer description: Events should be assigned one of the specified tags slugs or IDs required: false name: tags style: form - in: query schema: type: array items: type: integer description: Events should be assigned one of the specified venue IDs required: false name: venue style: form - in: query schema: type: array items: type: integer description: Events should be assigned one of the specified organizer IDs required: false name: organizer style: form - in: query schema: type: boolean description: Events should be filtered by their featured status required: false name: featured - in: query schema: type: string description: The event post status required: false name: status - in: query schema: type: boolean description: Requires Events Calendar Pro. Events should be filtered by whether their venue has geolocation data required: false name: geoloc - in: query schema: type: number description: Requires Events Calendar Pro. Events should be filtered by their venue latitude location, must also provide geoloc_lng required: false name: geoloc_lat - in: query schema: type: number description: Requires Events Calendar Pro. Events should be filtered by their venue longitude location, must also provide geoloc_lat required: false name: geoloc_lng - in: query schema: type: array items: type: integer description: Include events with one of the post IDs specified in the array of CSV list, date filters will be ignored. required: false name: include style: form - in: query schema: type: integer description: Events should be filtered by their post_parent being the specified one. required: false name: post_parent - in: query schema: type: boolean description: Filter events with or without tickets. required: false name: ticketed responses: '200': description: Returns all the upcoming events matching the search criteria content: application/json: schema: title: events type: array items: $ref: '#/components/schemas/Event' '400': description: One or more of the specified query variables has a bad format '404': description: The requested page was not found. /events/{id}: get: parameters: - in: path schema: type: integer description: the event post ID required: true name: id - in: path schema: type: string description: The event password required: false name: password responses: '200': description: Returns the data of the event with the specified post ID content: application/json: schema: $ref: '#/components/schemas/Event' '400': description: The event post ID is missing. '403': description: The event with the specified ID is not accessible. '404': description: An event with the specified ID does not exist. post: parameters: - in: path schema: type: integer description: the event post ID required: true name: id - in: path schema: type: string description: The event password required: false name: password requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: author: description: The event author ID type: integer date: description: The event publication date type: string date_utc: description: The event publication date (UTC time zone) type: string title: description: The event title type: string description: description: The event description type: string slug: description: The event slug type: string excerpt: description: The event excerpt type: string status: description: The event post status type: string timezone: description: The event time zone type: string all_day: description: Whether the event lasts the whole day or not type: boolean start_date: description: The event start date and time type: string end_date: description: The event end date and time type: string image: description: The event featured image ID or URL type: string cost: description: The event cost type: string website: description: The event website URL type: string show_map: description: Whether the event should show a map or not type: boolean show_map_link: description: Whether the event should show a map link or not type: boolean hide_from_listings: description: Whether events should be hidden in the calendar view or not type: boolean sticky: description: Whether the event should be sticky in the calendar view or not type: boolean featured: description: Whether the event should be featured on the site or not type: boolean categories: description: The event category ID or name type: array items: type: integer tags: description: The event tag ID or name type: array items: type: integer venue: description: The event venue IDs or data type: array items: type: integer organizer: description: The event organizer IDs or data type: array items: type: integer responses: '200': description: Returns the data of the updated event content: application/json: schema: $ref: '#/components/schemas/Event' '201': description: Returns the data of the created event content: application/json: schema: $ref: '#/components/schemas/Event' '400': description: A required parameter is missing or an input parameter is in the wrong format '403': description: The user is not authorized to create events delete: parameters: - in: path schema: type: integer description: the event post ID required: true name: id - in: path schema: type: string description: The event password required: false name: password responses: '200': description: Deletes an event and returns its data content: application/json: schema: $ref: '#/components/schemas/Event' '400': description: The event post ID is missing or does not exist. '403': description: The current user cannot delete the event with the specified ID. '410': description: The event with the specified ID has been deleted already. '500': description: The event with the specified ID could not be deleted. /events/by-slug/{slug}: get: parameters: - in: path schema: type: string description: the event post name required: true name: slug responses: '200': description: Returns the data of the event with the specified post ID content: application/json: schema: $ref: '#/components/schemas/Event' '400': description: The event post ID is missing. '403': description: The event with the specified ID is not accessible. '404': description: An event with the specified ID does not exist. post: parameters: - in: path schema: type: string description: the event post name required: true name: slug requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: author: description: The event author ID type: integer date: description: The event publication date type: string date_utc: description: The event publication date (UTC time zone) type: string title: description: The event title type: string description: description: The event description type: string slug: description: The event slug type: string excerpt: description: The event excerpt type: string status: description: The event post status type: string timezone: description: The event time zone type: string all_day: description: Whether the event lasts the whole day or not type: boolean start_date: description: The event start date and time type: string end_date: description: The event end date and time type: string image: description: The event featured image ID or URL type: string cost: description: The event cost type: string website: description: The event website URL type: string show_map: description: Whether the event should show a map or not type: boolean show_map_link: description: Whether the event should show a map link or not type: boolean hide_from_listings: description: Whether events should be hidden in the calendar view or not type: boolean sticky: description: Whether the event should be sticky in the calendar view or not type: boolean featured: description: Whether the event should be featured on the site or not type: boolean categories: description: The event category ID or name type: array items: type: integer tags: description: The event tag ID or name type: array items: type: integer venue: description: The event venue IDs or data type: array items: type: integer organizer: description: The event organizer IDs or data type: array items: type: integer responses: '200': description: Returns the data of the updated event content: application/json: schema: $ref: '#/components/schemas/Event' '201': description: Returns the data of the created event content: application/json: schema: $ref: '#/components/schemas/Event' '400': description: A required parameter is missing or an input parameter is in the wrong format '403': description: The user is not authorized to create events delete: parameters: - in: path schema: type: string description: the event post name required: true name: slug responses: '200': description: Deletes an event and returns its data content: application/json: schema: $ref: '#/components/schemas/Event' '400': description: The event post ID is missing or does not exist. '403': description: The current user cannot delete the event with the specified ID. '410': description: The event with the specified ID has been deleted already. '500': description: The event with the specified ID could not be deleted. /venues: get: parameters: - in: query schema: type: integer description: The archive page to return required: false name: page - in: query schema: type: integer description: The number of venues to return on each page required: false name: per_page - in: query schema: type: string description: Venues should contain the specified string in the title, description or custom fields required: false name: search - in: query schema: type: integer description: Venues should be related to this event required: false name: event - in: query schema: type: boolean description: Venues should have events associated to them required: false name: has_events - in: query schema: type: boolean description: Venues should have upcoming events associated to them required: false name: only_with_upcoming - in: query schema: type: string description: The organizer post status required: false name: status responses: '200': description: Returns all the venues matching the search criteria content: application/json: schema: title: venues type: array items: $ref: '#/components/schemas/Venue' '400': description: One or more of the specified query variables has a bad format '404': description: The requested page was not found. /venues/{id}: get: parameters: - in: path schema: type: integer description: the venue post ID required: true name: id responses: '200': description: Returns the data of the venue with the specified post ID content: application/json: schema: $ref: '#/components/schemas/Venue' '400': description: The venue post ID is missing. '403': description: The venue with the specified ID is not accessible. '404': description: A venue with the specified post ID does not exist. post: parameters: - in: path schema: type: integer description: the venue post ID required: true name: id requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: author: description: The venue author ID type: integer date: description: The venue publication date type: string date_utc: description: The venue publication date (UTC time zone) type: string venue: description: The venue name type: string description: description: The venue description type: string status: description: The venue post status type: string show_map: description: Whether events linked to the venue should show a map or not type: string show_map_link: description: Whether events linked to the venue should show a map link or not type: string address: description: The venue address type: string city: description: The venue city type: string country: description: The venue country type: string province: description: The venue province type: string state: description: The venue state type: string zip: description: The venue ZIP code type: string phone: description: The venue phone number type: string stateprovince: description: The venue state and province type: string website: description: The venue website URL type: string image: description: The organizer featured image ID or URL type: string responses: '200': description: Returns the data of the updated venue content: application/json: schema: $ref: '#/components/schemas/Venue' '201': description: Returns the data of the created venue content: application/json: schema: $ref: '#/components/schemas/Venue' '400': description: A required parameter is missing or an input parameter is in the wrong format '403': description: The user is not authorized to create venues delete: parameters: - in: path schema: type: integer description: the venue post ID required: true name: id responses: '200': description: Deletes a venue and returns its data content: application/json: schema: $ref: '#/components/schemas/Venue' '400': description: The venue post ID is missing or does not exist. '403': description: The current user cannot delete the venue with the specified ID. '410': description: The venue with the specified ID has been deleted already. '500': description: The venue with the specified ID could not be deleted. /venues/by-slug/{slug}: get: parameters: - in: path schema: type: string description: the venue post name required: true name: slug responses: '200': description: Returns the data of the venue with the specified post ID content: application/json: schema: $ref: '#/components/schemas/Venue' '400': description: The venue post ID is missing. '403': description: The venue with the specified ID is not accessible. '404': description: A venue with the specified post ID does not exist. post: parameters: - in: path schema: type: string description: the venue post name required: true name: slug requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: author: description: The venue author ID type: integer date: description: The venue publication date type: string date_utc: description: The venue publication date (UTC time zone) type: string venue: description: The venue name type: string description: description: The venue description type: string status: description: The venue post status type: string show_map: description: Whether events linked to the venue should show a map or not type: string show_map_link: description: Whether events linked to the venue should show a map link or not type: string address: description: The venue address type: string city: description: The venue city type: string country: description: The venue country type: string province: description: The venue province type: string state: description: The venue state type: string zip: description: The venue ZIP code type: string phone: description: The venue phone number type: string stateprovince: description: The venue state and province type: string website: description: The venue website URL type: string image: description: The organizer featured image ID or URL type: string responses: '200': description: Returns the data of the updated venue content: application/json: schema: $ref: '#/components/schemas/Venue' '201': description: Returns the data of the created venue content: application/json: schema: $ref: '#/components/schemas/Venue' '400': description: A required parameter is missing or an input parameter is in the wrong format '403': description: The user is not authorized to create venues delete: parameters: - in: path schema: type: string description: the venue post name required: true name: slug responses: '200': description: Deletes a venue and returns its data content: application/json: schema: $ref: '#/components/schemas/Venue' '400': description: The venue post ID is missing or does not exist. '403': description: The current user cannot delete the venue with the specified ID. '410': description: The venue with the specified ID has been deleted already. '500': description: The venue with the specified ID could not be deleted. /organizers: get: parameters: - in: query schema: type: integer description: The archive page to return required: false name: page - in: query schema: type: integer description: The number of organizers to return on each page required: false name: per_page - in: query schema: type: string description: Organizers should contain the specified string in the title, description or custom fields required: false name: search - in: query schema: type: integer description: Organizers should be related to this event required: false name: event - in: query schema: type: boolean description: Organizers should have events associated to them required: false name: has_events - in: query schema: type: boolean description: Organizers should have upcoming events associated to them required: false name: only_with_upcoming - in: query schema: type: string description: The organizer post status required: false name: status responses: '200': description: Returns all the organizers matching the search criteria content: application/json: schema: title: organizers type: array items: $ref: '#/components/schemas/Organizer' '400': description: One or more of the specified query variables has a bad format '404': description: The requested page was not found. /organizers/{id}: get: parameters: - in: path schema: type: integer description: the organizer post ID required: true name: id responses: '200': description: Returns the data of the organizer with the specified post ID content: application/json: schema: $ref: '#/components/schemas/Organizer' '400': description: The organizer post ID is missing. '403': description: The organizer with the specified ID is not accessible. '404': description: An organizer with the specified event does not exist. post: parameters: - in: path schema: type: integer description: the organizer post ID required: true name: id requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: id: description: the organizer post ID type: integer author: description: The organizer author ID type: integer date: description: The organizer publication date type: string date_utc: description: The organizer publication date (UTC time zone) type: string organizer: description: The organizer name type: string description: description: The organizer description type: string status: description: The organizer post status type: string phone: description: The organizer phone number type: string website: description: The organizer website type: string email: description: The organizer e-mail address type: string image: description: The organizer featured image ID or URL type: string responses: '201': description: Returns the data of the created organizer content: application/json: schema: $ref: '#/components/schemas/Organizer' '400': description: A required parameter is missing or an input parameter is in the wrong format '403': description: The user is not authorized to create organizers delete: parameters: - in: path schema: type: integer description: the organizer post ID required: true name: id responses: '200': description: Deletes an organizer and returns its data content: application/json: schema: $ref: '#/components/schemas/Organizer' '400': description: The organizer post ID is missing or does not exist. '403': description: The current user cannot delete the organizer with the specified ID. '410': description: The organizer with the specified ID has been deleted already. '500': description: The organizer with the specified ID could not be deleted. /organizers/by-slug/{slug}: get: parameters: - in: path schema: type: string description: the organizer post name required: true name: slug responses: '200': description: Returns the data of the organizer with the specified post ID content: application/json: schema: $ref: '#/components/schemas/Organizer' '400': description: The organizer post ID is missing. '403': description: The organizer with the specified ID is not accessible. '404': description: An organizer with the specified event does not exist. post: parameters: - in: path schema: type: string description: the organizer post name required: true name: slug requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: slug: description: the organizer post name type: string author: description: The organizer author ID type: integer date: description: The organizer publication date type: string date_utc: description: The organizer publication date (UTC time zone) type: string organizer: description: The organizer name type: string description: description: The organizer description type: string status: description: The organizer post status type: string phone: description: The organizer phone number type: string website: description: The organizer website type: string email: description: The organizer e-mail address type: string image: description: The organizer featured image ID or URL type: string responses: '201': description: Returns the data of the created organizer content: application/json: schema: $ref: '#/components/schemas/Organizer' '400': description: A required parameter is missing or an input parameter is in the wrong format '403': description: The user is not authorized to create organizers delete: parameters: - in: path schema: type: string description: the organizer post name required: true name: slug responses: '200': description: Deletes an organizer and returns its data content: application/json: schema: $ref: '#/components/schemas/Organizer' '400': description: The organizer post ID is missing or does not exist. '403': description: The current user cannot delete the organizer with the specified ID. '410': description: The organizer with the specified ID has been deleted already. '500': description: The organizer with the specified ID could not be deleted. /categories: get: parameters: - in: query schema: type: integer description: The archive page to return required: false name: page - in: query schema: type: integer description: The number of event categories to return on each page required: false name: per_page - in: query schema: type: string description: Limit results to those matching a string required: false name: search - in: query schema: type: array items: type: integer description: Ensure result set exclude specific IDs required: false name: exclude - in: query schema: type: array items: type: integer description: Limit result set to specific IDs required: false name: include - in: query schema: type: string description: Order sort attribute ascending or descending required: false name: order - in: query schema: type: string description: Sort collection by term attribute required: false name: orderby - in: query schema: type: boolean description: Whether to hide terms not assigned to any posts required: false name: hide_empty - in: query schema: type: integer description: Limit result set to terms assigned to a specific parent required: false name: parent - in: query schema: type: integer description: Limit result set to terms assigned to a specific post required: false name: post - in: query schema: type: integer description: Limit result set to terms assigned to a specific event (an alias of the "post" parameter) required: false name: event - in: query schema: type: string description: Limit result set to terms with a specific slug required: false name: slug responses: '200': description: Returns all the event categories matching the search criteria content: application/json: schema: title: categories type: array items: $ref: '#/components/schemas/Term' '400': description: One or more of the specified query variables has a bad format '404': description: The requested page was not found. /categories/{id}: get: parameters: - in: path schema: type: integer description: the event category term ID required: true name: id responses: '200': description: Returns the data of the event category with the specified term ID content: application/json: schema: $ref: '#/components/schemas/Term' '400': description: The event category term ID is missing. '404': description: An event category with the specified term ID does not exist. post: parameters: - in: path schema: type: integer description: the event category term ID required: true name: id requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: id: description: the event category term ID type: integer name: description: The event category name type: string description: description: The event category description type: string slug: description: The event category slug type: string parent: description: The event category slug type: integer responses: '200': description: Returns the data of the updated event category content: application/json: schema: $ref: '#/components/schemas/Term' '201': description: Returns the data of the created event category content: application/json: schema: $ref: '#/components/schemas/Term' '400': description: A required parameter is missing or an input parameter is in the wrong format '403': description: The user is not authorized to create event categories delete: parameters: - in: path schema: type: integer description: the event category term ID required: true name: id responses: '200': description: Deletes an event category and returns its data content: application/json: schema: $ref: '#/components/schemas/Term' '400': description: The event category term ID is missing or does not exist. '403': description: The current user cannot delete the event category with the specified term ID. '410': description: The event category with the specified term ID has been deleted already. '500': description: The event category with the specified term ID could not be deleted. /tags: get: parameters: - in: query schema: type: integer description: The archive page to return required: false name: page - in: query schema: type: integer description: The number of event tags to return on each page required: false name: per_page - in: query schema: type: string description: Limit results to those matching a string required: false name: search - in: query schema: type: array items: type: integer description: Ensure result set exclude specific IDs required: false name: exclude - in: query schema: type: array items: type: integer description: Limit result set to specific IDs required: false name: include - in: query schema: type: string description: Order sort attribute ascending or descending required: false name: order - in: query schema: type: string description: Sort collection by term attribute required: false name: orderby - in: query schema: type: boolean description: Whether to hide terms not assigned to any posts required: false name: hide_empty - in: query schema: type: integer description: Limit result set to terms assigned to a specific post required: false name: post - in: query schema: type: integer description: Limit result set to terms assigned to a specific event (an alias of the "post" parameter) required: false name: event - in: query schema: type: string description: Limit result set to terms with a specific slug required: false name: slug responses: '200': description: Returns all the event tags matching the search criteria content: application/json: schema: title: tags type: array items: $ref: '#/components/schemas/Term' '400': description: One or more of the specified query variables has a bad format '404': description: No event tags match the query or the requested page was not found. /tags/{id}: get: parameters: - in: path schema: type: integer description: the event tag term ID required: true name: id responses: '200': description: Returns the data of the event tag with the specified term ID content: application/json: schema: $ref: '#/components/schemas/Term' '400': description: The event tag term ID is missing. '404': description: An event tag with the specified term ID does not exist. post: parameters: - in: path schema: type: integer description: the event tag term ID required: true name: id requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: name: description: The event tag name type: string description: description: The event tag description type: string slug: description: The event tag slug type: string responses: '200': description: Returns the data of the updated event tag content: application/json: schema: $ref: '#/components/schemas/Term' '201': description: Returns the data of the created event tag content: application/json: schema: $ref: '#/components/schemas/Term' '400': description: A required parameter is missing or an input parameter is in the wrong format '403': description: The user is not authorized to create event tags delete: parameters: - in: path schema: type: integer description: the event tag term ID required: true name: id responses: '200': description: Deletes an event tag and returns its data content: application/json: schema: $ref: '#/components/schemas/Term' '400': description: The event tag term ID is missing or does not exist. '403': description: The current user cannot delete the event tag with the specified term ID. '410': description: The event tag with the specified term ID has been deleted already. '500': description: The event tag with the specified term ID could not be deleted.