API

The redirect.pizza API can be used to manage your redirects, email forwards, list your domains and view your team's quota.

View our API documentation

Authentication

When logged into your account, navigate to the 'API' tab. Here you can create an API token. You may create multiple API tokens under a single team. You can use this API token as the Bearer token in the JSON RESTful API:

curl --header "Authorization: Bearer rpa_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
https://redirect.pizza/api/v1/redirects

Scopes

You may limit API tokens to specific scopes. The following scopes are supported:

  • redirects:read
  • redirects:write
  • email-forwards:read
  • email-forwards:write
  • domains:manage
  • analytics:read
  • team:read

Tag access

You may limit API tokens to have access to specific tags only, or disallow access to specific tags. This allows you to create API tokens that may only access a subset of redirects.

Access control

Endpoints

Redirects

GET /api/v1/redirects: List all redirects.

GET /api/v1/redirects/$REDIRECTID$: Show a specific redirect by it's ID. You can fetch the ID from the list call or from the control panel.

POST /api/v1/redirects: Add a new redirect

PUT /api/v1/redirects: Update an existing redirect

DELETE /api/v1/redirects/$REDIRECTID$: Delete a redirect

Email forwards

GET /api/v1/email-forwards: List all email forwards.

GET /api/v1/email-forwards/$EMAILFORWARDID$: Show a specific email forward by it's ID. You can fetch the ID from the list call or from the control panel.

POST /api/v1/email-forwards: Add a new email forward

PUT /api/v1/email-forwards: Update an existing email forward

DELETE /api/v1/email-forwards/$EMAILFORWARDID$: Delete a email forward

Domains / Hostnames

GET /api/v1/domains: List all domains.

GET /api/v1/domains/$DOMAINID$: Show a specific domain by it's ID. You can fetch the ID from the list call or from the control panel. 

POST /api/v1/domains/$DOMAINID$/check-dns: Force-check the DNS.

Team

GET /api/v1/team: View team quota details

More articles

Can’t find the answer you’re looking for?

24 hours
E-mail us
support@redirect.pizza
Start a chat
Online 9:00 - 21:00 CEST
Phone
Available with Enterprise