agents

Get an Agent

Changed on

Returns an Agent with the environments visible to the caller. The path value is the user-assigned Agent ID. Pass include=runtime_bindings to embed each environment's runtime bindings.

get/api/v1/agents/{agent_id}

Request

  • Base URL
    https://api.smith.langchain.com
  • URL
    https://api.smith.langchain.com/api/v1/agents/{agent_id}
  • Auth
    • API key in header X-API-Key
    • or API key in header X-Tenant-Id
    • or HTTP bearer

Path parameters

agent_idstring required

Agent ID

Query parameters

include'runtime_bindings'

Relation to embed. runtime_bindings adds each environment's runtime bindings; an empty array means no runtime is linked.

Response

OK

agent_type'CUSTOM' | 'CODING' required
avatar_urlstring nullable

AvatarURL is a short-lived URL for the agent avatar, when present.

created_atstring date-time required
idstring required
namestring required
ownerstring

Owner is the owner's full name, falling back to email when available.

owner_idstring uuid nullable
source_type'LSD' | 'MDA' | 'EXTERNAL' | 'FLEET' required
tag_key_idstring uuid nullable
tag_value_idstring uuid nullable

Changes

  • d1aa6d438ff0Revision changes
    • info

      added the optional property to the response with the status

  • e45f16e950dcRevision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status