Discord API · error code

Discord error 10070: Unknown guild scheduled event

Permanent - do not retryHTTP 404Unknown resource (10xxx)

Last verified against Discord Developer Docs - Opcodes and status codes

What Discord returns
Unknown Guild Scheduled Event

What error 10070 means

The scheduled event ID in your request does not exist in the guild named in the URL. You get it from the event routes, GET, PATCH and DELETE /guilds/{guild.id}/scheduled-events/{guild_scheduled_event.id}, and from the event-users listing.

Events are deleted when a moderator removes them, and a bot that created an event and saved its ID can be left holding a reference to nothing. Event IDs are also guild-scoped, so pairing an event ID with the wrong guild ID fails the same way.

This is not a permission failure. Creating or editing events without Manage Events (or the newer create-events permission) returns 50013. Hitting the cap on open events is 30038.

Event IDs are snowflakes, so they encode when the event was created but say nothing about whether it still exists; only a fresh fetch answers that.

What it looks like

{
  "message": "Unknown Guild Scheduled Event",
  "code": 10070
}

Why it happens

  • Event was deleted in the Discord client after your bot stored its ID
  • Event ID used with the wrong guild ID
  • A reminder or announcement job fired after the event was cancelled and removed
  • Snowflake stored as a number and corrupted

How to fix Discord error 10070

  1. 1List events with GET /guilds/{guild.id}/scheduled-events and confirm the ID is present
  2. 2Verify the guild ID in the URL
  3. 3Handle GUILD_SCHEDULED_EVENT_DELETE and cancel any jobs tied to that event
  4. 4On 10070 in a scheduled job, mark the job finished instead of retrying

How to stop it recurring

Tie every reminder or follow-up job to the event's lifecycle events (create, update, delete) so a removed event cancels its jobs immediately. Store event IDs as strings together with their guild ID, and treat 10070 inside background work as a cleanup signal rather than an error worth retrying.

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

Related codes

Error 10070 - quick answers

What does Discord error 10070 mean?

The scheduled event ID in your request does not exist in the guild named in the URL. You get it from the event routes, GET , PATCH and DELETE /guilds/{guild.id}/scheduled-events/{guild_scheduled_event.id} , and from the event-users listing. Events are deleted when a moderator removes them, and a bot that created an event and saved its ID can be left holding a reference to nothing.

How do I fix Discord error 10070?

1. List events with GET /guilds/{guild.id}/scheduled-events and confirm the ID is present 2. Verify the guild ID in the URL 3. Handle GUILD_SCHEDULED_EVENT_DELETE and cancel any jobs tied to that event 4. On 10070 in a scheduled job, mark the job finished instead of retrying

Should I retry after error 10070?

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.