> ## Documentation Index > Fetch the complete documentation index at: https://dev.polltheroom.com/llms.txt > Use this file to discover all available pages before exploring further. # Remove a step > Take a slide or poll step out. The join screen stays. Needs the `decks:write` scope. ## OpenAPI ````yaml https://test.polltheroom.com/openapi.json delete /api/v1/decks/{id}/steps/{index} openapi: 3.1.0 info: title: Poll the Room API version: '1' description: >- Live polls on a presenter's own slides. A presenter (or an agent acting for one) builds a deck; the audience joins on their phones with a six-digit code and never signs up. Keys are made under Settings › API and sent as `Authorization: Bearer ptr_…`. A key belongs to a team, carries scopes, and is rate limited per hour. Plans: Free may decks:read, decks:write, rooms:read, results:read at 60 requests an hour; Pro may decks:read, decks:write, rooms:read, rooms:start, results:read at 1000 requests an hour. The same verbs are MCP tools at https://test.polltheroom.com/api/mcp. The full reference is at https://test.polltheroom.com/llms-full.txt. servers: - url: https://test.polltheroom.com security: - apiKey: [] tags: - name: decks description: A deck is a document the editor and the API both read and write. - name: rooms description: A room is one live session of a deck. paths: /api/v1/decks/{id}/steps/{index}: delete: tags: - decks summary: Remove a step description: |- Take a slide or poll step out. The join screen stays. Needs the `decks:write` scope. operationId: remove_step parameters: - name: id in: path required: true schema: type: string minLength: 1 description: The deck's id - name: index in: path required: true schema: type: integer minimum: 1 maximum: 9007199254740991 description: The step's index. 0 is the join screen and stays put - name: revision in: query required: false schema: description: >- The deck's revision you read (from get_deck or the last write). Sent, the write lands only if nobody changed the deck since; left out, it goes through regardless type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ responses: '200': description: OK content: application/json: schema: type: object properties: ok: type: boolean const: true count: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Steps in the deck now ready: type: boolean description: Every poll passes the readiness check, so a room can start problems: type: array items: type: object properties: step: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: The step's index; 0 is the join screen overlay: description: Which card on the slide, when it is one type: integer minimum: -9007199254740991 maximum: 9007199254740991 path: type: string description: The property, from the step message: type: string description: What to do, in the editor's words required: - step - path - message additionalProperties: false description: What stops it, by step; empty when ready warnings: type: array items: type: object properties: element: type: string description: The element it is about, "overlay 0", "text 1" with: description: The other element, for an overlap type: string message: type: string description: What is wrong and what to do step: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: The step's index required: - element - message - step additionalProperties: false description: >- Placements that will not read well on stage, by step: a card smaller than a fifth of the slide either way, or a card or text box over another card or text box. They do not stop a room; fix them anyway revision: type: string description: >- The deck's revision after this write; send it as `revision` with the next write to be sure nobody changed the deck in between required: - ok - count - ready - problems - warnings - revision additionalProperties: false '401': description: No usable key. content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: The key lacks the scope, or the plan does not sell it. content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: Nothing by that id within this key's reach. content: application/json: schema: $ref: '#/components/schemas/Error' '409': description: >- The deck changed since it was read: read it again with get_deck and send the new revision. content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: Over the key's hourly limit. content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: Error: type: object properties: error: type: string description: What went wrong, in a sentence fix: description: What to do about it, when we can tell type: string required: - error additionalProperties: false securitySchemes: apiKey: type: http scheme: bearer description: >- An API key from Settings › API, sent as `Authorization: Bearer ptr_…`. Shown once when made; only a hash is stored. ````