---
title: "Session Execute"
method: POST
path: "/api/v1/agents/session/{session_id}/execute"
tags: ["Agent Intelligence"]
---

# Session Execute

`POST /api/v1/agents/session/{session_id}/execute`

## Request

- Base URL: `https://www.deepmapai.com`
- URL: `https://www.deepmapai.com/api/v1/agents/session/{session_id}/execute`
- Auth: none declared

Execute a tool within an active session. Results are stored and
context (lat/lon) carries forward to subsequent calls.

## Path parameters

- `session_id` string, required

## Query parameters

- `x_api_key` string, nullable

## Request body

- SessionExecuteRequest: Execute a tool within an active session.
  - `tool` string, required: Tool name from TOOLS list
  - `arguments` object

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/deepmapai/apis/deepmap-ai.md) · [All operations](https://skmtc.dev/deepmapai/apis/deepmap-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/deepmapai/apis/deepmap-ai/revisions/dab995d977d0?raw)