---
title: "Trigger an API Call"
method: POST
path: "/calls/{id}/run"
---

# Trigger an API Call

`POST /calls/{id}/run`

## Request

- Base URL: `https://client.apimetrics.io/api/2`
- URL: `https://client.apimetrics.io/api/2/calls/{id}/run`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/apicontext/apis/api-settings/docs/calls/:id/run/post.ts> (a function with typed inputs; its response is checked against the schema)

Use this API to run an API Call.

## Path parameters

- `id` string, required

## Request body

- object
  - `location_id` string: Location ID of test agent that will make the request
  - `context` string: Dictionary of variable names and their values

## Response `200`

200

- object
  - `call_id` string
  - `result_id` string
  - `location_id` string
  - `context` object
    - `FOO` integer
    - `BAR` string
    - `DATUM` string

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/apicontext/apis/api-settings.md) - [All operations](https://skmtc.dev/apicontext/apis/api-settings/llms.txt) - [OpenAPI document](https://skmtc.dev/apicontext/apis/api-settings/revisions/2e9a62324e82?raw)