Discord API · error code

Discord error 520003: Cannot edit a poll message

Permanent - do not retryHTTP 400Validation and request shape

Last verified against Discord Developer Docs - Opcodes and status codes

What Discord returns
Cannot edit a poll message

What error 520003 means

Polls cannot be edited after they are sent. You called PATCH /channels/{channel.id}/messages/{message.id} on a message that contains a poll, and Discord refused. The question, answers and duration are fixed once the poll goes out.

Bots that update a "live results" message in place hit this when the poll itself is that message. The same applies to editing the original interaction response when it contains a poll.

If you need a different question or answer set, end the poll (see 520001) or delete the message, then send a new poll. For live result displays, post a separate message and edit that one instead.

Other messages around the poll are unaffected; you can still reply to it, pin it, or post results in a thread under it. Only the poll message itself is locked against edits.

What it looks like

{
  "message": "Cannot edit a poll message",
  "code": 520003
}

Why it happens

  • PATCH on a message that contains a poll
  • Editing an interaction's original response that holds a poll
  • Shared update helper used for both poll and status messages
  • Correction workflow that tries to fix a typo in a poll answer

How to fix Discord error 520003

  1. 1Do not edit poll messages; send a new poll if the question changes
  2. 2Keep live result summaries in a separate message you can edit
  3. 3Delete or expire the old poll if it is no longer valid
  4. 4Retry the status update against the separate message
  5. 5If a poll was sent with a mistake, expire it and post a corrected poll

How to stop it recurring

Treat poll messages as immutable. Validate questions and answers before sending, and give status updates their own message. Expiring a message that has no poll is a different error, 520006. Keep poll creation in one function that validates input first.

Official reference: Discord Developer Docs - Opcodes and status codes. See all Discord error codes or the Discord limits and quotas.

Related codes

Error 520003 - quick answers

What does Discord error 520003 mean?

Polls cannot be edited after they are sent. You called PATCH /channels/{channel.id}/messages/{message.id} on a message that contains a poll, and Discord refused. The question, answers and duration are fixed once the poll goes out. Bots that update a "live results" message in place hit this when the poll itself is that message. The same applies to editing the original interaction response when it contains a poll.

How do I fix Discord error 520003?

1. Do not edit poll messages; send a new poll if the question changes 2. Keep live result summaries in a separate message you can edit 3. Delete or expire the old poll if it is no longer valid 4. Retry the status update against the separate message 5. If a poll was sent with a mistake, expire it and post a corrected poll

Should I retry after error 520003?

No. Retrying the same request produces the same error; the condition has to be fixed first. Treat it as a permanent failure for that message and surface it, rather than looping.

Stop debugging Discord by hand

Connect the channel through Conferbot: tokens, webhooks and retries are handled, failures show as readable status.