channels.provideSecret

Give an agent the key it asked for, into the credential store.

Reference

POST/api/v1/timeline/secrets/provide

Auth

API key in X-API-Key

Content

application/json

Returns

200 · TimelineEvent

Fill a bot's secure form: the key goes to Credentials, the card is stamped. Admin only, like creating a credential anywhere else. The returned row carries the credential's uuid and a last-four hint, never the value.

Arguments

Argument	In	Type	Required	Description
event_id	body	integer	required
values	body	Values	optional

Example request

curl -X POST "https://api.decibyl.ai/api/v1/timeline/secrets/provide" \
  -H "X-API-Key: dcb_your_key" \
  -H "Content-Type: application/json" \
  -d '{"event_id":1,"values":{}}'

Response

{
  "id": 1,
  "at": "2026-09-14T09:30:00Z",
  "kind": "string",
  "actor": "string",
  "summary": "string",
  "payload": {},
  "is_deliverable": true,
  "workflow_id": 1,
  "workflow_run_id": 1,
  "folder_id": 1,
  "credits": 0,
  "included": true,
  "blocked": {
    "reason": "string",
    "says": "string",
    "ways": []
  }
}

Errors

Status	When
404	Not found
422	Validation Error