DocumentationAPI Reference
Help CenterAPI ChangelogOpenAPI SpecStatus
API Reference

Versioning

When we make backwards-incompatible changes to the API, we release new, dated versions. The latest released version is <<LATEST_VERSION>>. You are currently viewing version 2022-09-01.

All requests will use your API key's settings, unless you override the API version. To set the API version on a specific request, send a Persona-Version: <version> header.

You can visit your Dashboard to upgrade your API version. As a precaution, use API versioning to test a new API version before committing to an upgrade. Different API keys can be on different API versions.

📘

Keep track of changes and upgrades to the Persona API through our API Changelog.

Backwards compatible changes

We do NOT consider the following types of changes to be breaking changes.

🚧

Changes made on an ongoing basis

Your implementation MUST be resilient to these types of changes. In an effort to continue improving our platform, Persona makes these types of changes on an ongoing basis.

Breaking changes

We consider the following types of changes to be backwards-incompatible. When we make these changes, we release a new version of the API. You're in charge of when you get breaking changes—you get them when you upgrade your API version.

  • Removing or renaming an existing API.

  • Removing or renaming existing request parameters or headers.

  • Removing support for a previously acceptable request parameter or header value.

  • Adding a new required request parameter or header value to an existing API.

  • Adding validations or restrictions that would cause previously valid requests to be considered invalid.

  • Removing or renaming an attribute in existing API responses.

  • Changing the type of an attribute in existing API responses.

  • Changing the status code for a particular scenario (except when the existing status code is 404 or 5xx).

  • Changing the semantics of a value for an existing request parameter, header, or attribute in existing API responses.

  • Removing relationships between different Persona resources.