Skip to main content
POST
/
deployments
/
secrets
cURL
curl -X POST \
      -H "Authorization: Bearer $TOGETHER_API_KEY" \
      --data '{ "name": "my-secret", "value": "my-value" }' \
      https://api.together.ai/v1/deployments/secrets
{
  "created_at": "<string>",
  "created_by": "<string>",
  "description": "<string>",
  "id": "<string>",
  "last_updated_by": "<string>",
  "name": "<string>",
  "object": "<string>",
  "updated_at": "<string>"
}

Authorizations

​
Authorization
string
header
default:default
required

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

Body

application/json

Secret configuration

​
name
string
required

Name is the unique identifier for the secret. Can contain alphanumeric characters, underscores, hyphens, forward slashes, and periods (1-100 characters)

Required string length: 1 - 100
​
value
string
required

Value is the sensitive data to store securely (e.g., API keys, passwords, tokens). This value will be encrypted at rest

Minimum string length: 1
​
description
string

Description is an optional human-readable description of the secret's purpose (max 500 characters)

Maximum string length: 500
​
project_id
string

ProjectID is ignored - the project is automatically determined from your authentication

Response

Secret created successfully

​
created_at
string

CreatedAt is the ISO8601 timestamp when this secret was created

​
created_by
string

CreatedBy is the identifier of the user who created this secret

​
description
string

Description is a human-readable description of the secret's purpose

​
id
string

ID is the unique identifier for this secret

​
last_updated_by
string

LastUpdatedBy is the identifier of the user who last updated this secret

​
name
string

Name is the name/key of the secret

​
object
string

Object is the type identifier for this response (always "secret")

​
updated_at
string

UpdatedAt is the ISO8601 timestamp when this secret was last updated