Sign in
Events

Delete an event by external id

Changed on

Resolves the event carrying the (extKey, extId) pair and removes it. When the agenda is the event's origin this deletes the event; otherwise it de-references it from this agenda (the origin keeps it). Answers 200 with a DeletionResult carrying the resolved uid.

The acting member must be allowed to remove the event, otherwise 403. An unknown pair answers 404.

delete/agendas/{agendaUid}/events/ext/{extKey}/{extId}

Request

  • Base URL: https://api.openagenda.com/v3
  • URL: https://api.openagenda.com/v3/agendas/{agendaUid}/events/ext/{extKey}/{extId}
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://openagenda.com/api/auth/oauth2/authorize, token URL https://openagenda.com/api/auth/oauth2/token, scopes: events:write)

Path parameters

agendaUidinteger required

Numeric uid of the agenda.

extKeystring required

Name of the external system/source the identifier belongs to (the key of an ExtId mapping carried on the resource — an event or a location).

extIdstring required

The resource's identifier within that external system (the value of an ExtId mapping carried in the resource's extIds). Percent-encode reserved characters.

Response

The event was removed from this agenda.

uidinteger required
deletedtrue required

Changes

  • 504611f6f282Revision changes
    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      added the new bad_request enum value to the / response property for the response status

    • warning

      added the new bad_request enum value to the / response property for the response status

    • warning

      added the new bad_request enum value to the / response property for the response status

    • warning

      added the new forbidden enum value to the / response property for the response status

    • warning

      added the new forbidden enum value to the / response property for the response status

    • warning

      added the new forbidden enum value to the / response property for the response status

    • warning

      added the new insufficient_scope enum value to the / response property for the response status

    • warning

      added the new insufficient_scope enum value to the / response property for the response status

    • warning

      added the new insufficient_scope enum value to the / response property for the response status

    • warning

      added the new not_found enum value to the / response property for the response status

    • warning

      added the new not_found enum value to the / response property for the response status

    • warning

      added the new not_found enum value to the / response property for the response status

    • warning

      added the new read_only_credential enum value to the / response property for the response status

    • warning

      added the new read_only_credential enum value to the / response property for the response status

    • warning

      added the new read_only_credential enum value to the / response property for the response status

    • warning

      added the new service_unavailable enum value to the / response property for the response status

    • warning

      added the new service_unavailable enum value to the / response property for the response status

    • warning

      added the new service_unavailable enum value to the / response property for the response status

    • warning

      added the new unauthorized enum value to the / response property for the response status

    • warning

      added the new unauthorized enum value to the / response property for the response status

    • warning

      added the new unauthorized enum value to the / response property for the response status

  • 550dac9bcc88Revision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      removed the bad_request enum value from the / response property for the response status

    • info

      removed the bad_request enum value from the / response property for the response status

    • info

      removed the bad_request enum value from the / response property for the response status

    • info

      removed the forbidden enum value from the / response property for the response status

    • info

      removed the forbidden enum value from the / response property for the response status

    • info

      removed the forbidden enum value from the / response property for the response status

    • info

      removed the insufficient_scope enum value from the / response property for the response status

    • info

      removed the insufficient_scope enum value from the / response property for the response status

    • info

      removed the insufficient_scope enum value from the / response property for the response status

    • info

      removed the not_found enum value from the / response property for the response status

    • info

      removed the not_found enum value from the / response property for the response status

    • info

      removed the not_found enum value from the / response property for the response status

    • info

      removed the read_only_credential enum value from the / response property for the response status

    • info

      removed the read_only_credential enum value from the / response property for the response status

    • info

      removed the read_only_credential enum value from the / response property for the response status

    • info

      removed the service_unavailable enum value from the / response property for the response status

    • info

      removed the service_unavailable enum value from the / response property for the response status

    • info

      removed the service_unavailable enum value from the / response property for the response status

    • info

      removed the unauthorized enum value from the / response property for the response status

    • info

      removed the unauthorized enum value from the / response property for the response status

    • info

      removed the unauthorized enum value from the / response property for the response status