Skip to main content
POST
/
v1
/
auth
/
rotate-app
Rotate app credentials
curl --request POST \
  --url https://api.vendaze.com/v1/auth/rotate-app \
  --header 'Content-Type: application/json' \
  --data '
{
  "client_id": "9a8b7c6d-5e4f-3a2b-1c0d-9e8f7a6b5c4d",
  "app_name": "My SaaS v2",
  "redirect_uris": [
    "https://mysaas.com/callback/vendaze"
  ],
  "scopes": [
    "people:read",
    "deals:write"
  ],
  "description": "Updated integration with Vendaze.",
  "avatar_url": "https://mysaas.com/assets/vendaze-avatar-v2.webp"
}
'
{
  "data": {
    "app_name": "My SaaS v2",
    "client_id": "1b2c3d4e-5f6a-7b8c-9d0e-1f2a3b4c5d6e",
    "message": "New credentials sent to dev@mysaas.com"
  }
}

Documentation Index

Fetch the complete documentation index at: https://developers.vendaze.com/llms.txt

Use this file to discover all available pages before exploring further.

Body

application/json
​
client_id
string<uuid>
required

Current client_id of the app being rotated.

Example:

"9a8b7c6d-5e4f-3a2b-1c0d-9e8f7a6b5c4d"

​
app_name
string
required
Maximum string length: 100
Example:

"My SaaS v2"

​
redirect_uris
string<uri>[]
required

New list of redirect URIs. Replaces the previous list entirely.

Example:
["https://mysaas.com/callback/vendaze"]
​
scopes
enum<string>[]
required

New list of scopes. Replaces the previous list entirely.

A single OAuth scope value.

Available options:
people:read,
people:write,
companies:read,
companies:write,
deals:read,
deals:write,
tasks:read,
tasks:write,
activities:read,
activities:write,
products:read,
products:write,
tags:read,
tags:write,
lists:read,
lists:write,
custom_fields:read,
custom_fields:write
Example:
["people:read", "deals:write"]
​
description
string
Maximum string length: 500
Example:

"Updated integration with Vendaze."

​
avatar_url
string<uri>

URL of the app avatar shown on the consent screen. Must be a publicly accessible HTTPS URL pointing to a WebP image. Maximum dimensions: 400x400 px.

Example:

"https://mysaas.com/assets/vendaze-avatar-v2.webp"

Response

Credentials rotated successfully. New credentials sent by email.

​
data
object