Update secret in organization
Changes a secret's alias or description, or the projects an organization's secret is shared with.
Changes a secret's alias or description, or the projects an organization's secret is shared with.
bearerAuthorizationBearer <token>An access token, or an API key.
organization*stringThe organization's ID.
^org_[0-7][0-9a-hjkmnp-tv-z]{25}$secret*stringThe secret's ID.
^sec_[0-7][0-9a-hjkmnp-tv-z]{25}$application/json- body
alias?stringWhat people and software call the secret; unique in its organization or project.
^[a-z][a-z0-9_]*(/[a-z0-9_]+)*$length <= 128availability?For an organization's secret: the projects it's shared with. Changing it also takes secrets.secrets.setAvailability. Projects it's newly shared with have it at once, but those with a secret of their own under its alias, which have it once theirs is deleted or renamed. Those it's no longer shared with lose it at once, and their agents lose their grants and bindings of it; sharing it again gives them a new one.
description?stringWhat the secret is for. A shared secret's is its source's, which it may only be sent back as.
length <= 500etag?stringThe etag of the secret as read. With one, the update fails with aborted if the secret changed since.
OK
application/json- response
alias*stringWhat people and software call the secret, such as stripe/secret_key; unique in its organization or project.
availability*For an organization's secret: the projects it's shared with, which have it at once, as a secret of their own that reads its versions; stopping sharing it with a project deletes it from the project, and from its agents. A project's secret is shared with none.
createTime*stringWhen the secret was created.
date-timedescription*stringWhat the secret is for. A secret its organization shares with the project shows its source's.
etag*stringChanges with each update. Send it back when updating the secret; the update fails with aborted if the secret changed in between.
latestVersion*integerThe number of the newest enabled version, which latest names; 0 when no version is enabled. A secret its organization shares with the project shows its source's.
int32name*stringResource name, organizations/{organization_id}/secrets/{secret_id} or projects/{project_id}/secrets/{secret_id}.
source*stringFor a project's secret that its organization shares with it, the organization's secret, organizations/{organization_id}/secrets/{secret_id}, whose versions it reads; empty for any other secret. Set by kosem as the organization shares the secret, and never changed.
updateTime*stringWhen the secret, or its versions, last changed.
date-timecurl -X PATCH 'https://api.kosem.ai/v1/organizations/string/secrets/string' \
-H 'Content-Type: application/json' \
-d '{}'{
"alias": "string",
"availability": {
"allProjects": true,
"projects": [
"string"
]
},
"createTime": "2019-08-24T14:15:22Z",
"description": "string",
"etag": "string",
"latestVersion": 0,
"name": "string",
"source": "string",
"updateTime": "2019-08-24T14:15:22Z"
}