Ellipsis APIReference
Sandbox secrets
Sandbox secrets endpoints of the Ellipsis REST API.
Values are write-only: the response carries only names and timestamps, never the stored value.
curl "https://api.ellipsis.dev/secrets" \
-H "Authorization: Bearer $ELLIPSIS_API_KEY"{
"variables": [
{
"created_at": "2026-01-01T00:00:00Z",
"name": "string",
"updated_at": "2026-01-01T00:00:00Z"
}
]
}No request body.
{
"properties": {
"variables": {
"items": {
"properties": {
"created_at": {
"format": "date-time",
"type": "string"
},
"name": {
"type": "string"
},
"updated_at": {
"format": "date-time",
"type": "string"
}
},
"required": [
"name",
"created_at",
"updated_at"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"variables"
],
"type": "object"
}Responses
Values are write-only: the response carries only names and timestamps. Refused for sandbox tokens (held by potentially-untrusted in-sandbox code); mutations require an API key or user token.
curl -X PUT "https://api.ellipsis.dev/secrets" \
-H "Authorization: Bearer $ELLIPSIS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"variables":[]}'{
"variables": [
{
"created_at": "2026-01-01T00:00:00Z",
"name": "string",
"updated_at": "2026-01-01T00:00:00Z"
}
]
}{
"properties": {
"variables": {
"items": {
"properties": {
"name": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"name",
"value"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"variables"
],
"type": "object"
}{
"properties": {
"variables": {
"items": {
"properties": {
"created_at": {
"format": "date-time",
"type": "string"
},
"name": {
"type": "string"
},
"updated_at": {
"format": "date-time",
"type": "string"
}
},
"required": [
"name",
"created_at",
"updated_at"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"variables"
],
"type": "object"
}Request
variablesarray<EnvironmentVariableInput>required
The variables to store.
Responses
Refused for sandbox tokens; mutations require an API key or user token.
curl -X DELETE "https://api.ellipsis.dev/secrets/{name}" \
-H "Authorization: Bearer $ELLIPSIS_API_KEY"{
"variables": [
{
"created_at": "2026-01-01T00:00:00Z",
"name": "string",
"updated_at": "2026-01-01T00:00:00Z"
}
]
}No request body.
{
"properties": {
"variables": {
"items": {
"properties": {
"created_at": {
"format": "date-time",
"type": "string"
},
"name": {
"type": "string"
},
"updated_at": {
"format": "date-time",
"type": "string"
}
},
"required": [
"name",
"created_at",
"updated_at"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"variables"
],
"type": "object"
}Request
namestringrequired