---
title: "POST /call/analysis/initiate"
method: POST
path: "/call/analysis/initiate"
tags: ["AI Call Analysis"]
---

# POST /call/analysis/initiate

`POST /call/analysis/initiate`

Sends a call recording for AI analysis. Send a signed url for the recording along with the call type and the agent name. Credits are charged on the length of the recording, measured by us, at one credit per minute rounded up. The analysis runs in the background, so this returns a requestId which you use to check the progress and fetch the result.

## Request body

- InitiateCallAnalysis — Schema to initiate a call analysis
  - `recordingUrl` string, required — A signed url for the recording, time limited, for example a pre-signed Amazon S3 or Google Cloud Storage url. It must be an https url carrying a signature, and it needs to stay valid until the analysis finishes.
  - `callType` 'incoming' | 'outgoing', required — Whether the call was incoming or outgoing. Missed calls and calls of no length cannot be analysed.
  - `callerName` string — Name of the agent who handled the call. Optional (pass it for better results).
  - `customerName` string — Name of the customer on the call. Optional.
  - `processId` string — Id of the process. Optional, and accepted for compatibility, but a recording sent through this API is always analysed against your default process.
  - `metadata` object — Any reference of your own, such as a ticket number or a campaign name. Saved exactly as you send it and returned unchanged when you fetch the analysis. Up to 50 entries.

## Response `200`

If the auth token is valid.

- InitiateCallAnalysisSuccess — Schema for an initiated call analysis
  - `statusCode` number — Will be 0 in case of success
  - `message` string — Contains the success message or error reason, based on the statusCode
  - `data` object
    - `requestId` string — The id we create for this analysis. Use it to check the progress and fetch the result.
    - `status` integer — Stage of the analysis when the request was accepted
    - `creditsUsed` number — Credits charged for this request. One minute of recording costs one credit, rounded up, so a one minute call costs one credit and a call of one minute and ten seconds costs two.

## Other responses

- `403` — UnAuthorized.

---

[API](https://skmtc.dev/runo/apis/api-documentation.md) · [All operations](https://skmtc.dev/runo/apis/api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/runo/api-documentation/revisions/19460dffac44/schema)