API v1 ReferenceAgent Skills

Updates skill secret requirements.

Replaces the list of secrets a skill needs and returns the resulting requirements. <Check title="Required Permissions" icon="key">Any authenticated user.</Check>

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

skillIdstringRequiredformat: "uuid"
The skill ID.

Request

The request payload.
requirementslist of objectsRequired
The full set of secret requirements for the skill.

Response

OK
idstringOptionalformat: "uuid"
The secret requirement identifier.
envVarNamestring or nullOptional
The environment variable name the secret is injected as.
descriptionstring or nullOptional
The description shown to users when providing the secret.
scopeenumOptional
Who must provide the secret value.
isRequiredbooleanOptional
Whether the secret is required for the skill to work.
hasValuebooleanOptional
Whether a value is available for the requesting user.

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error