Skip to content

Restore a deleted sponsor

POST/v1/event/{eventId}/sponsors/{sponsorId}/restore

US Region: https://public-api.sessionboard.com · EU Region: https://public-api-eu.sessionboard.com

Restore a previously soft-deleted sponsor. Requires the write:sponsors scope.

Restore has the same reach as the delete it reverses: it restores the group, so a group that held both roles comes back as both a sponsor and an exhibitor, and it reappears on every event it was linked to — not only the event in the path.

Request example

Terminal window
curl --request POST \
--url 'https://public-api.sessionboard.com/v1/event/{eventId}/sponsors/{sponsorId}/restore' \
--header 'x-access-token: <api-token>'

Try it

Authorization

Your token stays in this page. It is sent only to the region above and is never saved; it is gone when you leave or reload the page.

Path parameters
POST

Authorizations

  • x-access-tokenstringheader

    Organization API token. Generate from Organization Settings → API Tokens.

  • AuthorizationBearer <token>headeror

    OAuth 2.1 access token. Obtained via the OAuth PKCE flow at /oauth/token.

Send one of these. See Authentication.

Path parameters

  • eventIdintegerpathrequired

    The event ID.

  • sponsorIdstringpathrequired

    The sponsor ID.

Responses

200application/json

Sponsor restored

A sponsor associated with an event.

  • idstring
  • friendly_idstring
  • friendly_id_rawinteger
  • namestring
  • descriptionstring
  • logo_image_urlstring
  • banner_image_urlstring
  • phonestring
  • address_line_1string
  • address_line_2string
  • address_citystring
  • address_statestring
  • address_postal_codestring
  • address_coutnrystring

    Country (note: field name contains a known typo preserved for backwards compatibility).

  • facebook_urlstring
  • instagram_urlstring
  • linkedin_urlstring
  • snapchat_usernamestring
  • tiktok_usernamestring
  • twitter_urlstring
  • website_urlstring
  • created_atstring
  • updated_atstring<date-time>

    When the sponsor last changed, from any source, including Public API creates, updates and bulk writes. Send it back as updated_at on an update for optimistic concurrency; the write returns the new value.

  • custom_fieldsCustomFieldValue[]
    Show child attributes
    • idstring
    • namestring
    • valuestring | boolean | null

      The formatted field value, or null when the field is empty. Numeric field types (number, currency, percent, quantity, formula) serialize a stored zero as its formatted value (for example "0") — null means the field has no value, not that the value is zero.

      checkbox fields serialize as the strings "Yes" (checked) and "No" (explicitly unchecked); a checkbox that was never set is null. Writes take boolean true / false.

      datetime fields serialize as ISO 8601. On event custom fields (GET /v1/events?expand=custom_fields) the value is event-local time with the event's UTC offset (for example 2026-08-15T09:00:00-03:00), falling back to the raw UTC instant (2026-08-15T12:00:00.000Z) when the event has no valid timezone. On session, speaker, sponsor, and exhibitor custom fields the value is the raw UTC instant.

      date (date-only) fields serialize as M-DD-YYYY: month without a leading zero, day with one, four-digit year (for example 9-22-2026 for 22 September 2026, 3-04-2026 for 4 March 2026). This is not ISO 8601; parse it with that exact pattern.

    • typestring
    • internal_namestring
    • created_atstring
  • translated_fieldsTranslatedField[]
    Show child attributes
    • idstring
    • namestring
    • typestring
    • parent_field_idstring
    • parent_field_sourcestring
    • parent_field_namestring
    • parent_field_internal_namestring
    • translated_languagestring
    • valuestring
  • contactsAccountContact[]
    Show child attributes
    • idstring
    • friendly_idstring
    • friendly_id_rawinteger
    • full_namestring
    • first_namestring
    • last_namestring
    • emailstring
    • photo_urlstring

      URL of the contact's headshot. Images larger than 2 MB are delivered resized from this URL, scaled to fit within 2400 x 2400 pixels (a PNG may arrive as WebP for clients that accept it). The uploaded file is stored unchanged; for full-resolution originals use the bulk download tools in Sessionboard, such as Download Headshots (Contacts, More menu).

    • company_namestring
    • titlestring
    • aboutstring
    • is_primaryboolean
    • contact_created_atstring
    • contact_updated_atstring
    • relationship_created_atstring
    • relationship_updated_atstring
  • admin_urlstring<uri> | null

    Deep link to this entity in the Sessionboard admin UI.

400

The sponsor is not deleted, so there is nothing to restore. Restore is not idempotent — check before retrying.

401

Unauthorized

403

Missing write:sponsors scope

404

No sponsor with this id on this event. A record that exists but does not hold the sponsor role — a contact, or a group linked only as the other role — is also a 404 here; look it up on the endpoint for the role it holds.

Response examples

{
"id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"friendly_id": "SPON-3",
"friendly_id_raw": 3,
"name": "TechCorp Global",
"description": "Platinum sponsor and technology partner.",
"logo_image_url": "https://cdn.sessionboard.com/logos/techcorp.png",
"phone": "+1-555-0100",
"address_city": "San Francisco",
"address_state": "CA",
"address_coutnry": "US",
"website_url": "https://www.techcorp.example.com",
"linkedin_url": "https://www.linkedin.com/company/techcorp",
"created_at": "2024-01-05T08:00:00Z",
"updated_at": "2024-02-20T12:00:00Z",
"custom_fields": [],
"translated_fields": [],
"contacts": []
}

Get release notes by email

A short digest on the days something new goes live — each change with a link to its note in the release notes. No marketing, and one click to stop.

Company email addresses only. We’ll send one email to confirm it’s you. Already use Sessionboard? You can also turn this on under Community → What’s new.