Secrets

Add a write-only agent credential

post/v1/agent-secrets

Request

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

Request body

scope'agents' | 'project' | 'conversation' required
organization_idstring uuid

UUIDv7, lowercase canonical form.

project_idstring uuid

UUIDv7, lowercase canonical form.

conversation_idstring
namestring required
valuestring required

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

descriptionstring

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.