Skip to main content
POST
Together AI SDK (Python)

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). 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

ttl_seconds
integer

TTLSeconds is how long the secret lives before it is deleted, between 86400 (1 day) and 1209600 (14 days)

Required range: 86400 <= x <= 1209600

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 who created this secret.

description
string

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

expires_at
string<date-time>

ExpiresAt is the ISO8601 timestamp when this secret expires and is deleted. Changing the value extends it. Omitted for secrets that never expire

id
string

ID is the unique identifier for this secret

last_updated_by
string

LastUpdatedBy is the identifier of who last updated this secret.

name
string

Name is the name/key of the secret

object
any

The object type, which is always secret.

ttl_seconds
integer

TTLSeconds is the secret's lifetime in seconds. Omitted when no TTL is set

updated_at
string

UpdatedAt is the ISO8601 timestamp when this secret was last updated