Skip to content
Authrim

Prepare destination credential rotation

POST
/api/admin/destinations/{id}/credentials/prepare
Code sample: Shell / cURL 
curl --request POST \
  --url https://auth.example.com/api/admin/destinations/example/credentials/prepare \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "secret_value": "REDACTED", "backend": "r2_encrypted_object", "content_type": "text/plain" }'

Stores the next credential secret in the configured secret backend and marks rotation as prepared.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
id
required
string

Destination ID.

Request Body required

Section titled “Request Body required ”
Media type application/json
Any of:
object
secret_value
required
string
credential_value
string
plaintext
string
backend
string
Allowed values: r2_encrypted_object d1_encrypted_table
content_type
string
key
additional properties
Example 
{
  "secret_value": "REDACTED",
  "backend": "r2_encrypted_object",
  "content_type": "text/plain"
}

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Logging destination mutation result.

Media type application/json
object
item
required
object
key
additional properties
audit_id
One of:
string
version
integer
key
additional properties
Example 
{
  "item": {
    "id": "dest_123",
    "version": 2,
    "updated_at": 1770000000000
  },
  "audit_id": "audit_123"
}

default

Section titled “default ”

Error response.

Media type application/json
object
error
string
message
string
error_description
string
key
additional properties
Example generated
{
  "error": "example",
  "message": "example",
  "error_description": "example"
}