Skip to main content
POST
Create a profile

Authorizations

X-Api-Key
string
header
required

Personal or workspace LangSmith API key. Personal keys identify the user. Workspace keys are limited to server listing and MCP calls and must also supply the end user's OIDC token or X-LangSmith-Identity.

X-Tenant-Id
string
header
required

Workspace UUID. This header selects a workspace; it does not authenticate the caller.

Body

application/json

A new profile.

name
string
required

Name you give the profile, up to 256 characters.

Maximum string length: 256
Example:

"support-bot"

Response

Created

A named set of fixed tool credentials that an admin configures and callers use in place of their own.

created_at
string

When the profile was created.

created_by
string<uuid> | null

LangSmith user who created the profile.

id
string<uuid>

Profile ID.

name
string

Profile name.

Example:

"support-bot"

updated_at
string

When the profile last changed.

updated_by
string<uuid> | null

LangSmith user who last changed the profile.