> ## Documentation Index > Fetch the complete documentation index at: https://docs.glot.com/llms.txt > Use this file to discover all available pages before exploring further. # List a room's invite links > One page of the invite links outstanding for this room, newest first. Covers every link for the room, including ones a teammate minted — `created_by` names whoever minted each. Use it to see what has been handed out, how much life is left in each link, and how many of its uses are gone. **No codes are returned, and there is no id to address a link by.** Only a hash of a code is stored, so nothing here can read one back, and a link is addressed by its code everywhere else in this API. Revoking one therefore needs the code you were given at mint time; if you no longer have it, `DELETE /v1/rooms/{room_id}` ends the room and with it every link for it. Spent and expired links are listed rather than hidden — they are still rows you own, and `used_count` against `max_uses` and `expires_at` say which are past use. Only revoking removes one, because revoking deletes it. A room in another organization, or one that never existed, returns an empty page rather than a 404 — the two are not told apart. Use `limit` and `offset` to page. ## OpenAPI ````yaml https://api.staging.glot.com/openapi.json get /v1/rooms/{room_id}/invites openapi: 3.1.0 info: title: glot-api version: 0.1.0 servers: - url: https://api.staging.glot.com security: [] tags: - name: rooms description: Create translation rooms and let participants join them. - name: invites description: Invite links that let a guest join a room without an account. - name: usage description: Minutes and charges over time, for reporting and charts. - name: billing description: Buy prepaid credit and review the balance behind it. - name: api-keys description: Create and revoke keys used to authenticate requests. - name: supported-languages description: Languages available for translation. - name: users description: The authenticated user's own profile. paths: /v1/rooms/{room_id}/invites: get: tags: - invites summary: List a room's invite links description: >- One page of the invite links outstanding for this room, newest first. Covers every link for the room, including ones a teammate minted — `created_by` names whoever minted each. Use it to see what has been handed out, how much life is left in each link, and how many of its uses are gone. **No codes are returned, and there is no id to address a link by.** Only a hash of a code is stored, so nothing here can read one back, and a link is addressed by its code everywhere else in this API. Revoking one therefore needs the code you were given at mint time; if you no longer have it, `DELETE /v1/rooms/{room_id}` ends the room and with it every link for it. Spent and expired links are listed rather than hidden — they are still rows you own, and `used_count` against `max_uses` and `expires_at` say which are past use. Only revoking removes one, because revoking deletes it. A room in another organization, or one that never existed, returns an empty page rather than a 404 — the two are not told apart. Use `limit` and `offset` to page. operationId: list_room_invites_v1_rooms__room_id__invites_get parameters: - name: room_id in: path required: true schema: type: string format: uuid title: Room Id - name: limit in: query required: false schema: type: integer maximum: 200 minimum: 1 default: 50 title: Limit - name: offset in: query required: false schema: type: integer minimum: 0 default: 0 title: Offset responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PageResponse_RoomInviteResponse_' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - HTTPBearer: [] components: schemas: PageResponse_RoomInviteResponse_: properties: items: items: $ref: '#/components/schemas/RoomInviteResponse' type: array title: Items limit: type: integer title: Limit offset: type: integer title: Offset next_offset: anyOf: - type: integer - type: 'null' title: Next Offset type: object required: - items - limit - offset - next_offset title: PageResponse[RoomInviteResponse] HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError RoomInviteResponse: properties: created_at: type: string format: date-time title: Created At created_by: type: string title: Created By expires_at: type: string format: date-time title: Expires At max_uses: type: integer title: Max Uses used_count: type: integer title: Used Count description: >- How many of `max_uses` have been redeemed. Equal to `max_uses` means the link is spent and now returns 410; so does an `expires_at` in the past. A spent or expired row is still listed — it is only revocation that removes one, because revocation deletes it. type: object required: - created_at - created_by - expires_at - max_uses - used_count title: RoomInviteResponse description: >- One of a room's outstanding invite links, as its host sees it. **No code, and no identifier for one either.** Only a hash of a code is stored, so there is nothing here to read one back from — and the row's primary key is not exposed, because an invite is addressed by its code everywhere in this API. What this listing answers is "what have we handed out for this room, and how much life is left in it": use it to see that a link exists, that it is nearly spent, or that a teammate minted one you did not know about. You do not need a code to act on what you see here: `DELETE /v1/rooms/{room_id}/invites` retires the room's links as a set, which is what this listing is for. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError securitySchemes: HTTPBearer: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.