Create AI Worker - API

This API enables you to create a new AI worker that can be deployed using our videosdk-agents Python package, allowing you to run your custom AI Workers on VideoSDK's Infrastructure.

HTTP method and endpoint

POST

|

https://api.videosdk.live/ai/v1/ai-workers

Headers Parameters

Authorization

REQUIRED

values : YOURTOKENWITHOUTANYPREFIX

This will be a JWT token generate using VideoSDK ApiKey and Secret.

Note that the token will not include any prefix such as "Basic " or "Bearer ". Just pass a token as value.

You can generate a new token by refering this Guide: Generate Auth token

Content-Type

REQUIRED

values : application/json

This is usefull for json body parameters, so that VideoSDK servers can understand that the incoming body parameter will be a JSON string.

Body Parameters

name

REQUIRED

The name of the AI worker.

description

REQUIRED

A brief description of the AI worker.

POST

|

https://api.videosdk.live/ai/v1/ai-workers

NodeJS

• cURL
• NodeJS
• PHP
• Python

import fetch from 'node-fetch';
const options = {
	method: "POST",
	headers: {
		"Authorization": "$YOUR_TOKEN",
		"Content-Type": "application/json",
	},
	body: JSON.stringify({
		"name" : "name-ai-worker",
		"description" : "This is a sample AI worker description."
	}),
};
const url= `https://api.videosdk.live/ai/v1/ai-workers`;
const response = await fetch(url, options);
const data = await response.json();
console.log(data);

RESPONSE

{
  "id": "64fff228-fd76-463f-86eb-99b7c08b268e",
  "name": "name-ai-worker",
  "description": "Description of the AI Worker",
  "status": "available",
  "createdAt": "2025-06-09T10:20:03.248Z",
  "updatedAt": "2025-06-09T10:20:03.248Z"
}