Secrets
The secrets operations of the v1 API.
Try it: use a key with the least scope; requests go straight from your browser to the API. The key stays in this tab's memory and is gone on reload.
List a cluster's secrets (metadata only, never values).
Ordered by creation time, oldest first. Cursor paginated.
api_keyAuthorizationBearer <alc_ API key>An A-Line.cloud API key, sent as Authorization: Bearer alc_.... Create keys in the dashboard; sessions are not accepted on /v1.
cluster_id*stringThe cluster UUID
uuidcursor?|Opaque cursor from the previous page's next_cursor.
limit?|Page size, 1 to 100 (default 25).
uint0 <= valueA page of secrets
application/json- response
One page of a v1 list.
data*array<>The items, in the documented order.
has_more*booleanWhether more items follow this page.
next_cursor?|Pass as cursor to get the next page; null on the last page.
curl 'https://api.a-line.cloud/v1/clusters/00000000-0000-4000-8000-000000000001/secrets' \ -H 'Authorization: Bearer alc_test_EXAMPLE_not_a_real_key'{ "data": [ { "created_at": "2019-08-24T14:15:22Z", "description": "string", "expires_at": "2019-08-24T14:15:22Z", "has_value": true, "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "injection_mode": "string", "keep_versions": 0, "mount_path": "string", "name": "string", "rotated_at": "2019-08-24T14:15:22Z", "scope_id": "5d3fe357-12dd-4f62-b004-6d1fb3b8454f", "scope_type": "string", "secret_type": "string", "updated_at": "2019-08-24T14:15:22Z", "value_origin": "string", "version": 0, "write_only": true } ], "has_more": true, "next_cursor": "string"}Try it: use a key with the least scope; requests go straight from your browser to the API. The key stays in this tab's memory and is gone on reload.
The value is write-only: it is never returned.
api_keyAuthorizationBearer <alc_ API key>An A-Line.cloud API key, sent as Authorization: Bearer alc_.... Create keys in the dashboard; sessions are not accepted on /v1.
cluster_id*stringThe cluster UUID
uuidCreate a secret. The value is stored encrypted and never returned.
application/json- body
Create a secret. The value is stored encrypted and never returned.
description?|Free text.
injection_mode?|env (default), file or both.
mount_path?|Where to mount a file/both secret.
name*stringThe name, unique within the cluster or environment.
secret_type?|opaque (default), database, registry or tls.
value*stringThe value (write-only).
write_only?booleanMake the key write-only: nobody can read its value back, in the console or the API (apps still receive it). One-way.
falseThe created secret
application/json- response
A secret's metadata, as the public API shows it. The value is never part of it.
created_at*stringWhen the secret was created (RFC 3339, UTC).
date-timedescription?|Free text.
expires_at?|When the value expires (RFC 3339, UTC).
date-timehas_value*booleanFalse for a secret declared without a value (in IaC) until one is set; apps do not receive it until then.
id*stringThe secret id.
uuidinjection_mode*stringHow apps receive it: env, file or both.
keep_versions?|How many replaced versions the secret keeps (1 to 100, each billed like the current value); null = the default, 10. Older ones are destroyed.
int32mount_path?|Where a file secret is mounted.
name*stringThe name, unique within its scope (the environment variable name for env injection).
rotated_at?|When the value was last rotated (RFC 3339, UTC).
date-timescope_id*stringThe id of that cluster, environment, project or app.
uuidscope_type*stringWhat the secret belongs to: cluster, environment, project or app.
secret_type*stringopaque, database, registry or tls (new values may be added).
updated_at*stringWhen the secret last changed (RFC 3339, UTC).
date-timevalue_origin*stringWho set the value: user, generated or app_credential.
version*integerThe current version; every value change adds one.
int32write_only*booleanThe value can be replaced or deleted but never read back by anyone (apps still receive it). One-way.
curl -X POST 'https://api.a-line.cloud/v1/clusters/00000000-0000-4000-8000-000000000001/secrets' \ -H 'Authorization: Bearer alc_test_EXAMPLE_not_a_real_key' \ -H 'Content-Type: application/json' \ -d '{"name":"example","value":"example"}'{ "created_at": "2019-08-24T14:15:22Z", "description": "string", "expires_at": "2019-08-24T14:15:22Z", "has_value": true, "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "injection_mode": "string", "keep_versions": 0, "mount_path": "string", "name": "string", "rotated_at": "2019-08-24T14:15:22Z", "scope_id": "5d3fe357-12dd-4f62-b004-6d1fb3b8454f", "scope_type": "string", "secret_type": "string", "updated_at": "2019-08-24T14:15:22Z", "value_origin": "string", "version": 0, "write_only": true}Try it: use a key with the least scope; requests go straight from your browser to the API. The key stays in this tab's memory and is gone on reload.
Get a cluster secret's metadata (never its value).
api_keyAuthorizationBearer <alc_ API key>An A-Line.cloud API key, sent as Authorization: Bearer alc_.... Create keys in the dashboard; sessions are not accepted on /v1.
cluster_id*stringThe cluster UUID
uuidsecret_id*stringThe secret UUID
uuidThe secret
application/json- response
A secret's metadata, as the public API shows it. The value is never part of it.
created_at*stringWhen the secret was created (RFC 3339, UTC).
date-timedescription?|Free text.
expires_at?|When the value expires (RFC 3339, UTC).
date-timehas_value*booleanFalse for a secret declared without a value (in IaC) until one is set; apps do not receive it until then.
id*stringThe secret id.
uuidinjection_mode*stringHow apps receive it: env, file or both.
keep_versions?|How many replaced versions the secret keeps (1 to 100, each billed like the current value); null = the default, 10. Older ones are destroyed.
int32mount_path?|Where a file secret is mounted.
name*stringThe name, unique within its scope (the environment variable name for env injection).
rotated_at?|When the value was last rotated (RFC 3339, UTC).
date-timescope_id*stringThe id of that cluster, environment, project or app.
uuidscope_type*stringWhat the secret belongs to: cluster, environment, project or app.
secret_type*stringopaque, database, registry or tls (new values may be added).
updated_at*stringWhen the secret last changed (RFC 3339, UTC).
date-timevalue_origin*stringWho set the value: user, generated or app_credential.
version*integerThe current version; every value change adds one.
int32write_only*booleanThe value can be replaced or deleted but never read back by anyone (apps still receive it). One-way.
curl 'https://api.a-line.cloud/v1/clusters/00000000-0000-4000-8000-000000000001/secrets/00000000-0000-4000-8000-000000000002' \ -H 'Authorization: Bearer alc_test_EXAMPLE_not_a_real_key'{ "created_at": "2019-08-24T14:15:22Z", "description": "string", "expires_at": "2019-08-24T14:15:22Z", "has_value": true, "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "injection_mode": "string", "keep_versions": 0, "mount_path": "string", "name": "string", "rotated_at": "2019-08-24T14:15:22Z", "scope_id": "5d3fe357-12dd-4f62-b004-6d1fb3b8454f", "scope_type": "string", "secret_type": "string", "updated_at": "2019-08-24T14:15:22Z", "value_origin": "string", "version": 0, "write_only": true}Try it: use a key with the least scope; requests go straight from your browser to the API. The key stays in this tab's memory and is gone on reload.
api_keyAuthorizationBearer <alc_ API key>An A-Line.cloud API key, sent as Authorization: Bearer alc_.... Create keys in the dashboard; sessions are not accepted on /v1.
cluster_id*stringThe cluster UUID
uuidsecret_id*stringThe secret UUID
uuidDeleted
curl -X DELETE 'https://api.a-line.cloud/v1/clusters/00000000-0000-4000-8000-000000000001/secrets/00000000-0000-4000-8000-000000000002' \ -H 'Authorization: Bearer alc_test_EXAMPLE_not_a_real_key'Try it: use a key with the least scope; requests go straight from your browser to the API. The key stays in this tab's memory and is gone on reload.
Set a cluster secret's value: it becomes the next version. The value is write-only: it is never returned.
api_keyAuthorizationBearer <alc_ API key>An A-Line.cloud API key, sent as Authorization: Bearer alc_.... Create keys in the dashboard; sessions are not accepted on /v1.
cluster_id*stringThe cluster UUID
uuidsecret_id*stringThe secret UUID
uuidA new value for a secret (write-only). It becomes the next version.
application/json- body
A new value for a secret (write-only). It becomes the next version.
value*stringThe new value.
The secret with its new version
application/json- response
A secret's metadata, as the public API shows it. The value is never part of it.
created_at*stringWhen the secret was created (RFC 3339, UTC).
date-timedescription?|Free text.
expires_at?|When the value expires (RFC 3339, UTC).
date-timehas_value*booleanFalse for a secret declared without a value (in IaC) until one is set; apps do not receive it until then.
id*stringThe secret id.
uuidinjection_mode*stringHow apps receive it: env, file or both.
keep_versions?|How many replaced versions the secret keeps (1 to 100, each billed like the current value); null = the default, 10. Older ones are destroyed.
int32mount_path?|Where a file secret is mounted.
name*stringThe name, unique within its scope (the environment variable name for env injection).
rotated_at?|When the value was last rotated (RFC 3339, UTC).
date-timescope_id*stringThe id of that cluster, environment, project or app.
uuidscope_type*stringWhat the secret belongs to: cluster, environment, project or app.
secret_type*stringopaque, database, registry or tls (new values may be added).
updated_at*stringWhen the secret last changed (RFC 3339, UTC).
date-timevalue_origin*stringWho set the value: user, generated or app_credential.
version*integerThe current version; every value change adds one.
int32write_only*booleanThe value can be replaced or deleted but never read back by anyone (apps still receive it). One-way.
curl -X PUT 'https://api.a-line.cloud/v1/clusters/00000000-0000-4000-8000-000000000001/secrets/00000000-0000-4000-8000-000000000002/value' \ -H 'Authorization: Bearer alc_test_EXAMPLE_not_a_real_key' \ -H 'Content-Type: application/json' \ -d '{"value":"example"}'{ "created_at": "2019-08-24T14:15:22Z", "description": "string", "expires_at": "2019-08-24T14:15:22Z", "has_value": true, "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "injection_mode": "string", "keep_versions": 0, "mount_path": "string", "name": "string", "rotated_at": "2019-08-24T14:15:22Z", "scope_id": "5d3fe357-12dd-4f62-b004-6d1fb3b8454f", "scope_type": "string", "secret_type": "string", "updated_at": "2019-08-24T14:15:22Z", "value_origin": "string", "version": 0, "write_only": true}Try it: use a key with the least scope; requests go straight from your browser to the API. The key stays in this tab's memory and is gone on reload.
Ordered by creation time, oldest first. Cursor paginated.
api_keyAuthorizationBearer <alc_ API key>An A-Line.cloud API key, sent as Authorization: Bearer alc_.... Create keys in the dashboard; sessions are not accepted on /v1.
environment_id*stringThe environment UUID
uuidcursor?|Opaque cursor from the previous page's next_cursor.
limit?|Page size, 1 to 100 (default 25).
uint0 <= valueA page of secret groups
application/json- response
One page of a v1 list.
data*array<>The items, in the documented order.
has_more*booleanWhether more items follow this page.
next_cursor?|Pass as cursor to get the next page; null on the last page.
curl 'https://api.a-line.cloud/v1/environments/00000000-0000-4000-8000-000000000001/secret-groups' \ -H 'Authorization: Bearer alc_test_EXAMPLE_not_a_real_key'{ "data": [ { "created_at": "2019-08-24T14:15:22Z", "description": "string", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "member_count": 0, "name": "string", "updated_at": "2019-08-24T14:15:22Z" } ], "has_more": true, "next_cursor": "string"}Try it: use a key with the least scope; requests go straight from your browser to the API. The key stays in this tab's memory and is gone on reload.
api_keyAuthorizationBearer <alc_ API key>An A-Line.cloud API key, sent as Authorization: Bearer alc_.... Create keys in the dashboard; sessions are not accepted on /v1.
environment_id*stringThe environment UUID
uuidA new secret group (empty; add members afterwards).
application/json- body
A new secret group (empty; add members afterwards).
description?|Free text.
name*stringThe name, unique within the environment.
The created group
application/json- response
A secret group, as the public API shows it.
created_at*stringWhen the group was created (RFC 3339, UTC).
date-timedescription?|Free text.
id*stringThe group id.
uuidmember_count*integerHow many secrets the group holds.
int64name*stringThe name, unique within the environment.
updated_at*stringWhen the group last changed (RFC 3339, UTC).
date-timecurl -X POST 'https://api.a-line.cloud/v1/environments/00000000-0000-4000-8000-000000000001/secret-groups' \ -H 'Authorization: Bearer alc_test_EXAMPLE_not_a_real_key' \ -H 'Content-Type: application/json' \ -d '{"name":"example"}'{ "created_at": "2019-08-24T14:15:22Z", "description": "string", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "member_count": 0, "name": "string", "updated_at": "2019-08-24T14:15:22Z"}Try it: use a key with the least scope; requests go straight from your browser to the API. The key stays in this tab's memory and is gone on reload.
Get a secret group with its member secrets (metadata only, never values).
api_keyAuthorizationBearer <alc_ API key>An A-Line.cloud API key, sent as Authorization: Bearer alc_.... Create keys in the dashboard; sessions are not accepted on /v1.
environment_id*stringThe environment UUID
uuidgroup_id*stringThe secret group UUID
uuidThe group and its members
application/json- response
A secret group with its members.
created_at*stringWhen the group was created (RFC 3339, UTC).
date-timedescription?|Free text.
id*stringThe group id.
uuidkeys_without_value*array<string>Member keys without a value yet.
managed_in_git?|The infra link file describing the group, null when it is not managed in git.
members*array<>The secrets in the group.
name*stringThe name, unique within the environment.
updated_at*stringWhen the group last changed (RFC 3339, UTC).
date-timecurl 'https://api.a-line.cloud/v1/environments/00000000-0000-4000-8000-000000000001/secret-groups/00000000-0000-4000-8000-000000000002' \ -H 'Authorization: Bearer alc_test_EXAMPLE_not_a_real_key'{ "created_at": "2019-08-24T14:15:22Z", "description": "string", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "keys_without_value": [ "string" ], "managed_in_git": { "branch": "string", "file": "string" }, "members": [ { "has_value": true, "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "injection_mode": "string", "mount_path": "string", "name": "string", "secret_type": "string" } ], "name": "string", "updated_at": "2019-08-24T14:15:22Z"}Try it: use a key with the least scope; requests go straight from your browser to the API. The key stays in this tab's memory and is gone on reload.
Secrets already in the group are skipped, so the call is safe to repeat.
api_keyAuthorizationBearer <alc_ API key>An A-Line.cloud API key, sent as Authorization: Bearer alc_.... Create keys in the dashboard; sessions are not accepted on /v1.
environment_id*stringThe environment UUID
uuidgroup_id*stringThe secret group UUID
uuidSecrets to add to a group. Secrets already in it are skipped.
application/json- body
Secrets to add to a group. Secrets already in it are skipped.
secret_ids*array<>Ids of secrets this environment may inject (its own or its clusters').
How many secrets were added
application/json- response
How many of the given secrets were not in the group yet.
added*integerSecrets added by this request (0 when all were members already).
int64curl -X POST 'https://api.a-line.cloud/v1/environments/00000000-0000-4000-8000-000000000001/secret-groups/00000000-0000-4000-8000-000000000002/members' \ -H 'Authorization: Bearer alc_test_EXAMPLE_not_a_real_key' \ -H 'Content-Type: application/json' \ -d '{"secret_ids":[]}'{ "added": 0}Try it: use a key with the least scope; requests go straight from your browser to the API. The key stays in this tab's memory and is gone on reload.
List an environment's secrets and those of its clusters (metadata only, never values).
Ordered by creation time, oldest first. Cursor paginated.
api_keyAuthorizationBearer <alc_ API key>An A-Line.cloud API key, sent as Authorization: Bearer alc_.... Create keys in the dashboard; sessions are not accepted on /v1.
environment_id*stringThe environment UUID
uuidcursor?|Opaque cursor from the previous page's next_cursor.
limit?|Page size, 1 to 100 (default 25).
uint0 <= valueA page of secrets
application/json- response
One page of a v1 list.
data*array<>The items, in the documented order.
has_more*booleanWhether more items follow this page.
next_cursor?|Pass as cursor to get the next page; null on the last page.
curl 'https://api.a-line.cloud/v1/environments/00000000-0000-4000-8000-000000000001/secrets' \ -H 'Authorization: Bearer alc_test_EXAMPLE_not_a_real_key'{ "data": [ { "created_at": "2019-08-24T14:15:22Z", "description": "string", "expires_at": "2019-08-24T14:15:22Z", "has_value": true, "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "injection_mode": "string", "keep_versions": 0, "mount_path": "string", "name": "string", "rotated_at": "2019-08-24T14:15:22Z", "scope_id": "5d3fe357-12dd-4f62-b004-6d1fb3b8454f", "scope_type": "string", "secret_type": "string", "updated_at": "2019-08-24T14:15:22Z", "value_origin": "string", "version": 0, "write_only": true } ], "has_more": true, "next_cursor": "string"}Try it: use a key with the least scope; requests go straight from your browser to the API. The key stays in this tab's memory and is gone on reload.
The value is write-only: it is never returned.
api_keyAuthorizationBearer <alc_ API key>An A-Line.cloud API key, sent as Authorization: Bearer alc_.... Create keys in the dashboard; sessions are not accepted on /v1.
environment_id*stringThe environment UUID
uuidCreate a secret. The value is stored encrypted and never returned.
application/json- body
Create a secret. The value is stored encrypted and never returned.
description?|Free text.
injection_mode?|env (default), file or both.
mount_path?|Where to mount a file/both secret.
name*stringThe name, unique within the cluster or environment.
secret_type?|opaque (default), database, registry or tls.
value*stringThe value (write-only).
write_only?booleanMake the key write-only: nobody can read its value back, in the console or the API (apps still receive it). One-way.
falseThe created secret
application/json- response
A secret's metadata, as the public API shows it. The value is never part of it.
created_at*stringWhen the secret was created (RFC 3339, UTC).
date-timedescription?|Free text.
expires_at?|When the value expires (RFC 3339, UTC).
date-timehas_value*booleanFalse for a secret declared without a value (in IaC) until one is set; apps do not receive it until then.
id*stringThe secret id.
uuidinjection_mode*stringHow apps receive it: env, file or both.
keep_versions?|How many replaced versions the secret keeps (1 to 100, each billed like the current value); null = the default, 10. Older ones are destroyed.
int32mount_path?|Where a file secret is mounted.
name*stringThe name, unique within its scope (the environment variable name for env injection).
rotated_at?|When the value was last rotated (RFC 3339, UTC).
date-timescope_id*stringThe id of that cluster, environment, project or app.
uuidscope_type*stringWhat the secret belongs to: cluster, environment, project or app.
secret_type*stringopaque, database, registry or tls (new values may be added).
updated_at*stringWhen the secret last changed (RFC 3339, UTC).
date-timevalue_origin*stringWho set the value: user, generated or app_credential.
version*integerThe current version; every value change adds one.
int32write_only*booleanThe value can be replaced or deleted but never read back by anyone (apps still receive it). One-way.
curl -X POST 'https://api.a-line.cloud/v1/environments/00000000-0000-4000-8000-000000000001/secrets' \ -H 'Authorization: Bearer alc_test_EXAMPLE_not_a_real_key' \ -H 'Content-Type: application/json' \ -d '{"name":"example","value":"example"}'{ "created_at": "2019-08-24T14:15:22Z", "description": "string", "expires_at": "2019-08-24T14:15:22Z", "has_value": true, "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "injection_mode": "string", "keep_versions": 0, "mount_path": "string", "name": "string", "rotated_at": "2019-08-24T14:15:22Z", "scope_id": "5d3fe357-12dd-4f62-b004-6d1fb3b8454f", "scope_type": "string", "secret_type": "string", "updated_at": "2019-08-24T14:15:22Z", "value_origin": "string", "version": 0, "write_only": true}Try it: use a key with the least scope; requests go straight from your browser to the API. The key stays in this tab's memory and is gone on reload.
Get the metadata of an environment secret or one of its clusters' secrets (never its value).
api_keyAuthorizationBearer <alc_ API key>An A-Line.cloud API key, sent as Authorization: Bearer alc_.... Create keys in the dashboard; sessions are not accepted on /v1.
environment_id*stringThe environment UUID
uuidsecret_id*stringThe secret UUID
uuidThe secret
application/json- response
A secret's metadata, as the public API shows it. The value is never part of it.
created_at*stringWhen the secret was created (RFC 3339, UTC).
date-timedescription?|Free text.
expires_at?|When the value expires (RFC 3339, UTC).
date-timehas_value*booleanFalse for a secret declared without a value (in IaC) until one is set; apps do not receive it until then.
id*stringThe secret id.
uuidinjection_mode*stringHow apps receive it: env, file or both.
keep_versions?|How many replaced versions the secret keeps (1 to 100, each billed like the current value); null = the default, 10. Older ones are destroyed.
int32mount_path?|Where a file secret is mounted.
name*stringThe name, unique within its scope (the environment variable name for env injection).
rotated_at?|When the value was last rotated (RFC 3339, UTC).
date-timescope_id*stringThe id of that cluster, environment, project or app.
uuidscope_type*stringWhat the secret belongs to: cluster, environment, project or app.
secret_type*stringopaque, database, registry or tls (new values may be added).
updated_at*stringWhen the secret last changed (RFC 3339, UTC).
date-timevalue_origin*stringWho set the value: user, generated or app_credential.
version*integerThe current version; every value change adds one.
int32write_only*booleanThe value can be replaced or deleted but never read back by anyone (apps still receive it). One-way.
curl 'https://api.a-line.cloud/v1/environments/00000000-0000-4000-8000-000000000001/secrets/00000000-0000-4000-8000-000000000002' \ -H 'Authorization: Bearer alc_test_EXAMPLE_not_a_real_key'{ "created_at": "2019-08-24T14:15:22Z", "description": "string", "expires_at": "2019-08-24T14:15:22Z", "has_value": true, "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "injection_mode": "string", "keep_versions": 0, "mount_path": "string", "name": "string", "rotated_at": "2019-08-24T14:15:22Z", "scope_id": "5d3fe357-12dd-4f62-b004-6d1fb3b8454f", "scope_type": "string", "secret_type": "string", "updated_at": "2019-08-24T14:15:22Z", "value_origin": "string", "version": 0, "write_only": true}Try it: use a key with the least scope; requests go straight from your browser to the API. The key stays in this tab's memory and is gone on reload.
api_keyAuthorizationBearer <alc_ API key>An A-Line.cloud API key, sent as Authorization: Bearer alc_.... Create keys in the dashboard; sessions are not accepted on /v1.
environment_id*stringThe environment UUID
uuidsecret_id*stringThe secret UUID
uuidDeleted
curl -X DELETE 'https://api.a-line.cloud/v1/environments/00000000-0000-4000-8000-000000000001/secrets/00000000-0000-4000-8000-000000000002' \ -H 'Authorization: Bearer alc_test_EXAMPLE_not_a_real_key'Try it: use a key with the least scope; requests go straight from your browser to the API. The key stays in this tab's memory and is gone on reload.
Set an environment secret's value: it becomes the next version. The value is write-only: it is never returned.
api_keyAuthorizationBearer <alc_ API key>An A-Line.cloud API key, sent as Authorization: Bearer alc_.... Create keys in the dashboard; sessions are not accepted on /v1.
environment_id*stringThe environment UUID
uuidsecret_id*stringThe secret UUID
uuidA new value for a secret (write-only). It becomes the next version.
application/json- body
A new value for a secret (write-only). It becomes the next version.
value*stringThe new value.
The secret with its new version
application/json- response
A secret's metadata, as the public API shows it. The value is never part of it.
created_at*stringWhen the secret was created (RFC 3339, UTC).
date-timedescription?|Free text.
expires_at?|When the value expires (RFC 3339, UTC).
date-timehas_value*booleanFalse for a secret declared without a value (in IaC) until one is set; apps do not receive it until then.
id*stringThe secret id.
uuidinjection_mode*stringHow apps receive it: env, file or both.
keep_versions?|How many replaced versions the secret keeps (1 to 100, each billed like the current value); null = the default, 10. Older ones are destroyed.
int32mount_path?|Where a file secret is mounted.
name*stringThe name, unique within its scope (the environment variable name for env injection).
rotated_at?|When the value was last rotated (RFC 3339, UTC).
date-timescope_id*stringThe id of that cluster, environment, project or app.
uuidscope_type*stringWhat the secret belongs to: cluster, environment, project or app.
secret_type*stringopaque, database, registry or tls (new values may be added).
updated_at*stringWhen the secret last changed (RFC 3339, UTC).
date-timevalue_origin*stringWho set the value: user, generated or app_credential.
version*integerThe current version; every value change adds one.
int32write_only*booleanThe value can be replaced or deleted but never read back by anyone (apps still receive it). One-way.
curl -X PUT 'https://api.a-line.cloud/v1/environments/00000000-0000-4000-8000-000000000001/secrets/00000000-0000-4000-8000-000000000002/value' \ -H 'Authorization: Bearer alc_test_EXAMPLE_not_a_real_key' \ -H 'Content-Type: application/json' \ -d '{"value":"example"}'{ "created_at": "2019-08-24T14:15:22Z", "description": "string", "expires_at": "2019-08-24T14:15:22Z", "has_value": true, "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "injection_mode": "string", "keep_versions": 0, "mount_path": "string", "name": "string", "rotated_at": "2019-08-24T14:15:22Z", "scope_id": "5d3fe357-12dd-4f62-b004-6d1fb3b8454f", "scope_type": "string", "secret_type": "string", "updated_at": "2019-08-24T14:15:22Z", "value_origin": "string", "version": 0, "write_only": true}