{
    "info": {
        "description": "\n            External API that allows you to create, update, and delete rooms (venues for lectures)\n            ",
        "title": "Talque Room Webhook API",
        "version": "1.0.0"
    },
    "paths": {
        "/webhook/org/{orgId}/room/create": {
            "post": {
                "summary": "Create a room via webhook",
                "description": "Creates a new room in the organization.",
                "parameters": [
                    {
                        "name": "orgId",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "The unique identifier of the organization."
                    },
                    {
                        "name": "X-TQ-CLIENT-ID",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "The API client ID for authentication."
                    },
                    {
                        "name": "X-TQ-SECRET",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "The API client secret for authentication."
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "extId": {
                                        "type": "string",
                                        "nullable": true,
                                        "description": "Optional external identifier for the room."
                                    },
                                    "name": {
                                        "$schema": "http://json-schema.org/draft-04/schema",
                                        "type": "object",
                                        "properties": {
                                            "DE_DE": {
                                                "type": "string"
                                            },
                                            "EN_US": {
                                                "type": "string"
                                            },
                                            "FR_FR": {
                                                "type": "string"
                                            },
                                            "ES_ES": {
                                                "type": "string"
                                            },
                                            "PT_PT": {
                                                "type": "string"
                                            },
                                            "ZH_CN": {
                                                "type": "string"
                                            },
                                            "UK_UA": {
                                                "type": "string"
                                            },
                                            "AR_EG": {
                                                "type": "string"
                                            },
                                            "RU_RU": {
                                                "type": "string"
                                            },
                                            "FA_IR": {
                                                "type": "string"
                                            },
                                            "NL_NL": {
                                                "type": "string"
                                            }
                                        },
                                        "additionalProperties": false,
                                        "description": "The translated text name of the location."
                                    },
                                    "pubName": {
                                        "$schema": "http://json-schema.org/draft-04/schema",
                                        "type": "object",
                                        "properties": {
                                            "DE_DE": {
                                                "type": "string"
                                            },
                                            "EN_US": {
                                                "type": "string"
                                            },
                                            "FR_FR": {
                                                "type": "string"
                                            },
                                            "ES_ES": {
                                                "type": "string"
                                            },
                                            "PT_PT": {
                                                "type": "string"
                                            },
                                            "ZH_CN": {
                                                "type": "string"
                                            },
                                            "UK_UA": {
                                                "type": "string"
                                            },
                                            "AR_EG": {
                                                "type": "string"
                                            },
                                            "RU_RU": {
                                                "type": "string"
                                            },
                                            "FA_IR": {
                                                "type": "string"
                                            },
                                            "NL_NL": {
                                                "type": "string"
                                            }
                                        },
                                        "additionalProperties": false
                                    },
                                    "color": {
                                        "type": "string",
                                        "nullable": true,
                                        "description": "A HTML color code for the location."
                                    },
                                    "capacity": {
                                        "type": "integer",
                                        "nullable": true,
                                        "description": "The maximum occupancy of the location."
                                    },
                                    "mapUrl": {
                                        "type": "string",
                                        "description": "Optional URL for a map/location."
                                    },
                                    "geoPt": {
                                        "$schema": "http://json-schema.org/draft-04/schema",
                                        "title": "geo point",
                                        "type": "object",
                                        "properties": {
                                            "lat": {
                                                "type": "number",
                                                "minimum": -90,
                                                "maximum": 90
                                            },
                                            "lon": {
                                                "type": "number",
                                                "minimum": -180,
                                                "maximum": 180
                                            }
                                        },
                                        "required": [
                                            "lat",
                                            "lon"
                                        ],
                                        "additionalProperties": false,
                                        "nullable": true
                                    },
                                    "video": {
                                        "$schema": "http://json-schema.org/draft-04/schema",
                                        "type": "object",
                                        "properties": {
                                            "DE_DE": {
                                                "type": "string"
                                            },
                                            "EN_US": {
                                                "type": "string"
                                            },
                                            "FR_FR": {
                                                "type": "string"
                                            },
                                            "ES_ES": {
                                                "type": "string"
                                            },
                                            "PT_PT": {
                                                "type": "string"
                                            },
                                            "ZH_CN": {
                                                "type": "string"
                                            },
                                            "UK_UA": {
                                                "type": "string"
                                            },
                                            "AR_EG": {
                                                "type": "string"
                                            },
                                            "RU_RU": {
                                                "type": "string"
                                            },
                                            "FA_IR": {
                                                "type": "string"
                                            },
                                            "NL_NL": {
                                                "type": "string"
                                            }
                                        },
                                        "additionalProperties": false,
                                        "nullable": true,
                                        "description": "Optional video/livestream URL(s)."
                                    }
                                },
                                "required": [
                                    "name",
                                    "pubName",
                                    "color",
                                    "capacity",
                                    "mapUrl",
                                    "geoPt"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Room successfully created",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "success": {
                                            "type": "boolean",
                                            "description": "Whether the room was successfully created."
                                        },
                                        "room": {
                                            "type": "object",
                                            "properties": {
                                                "roomId": {
                                                    "type": "string",
                                                    "description": "The unique ID of the room."
                                                },
                                                "mtime": {
                                                    "type": "string",
                                                    "format": "date-time",
                                                    "description": "The last modification time of the record."
                                                },
                                                "order": {
                                                    "type": "integer",
                                                    "description": "A sort key for ordering the rooms whenever a list of rooms is presented in the UI."
                                                },
                                                "name": {
                                                    "$schema": "http://json-schema.org/draft-04/schema",
                                                    "type": "object",
                                                    "properties": {
                                                        "DE_DE": {
                                                            "type": "string"
                                                        },
                                                        "EN_US": {
                                                            "type": "string"
                                                        },
                                                        "FR_FR": {
                                                            "type": "string"
                                                        },
                                                        "ES_ES": {
                                                            "type": "string"
                                                        },
                                                        "PT_PT": {
                                                            "type": "string"
                                                        },
                                                        "ZH_CN": {
                                                            "type": "string"
                                                        },
                                                        "UK_UA": {
                                                            "type": "string"
                                                        },
                                                        "AR_EG": {
                                                            "type": "string"
                                                        },
                                                        "RU_RU": {
                                                            "type": "string"
                                                        },
                                                        "FA_IR": {
                                                            "type": "string"
                                                        },
                                                        "NL_NL": {
                                                            "type": "string"
                                                        }
                                                    },
                                                    "additionalProperties": false,
                                                    "description": "The translated text name of the location."
                                                },
                                                "pubName": {
                                                    "$schema": "http://json-schema.org/draft-04/schema",
                                                    "type": "object",
                                                    "properties": {
                                                        "DE_DE": {
                                                            "type": "string"
                                                        },
                                                        "EN_US": {
                                                            "type": "string"
                                                        },
                                                        "FR_FR": {
                                                            "type": "string"
                                                        },
                                                        "ES_ES": {
                                                            "type": "string"
                                                        },
                                                        "PT_PT": {
                                                            "type": "string"
                                                        },
                                                        "ZH_CN": {
                                                            "type": "string"
                                                        },
                                                        "UK_UA": {
                                                            "type": "string"
                                                        },
                                                        "AR_EG": {
                                                            "type": "string"
                                                        },
                                                        "RU_RU": {
                                                            "type": "string"
                                                        },
                                                        "FA_IR": {
                                                            "type": "string"
                                                        },
                                                        "NL_NL": {
                                                            "type": "string"
                                                        }
                                                    },
                                                    "additionalProperties": false
                                                },
                                                "color": {
                                                    "type": "string",
                                                    "nullable": true,
                                                    "description": "A HTML color code for the location."
                                                },
                                                "capacity": {
                                                    "type": "integer",
                                                    "nullable": true,
                                                    "description": "The maximum occupancy of the location."
                                                },
                                                "extId": {
                                                    "type": "string",
                                                    "nullable": true,
                                                    "description": "Optional external identifier."
                                                }
                                            },
                                            "required": [
                                                "roomId",
                                                "mtime",
                                                "order",
                                                "name",
                                                "pubName"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "success",
                                        "room"
                                    ]
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request (e.g., room already exists or missing required fields)"
                    },
                    "401": {
                        "description": "Unauthorized"
                    },
                    "403": {
                        "description": "Forbidden"
                    },
                    "404": {
                        "description": "Organization not found"
                    }
                }
            }
        },
        "/webhook/org/{orgId}/room/update": {
            "post": {
                "summary": "Update a room via webhook",
                "description": "Updates an existing room in the organization.",
                "parameters": [
                    {
                        "name": "orgId",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "The unique identifier of the organization."
                    },
                    {
                        "name": "X-TQ-CLIENT-ID",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "The API client ID for authentication."
                    },
                    {
                        "name": "X-TQ-SECRET",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "The API client secret for authentication."
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "roomId": {
                                        "type": "string",
                                        "description": "The unique ID of the room."
                                    },
                                    "extId": {
                                        "type": "string",
                                        "nullable": true,
                                        "description": "The external identifier of the room."
                                    },
                                    "order": {
                                        "type": "integer",
                                        "description": "A sort key for ordering the rooms whenever a list of rooms is presented in the UI."
                                    },
                                    "name": {
                                        "$schema": "http://json-schema.org/draft-04/schema",
                                        "type": "object",
                                        "properties": {
                                            "DE_DE": {
                                                "type": "string"
                                            },
                                            "EN_US": {
                                                "type": "string"
                                            },
                                            "FR_FR": {
                                                "type": "string"
                                            },
                                            "ES_ES": {
                                                "type": "string"
                                            },
                                            "PT_PT": {
                                                "type": "string"
                                            },
                                            "ZH_CN": {
                                                "type": "string"
                                            },
                                            "UK_UA": {
                                                "type": "string"
                                            },
                                            "AR_EG": {
                                                "type": "string"
                                            },
                                            "RU_RU": {
                                                "type": "string"
                                            },
                                            "FA_IR": {
                                                "type": "string"
                                            },
                                            "NL_NL": {
                                                "type": "string"
                                            }
                                        },
                                        "additionalProperties": false,
                                        "description": "The translated text name of the location."
                                    },
                                    "pubName": {
                                        "$schema": "http://json-schema.org/draft-04/schema",
                                        "type": "object",
                                        "properties": {
                                            "DE_DE": {
                                                "type": "string"
                                            },
                                            "EN_US": {
                                                "type": "string"
                                            },
                                            "FR_FR": {
                                                "type": "string"
                                            },
                                            "ES_ES": {
                                                "type": "string"
                                            },
                                            "PT_PT": {
                                                "type": "string"
                                            },
                                            "ZH_CN": {
                                                "type": "string"
                                            },
                                            "UK_UA": {
                                                "type": "string"
                                            },
                                            "AR_EG": {
                                                "type": "string"
                                            },
                                            "RU_RU": {
                                                "type": "string"
                                            },
                                            "FA_IR": {
                                                "type": "string"
                                            },
                                            "NL_NL": {
                                                "type": "string"
                                            }
                                        },
                                        "additionalProperties": false
                                    },
                                    "color": {
                                        "type": "string",
                                        "nullable": true,
                                        "description": "A HTML color code for the location."
                                    },
                                    "capacity": {
                                        "type": "integer",
                                        "nullable": true,
                                        "description": "The maximum occupancy of the location."
                                    },
                                    "mapUrl": {
                                        "type": "string",
                                        "description": "Optional URL for a map/location."
                                    },
                                    "geoPt": {
                                        "$schema": "http://json-schema.org/draft-04/schema",
                                        "title": "geo point",
                                        "type": "object",
                                        "properties": {
                                            "lat": {
                                                "type": "number",
                                                "minimum": -90,
                                                "maximum": 90
                                            },
                                            "lon": {
                                                "type": "number",
                                                "minimum": -180,
                                                "maximum": 180
                                            }
                                        },
                                        "required": [
                                            "lat",
                                            "lon"
                                        ],
                                        "additionalProperties": false,
                                        "nullable": true
                                    },
                                    "video": {
                                        "$schema": "http://json-schema.org/draft-04/schema",
                                        "type": "object",
                                        "properties": {
                                            "DE_DE": {
                                                "type": "string"
                                            },
                                            "EN_US": {
                                                "type": "string"
                                            },
                                            "FR_FR": {
                                                "type": "string"
                                            },
                                            "ES_ES": {
                                                "type": "string"
                                            },
                                            "PT_PT": {
                                                "type": "string"
                                            },
                                            "ZH_CN": {
                                                "type": "string"
                                            },
                                            "UK_UA": {
                                                "type": "string"
                                            },
                                            "AR_EG": {
                                                "type": "string"
                                            },
                                            "RU_RU": {
                                                "type": "string"
                                            },
                                            "FA_IR": {
                                                "type": "string"
                                            },
                                            "NL_NL": {
                                                "type": "string"
                                            }
                                        },
                                        "additionalProperties": false,
                                        "nullable": true,
                                        "description": "Optional video/livestream URL(s)."
                                    }
                                },
                                "description": "Identification of the room to be updated (roomId or extId) and the fields to update."
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Room successfully updated",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "success": {
                                            "type": "boolean",
                                            "description": "Whether the room was successfully updated."
                                        },
                                        "room": {
                                            "type": "object",
                                            "properties": {
                                                "roomId": {
                                                    "type": "string",
                                                    "description": "The unique ID of the room."
                                                },
                                                "mtime": {
                                                    "type": "string",
                                                    "format": "date-time",
                                                    "description": "The last modification time of the record."
                                                },
                                                "order": {
                                                    "type": "integer",
                                                    "description": "A sort key for ordering the rooms whenever a list of rooms is presented in the UI."
                                                },
                                                "name": {
                                                    "$schema": "http://json-schema.org/draft-04/schema",
                                                    "type": "object",
                                                    "properties": {
                                                        "DE_DE": {
                                                            "type": "string"
                                                        },
                                                        "EN_US": {
                                                            "type": "string"
                                                        },
                                                        "FR_FR": {
                                                            "type": "string"
                                                        },
                                                        "ES_ES": {
                                                            "type": "string"
                                                        },
                                                        "PT_PT": {
                                                            "type": "string"
                                                        },
                                                        "ZH_CN": {
                                                            "type": "string"
                                                        },
                                                        "UK_UA": {
                                                            "type": "string"
                                                        },
                                                        "AR_EG": {
                                                            "type": "string"
                                                        },
                                                        "RU_RU": {
                                                            "type": "string"
                                                        },
                                                        "FA_IR": {
                                                            "type": "string"
                                                        },
                                                        "NL_NL": {
                                                            "type": "string"
                                                        }
                                                    },
                                                    "additionalProperties": false,
                                                    "description": "The translated text name of the location."
                                                },
                                                "pubName": {
                                                    "$schema": "http://json-schema.org/draft-04/schema",
                                                    "type": "object",
                                                    "properties": {
                                                        "DE_DE": {
                                                            "type": "string"
                                                        },
                                                        "EN_US": {
                                                            "type": "string"
                                                        },
                                                        "FR_FR": {
                                                            "type": "string"
                                                        },
                                                        "ES_ES": {
                                                            "type": "string"
                                                        },
                                                        "PT_PT": {
                                                            "type": "string"
                                                        },
                                                        "ZH_CN": {
                                                            "type": "string"
                                                        },
                                                        "UK_UA": {
                                                            "type": "string"
                                                        },
                                                        "AR_EG": {
                                                            "type": "string"
                                                        },
                                                        "RU_RU": {
                                                            "type": "string"
                                                        },
                                                        "FA_IR": {
                                                            "type": "string"
                                                        },
                                                        "NL_NL": {
                                                            "type": "string"
                                                        }
                                                    },
                                                    "additionalProperties": false
                                                },
                                                "color": {
                                                    "type": "string",
                                                    "nullable": true,
                                                    "description": "A HTML color code for the location."
                                                },
                                                "capacity": {
                                                    "type": "integer",
                                                    "nullable": true,
                                                    "description": "The maximum occupancy of the location."
                                                },
                                                "extId": {
                                                    "type": "string",
                                                    "nullable": true,
                                                    "description": "Optional external identifier."
                                                }
                                            },
                                            "required": [
                                                "roomId",
                                                "mtime",
                                                "order",
                                                "name",
                                                "pubName"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "success",
                                        "room"
                                    ]
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request (e.g., missing roomId/extId or invalid data)"
                    },
                    "401": {
                        "description": "Unauthorized"
                    },
                    "403": {
                        "description": "Forbidden"
                    },
                    "404": {
                        "description": "Organization or Room not found"
                    }
                }
            }
        },
        "/webhook/org/{orgId}/room/delete": {
            "post": {
                "summary": "Delete a room via webhook",
                "description": "Permanently deletes a room and all its associated data. The room can be identified by its talque roomId or by an external identifier (extId) previously associated with it.",
                "parameters": [
                    {
                        "name": "orgId",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "The unique identifier of the organization."
                    },
                    {
                        "name": "X-TQ-CLIENT-ID",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "The API client ID for authentication."
                    },
                    {
                        "name": "X-TQ-SECRET",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "The API client secret for authentication."
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "roomId": {
                                        "type": "string",
                                        "description": "The unique ID of the room."
                                    },
                                    "extId": {
                                        "type": "string",
                                        "description": "The external identifier of the room as used in your system."
                                    }
                                },
                                "description": "Identification of the room to be deleted. One of roomId or extId must be provided."
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "The room was successfully deleted.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "success": {
                                            "type": "boolean",
                                            "description": "Indicates if the room was successfully deleted."
                                        },
                                        "roomId": {
                                            "type": "string",
                                            "description": "The unique ID of the room."
                                        }
                                    },
                                    "required": [
                                        "success",
                                        "roomId"
                                    ]
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request. Occurs if neither roomId nor extId is provided, or if the orgId is invalid."
                    },
                    "401": {
                        "description": "Unauthorized. Missing or invalid X-TQ-CLIENT-ID or X-TQ-SECRET headers."
                    },
                    "403": {
                        "description": "Forbidden. The API client does not have permission to delete rooms in this organization."
                    },
                    "404": {
                        "description": "Not Found. The organization or the specified room could not be found."
                    }
                }
            }
        }
    },
    "openapi": "3.0.3"
}