Skip to main content
POST
Rotate MCP registry gateway token

Authorizations

Authorization
string
header
required

Enter a Forge service-account token or delegated OAuth access token. Mintlify adds the Bearer prefix.

Path Parameters

organizationId
string
required
itemRef
string
required

Readable MCP registry slug or item identifier.

tokenId
string
required

Body

application/json
name
string
Required string length: 1 - 80
scopes
enum<string>[]
Required array length: 1 element
Available options:
mcp:connect
expiresInDays
integer
default:90
Required range: 1 <= x <= 365

Response

Replacement one-time gateway token secret; the previous token is revoked.

token
object
required
gatewayToken
string
required

One-time plaintext secret. Forge retains only its hash.

Pattern: ^forge_mcp_[A-Za-z0-9_-]+$
message
string
required