# Talque Room Webhook API

## Create a room via webhook

> Creates a new room in the organization.

```json
{"openapi":"3.0.3","info":{"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"}}}}}}
```

## Update a room via webhook

> Updates an existing room in the organization.

```json
{"openapi":"3.0.3","info":{"title":"Talque Room Webhook API","version":"1.0.0"},"paths":{"/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"}}}}}}
```

## Delete a room via webhook

> 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.

```json
{"openapi":"3.0.3","info":{"title":"Talque Room Webhook API","version":"1.0.0"},"paths":{"/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."}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://talque.gitbook.io/public/webhooks/room/talque-room-webhook-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.