Supported integrations
The following integrations implement this schema:Global identity block
Every run type must include the following identity fields in its metadata:Availability tiers
Fields in this schema are marked with one of three availability tiers:Run types
This schema distinguishes five run types. Some fields apply only to a subset of run types.Required fields by run type
All run types
The global identity block fields are always required on every run type. Additional fields required on all run types:
The Claude Code, Codex and Cursor plugins also send each Git field under its old name (like
git_branch and git_commit_sha) so existing filters keep working. LangSmith does the same for Copilot traces from the Local harness.
llm runs
tool runs
subagent runs
interrupted runs
Interrupted runs carry the same fields as root runs. The run type itself signals the abnormal termination state; no additional required fields are added.
Related
- Metadata parameters reference:
ls_prefixed fields used in LangSmith runs generally. - Add metadata and tags: how to attach metadata to traces using the LangSmith SDK.
Connect these docs to your agent of choice via MCP for real-time answers.

