---
updatedAt: 2026-05-14T14:49:22.000Z
agentTools:
  projectIndex: https://docs.talkdesk.com/llms.txt
---

# Start a recording given a contact

Start a recording given a contact person's email from an ongoing interaction.

## Scope

`interactions:control-recordings`

# OpenAPI definition

```json
{
  "openapi": "3.0.2",
  "info": {
    "title": "Public API",
    "version": "5.12.68",
    "description": "Documents public API endpoints. Scopes are given to external software, that we don't control",
    "contact": {
      "name": "Talkdesk",
      "url": "https://talkdesk.com"
    }
  },
  "servers": [
    {
      "url": "https://api.talkdeskapp.com",
      "description": "United States (td-us-1)"
    },
    {
      "url": "https://api.talkdeskapp.eu",
      "description": "Europe (td-eu-1)"
    },
    {
      "url": "https://api.talkdeskappca.com",
      "description": "Canada (td-ca-1)"
    },
    {
      "url": "https://api.talkdeskapp.co.uk",
      "description": "United Kingdom (td-uk-1)"
    }
  ],
  "tags": [
    {
      "name": "Users API",
      "description": "Users API"
    }
  ],
  "paths": {
    "/users/{email}/recordings/start": {
      "post": {
        "operationId": "users-email-recordings-start-post",
        "summary": "Start a recording given a contact",
        "description": "Start a recording given a contact person's email from an ongoing interaction.",
        "deprecated": true,
        "security": [
          {
            "Deprecated": [
              "interactions:control-recordings"
            ]
          }
        ],
        "parameters": [
          {
            "name": "email",
            "in": "path",
            "description": "The email of the contact person",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "Users API"
        ],
        "responses": {
          "204": {
            "description": "Pause successful, no content"
          },
          "401": {
            "description": "Not authorized",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "code": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "code": "0350001",
                  "message": "Unauthorized"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden access",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "code": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "code": "0350002",
                  "message": "Forbidden"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "code": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "Example 0": {
                    "value": {
                      "code": "0350003",
                      "message": "User not found"
                    }
                  },
                  "Example 1": {
                    "value": {
                      "code": "0350004",
                      "message": "Voice interaction not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Unsupported action",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "code": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "code": "0350005",
                  "message": "Action not allowed on voice interaction"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "Deprecated": {
        "type": "oauth2",
        "flows": {
          "authorizationCode": {
            "authorizationUrl": "https://{account_name}.talkdeskid.com/oauth/authorize",
            "tokenUrl": "https://{account_name}.talkdeskid.com/oauth/token",
            "scopes": {
              "attributes:read": "List attributes or attribute categories for an account and get details for a specific attribute"
            }
          }
        }
      }
    }
  },
  "externalDocs": {
    "description": "External Documentation",
    "url": "https://api-docs.talkdeskapp.com/external_docs"
  }
}
```