BasicPage API

A basic page is a non-scored, non-question item that appears to candidates during a test. Basic pages are either Introduction Pages, Information Pages, or Finish Pages.

This article explains what calls can be made to the Surpass API using the BasicPage resource.

Import this API into your Postman Workspace

In This Article

Basic Pages

The BasicPage API resource can be used to retrieve, create, and update Introduction Pages, Information Pages, and Finish Pages. For information on question items and surveys, read Item API.

To learn more about items, see the Item Authoring section of the Surpass documentation.

Retrieving basic page information

get /api/v2/BasicPage/{id}

Send a request to the endpoint to retrieve information for a specific basic page using its ID. No request body is required.

Creating a basic page

post /api/v2/BasicPage

Send a request to the endpoint to create a basic page.

Updating a basic page

put /api/v2/BasicPage/{id}

Send a request to the endpoint to update a specific basic page.

Assistive Media

Assistive media are small audio and video files that can be added to items so that candidates can hear content in a chosen language or watch a visual aid. Assistive media can be used to improve the accessibility of your items or create unique assessment materials (for example, language testing).

The BasicPage API resource can be used to retrieve and update assistive media.

To learn more about assistive media, read Adding assistive media to an item and Using assistive media in the test driver.

Retrieving assistive media information

get /api/v2/BasicPage/{id}/AssistiveMedia/{id}

Send a request to the endpoint to retrieve information for a specific piece of assistive media using its ID. Refer to the available parameters to influence the response. No request body is required.

Updating assistive media

put /api/v2/BasicPage/{id}/AssistiveMedia/{id}

Send a request to the endpoint to update a specific basic page’s assistive media.

Error Codes

Refer to the following table for information on error codes that may be encountered when using this resource.

Further reading

Read the following articles to learn more about similar APIs, how to get started with the Surpass API v2, and how to get the best out of this reference documentation:

NOTE: This form is to provide feedback to help improve the Surpass Help documentation only. If you need live support, contact support@surpass.com.