secrets

Return a website approval URL so the account owner can grant a saved package use of one external secret-provider ref ...

Return a website approval URL so the account owner can grant a saved package use of one external secret-provider ref (canonical i/<item-id>/<field>: UUID or 1Password Connect 26-char id). This capability does not change grants. Send the approval_url to the user and wait. Ad hoc execute does not need this grant; saved packages do.

Org permission: secret:use.

post/v1/secret-providers/{provider}/lock

Request

  • Base URL: https://api.kody.codes
  • URL: https://api.kody.codes/v1/secret-providers/{provider}/lock
  • Auth: HTTP bearer

Path parameters

providerstring required

Provider id, for example 1password.

Request body

refstring required

Canonical i/<item-id>/<field> ref (UUID or 1Password Connect 26-char id), or an op:// synonym that already contains that item id.

package_idstring required

Saved package id that may use this provider ref.

Response

Success.

providerstring required
canonical_refstring required
package_idstring required
usage_urlstring required
status'approval_required' | 'already_granted' required
approval_urlstring required
messagestring required

Changes

No recorded changes to this operation across all 3 revisions of this API.