---
title: "REST APIs"
slug: "rest-apis"
abstract: "Introduction to Sitecore Personalize REST APIs."
---
# REST APIs

REST APIs let you to retrieve, create, update, and delete data that is available in Sitecore Personalize.

## Overview

Sitecore Personalize exposes resources through REST APIs, which provide a flexible method of supplying various applications with data formatted in a standard way. Sitecore Personalize REST APIs support JSON resource representations.

At a fundamental level, you can use the REST APIs to provide synchronous access to Sitecore Personalize. You can use the REST APIs to update data or to read the current state of data. REST APIs meet crucial integration requirements and allow data to be easily combined using mashups, while enabling you to extend on a set of base, REST services. For example, you might want to use your own custom attributes and make these available to Sitecore Personalize resources. To do this, you can use a data extension resource, which is a schema-less JSON object that permits specific name-value pairs.

![Data capturing.](https://doc.sitecore.com/api/markdown-image/personalize/en/developers/api/images/personalize-diagram-rest-apis.jpg)

The following are characteristics of the REST APIs:

- Support synchronous calls
- Report processing errors
- Support server-side requests
- Session authentication
- Read and write data
- Online Data Capture (ODC)

## When to use REST APIs

An Integration Engineer can use the REST APIs before a Marketer or Analyst sets up experiments that initiate dynamic content and offers.

You can use the following REST APIs as an alternative to using the Sitecore Personalize application:

- [Connection REST API](https://doc.sitecore.com/personalize/en/developers/api/rest-apis/connection-rest-api.html "Connection REST API") - to [connect to external systems](https://doc.sitecore.com/personalize/en/users/sitecore-personalize/connecting-sitecore-personalize-to-an-external-system.html).
- [Decision model](https://doc.sitecore.com/personalize/en/developers/api/rest-apis/decision-model-rest-api.html "Decision model REST API") and [Decision model variant](https://doc.sitecore.com/personalize/en/developers/api/rest-apis/decision-model-variant-rest-api.html "Decision model variant REST API") REST APIs - to work with [decisioning](https://doc.sitecore.com/personalize/en/users/sitecore-personalize/introduction-to-decisioning-in-sitecore-personalize.html).
- [Flow definition REST API](https://doc.sitecore.com/personalize/en/developers/api/rest-apis/flow-definition-rest-api.html "Flow definition REST API") - to work with web, interactive, and triggered [experiments](https://doc.sitecore.com/personalize/en/users/sitecore-personalize/introduction-to-experiments-in-sitecore-personalize.html) and [experiences](https://doc.sitecore.com/personalize/en/users/sitecore-personalize/introduction-to-experiences.html).
- [Template REST API](https://doc.sitecore.com/personalize/en/developers/api/rest-apis/template-rest-api.html "Template REST API") - to work with [web templates](https://doc.sitecore.com/personalize/en/users/sitecore-personalize/en/web-templates.html) and [decision templates](https://doc.sitecore.com/personalize/en/users/sitecore-personalize/en/decision-templates.html).

Sitecore Personalize enables you to deploy a suite of interactive web services that expose the URL endpoints for retrieving and updating REST resources. The REST topics contain the following information:

- Resource attributes
- Example requests
- Example responses