Secrets

Rotate an agent credential

post/v1/agent-secrets/{id}/rotate

Request

  • Base URL: https://api.shardflux.dev
  • URL: https://api.shardflux.dev/v1/agent-secrets/{id}/rotate
  • Auth: HTTP bearer

Path parameters

idstring uuid required

UUIDv7, lowercase canonical form.

Request body

valuestring required

Write-only UTF-8 secret, using the existing secret store.

Response

Default Response

idstring uuid required

UUIDv7, lowercase canonical form.

organization_idstring uuid required

UUIDv7, lowercase canonical form.

project_idstring uuid nullable required

UUIDv7, lowercase canonical form.

conversation_idstring nullable required
user_idstring uuid nullable required

UUIDv7, lowercase canonical form.

scope'agents' | 'project' | 'conversation' required
namestring required
descriptionstring required
current_versioninteger required
created_atstring date-time required

RFC 3339 UTC timestamp with Z.

updated_atstring date-time required

RFC 3339 UTC timestamp with Z.

last_used_atstring date-time nullable required

RFC 3339 UTC timestamp with Z.

Changes

No recorded changes to this operation across all 1 revision of this API.