Assets
Asset upload and management
Generates a signed PUT URL for uploading files directly to S3
API key for authentication. Format - apikey YOUR_API_KEY
File name with extension
Project ID
File type (determines S3 path)
Custom storage ID
Custom bucket name
Upload URL generated successfully
curl -X GET "https://imeritapi.ango.ai/v2/getUploadUrl?name=image.jpg&project=507f1f77bcf86cd799439011&type=assets" \
-H "apikey: YOUR_API_KEY" \
-H "Content-Type: application/json"
Upload URL generated successfully
{
"status": "success",
"data": {
"uploadUrl": "https://bucket.s3.amazonaws.com/project/assets/file.jpg?X-Amz-Signature=..."
}
}Generates a signed GET URL for downloading files from S3
API key for authentication. Format - apikey YOUR_API_KEY
Asset URL to sign
Storage ID
Signed URL generated successfully
curl -X GET "https://imeritapi.ango.ai/v2/getSignedUrl?url=https://bucket.s3.amazonaws.com/project/assets/image.jpg" \
-H "apikey: YOUR_API_KEY" \
-H "Content-Type: application/json"
Signed URL generated successfully
{
"status": "success",
"data": {
"signedUrl": "text"
}
}Imports assets from cloud storage (S3, GCS, Azure) and creates tasks
API key for authentication. Format - apikey YOUR_API_KEY
Project ID
JSON stringified array of batch names
Whether to download and store assets locally.
- "true": Download assets from cloud URLs and store locally
- "false": Keep assets in cloud (reference URLs only) Default: "false" for cloud imports
falsePossible values: Task priority for queue ordering (higher values = higher priority)
0Assets imported successfully
Bad request - validation error
curl -X POST "https://imeritapi.ango.ai/v2/project/507f1f77bcf86cd799439011/cloud" \
-H "apikey: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"assets": [
{
"data": "https://my-bucket.s3.amazonaws.com/images/img001.jpg",
"externalId": "IMG-001"
},
{
"data": "https://my-bucket.s3.amazonaws.com/images/img002.jpg",
"externalId": "IMG-002"
}
]
}'
{
"status": "success",
"data": {
"assets": {
"assetsCreated": 1,
"tasksCreated": 1,
"preLabelsCount": 1,
"validPreLabelsCount": 1
}
}
}Uploads chat/conversation assets for chat annotation projects
API key for authentication. Format - apikey YOUR_API_KEY
Project ID
JSON file with conversations
JSON stringified conversations array
JSON stringified batch names
LLM configuration JSON
Chat assets uploaded successfully
POST /v2/project/{projectId}/chat HTTP/1.1
Host: imeritapi.ango.ai
apikey: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 174
{
"file": "binary",
"conversations": "text",
"storageId": "text",
"bucket": "text",
"batches": "text",
"llmConfig": "text",
"numberOfConversations": 1,
"namingStrategy": "text",
"priority": 1
}Chat assets uploaded successfully
{
"status": "success",
"data": {
"assets": {
"assetsCreated": 1,
"tasksCreated": 1,
"preLabelsCount": 1,
"validPreLabelsCount": 1
}
}
}Retrieves assets for a specific project with optional filtering
API key for authentication. Format - apikey YOUR_API_KEY
Project ID
Page number (1-indexed)
1Items per page (max 100)
10JSON stringified filter object
Filter by external ID
Filter by batch names
Assets retrieved successfully
curl -X GET "https://imeritapi.ango.ai/v2/project/507f1f77bcf86cd799439011/assets?page=1&limit=10&externalId=image-001" \
-H "apikey: YOUR_API_KEY" \
-H "Content-Type: application/json"
Assets retrieved successfully
{
"status": "success",
"data": {
"assets": [
{
"_id": "text",
"data": "text",
"dataset": [
"text"
],
"overlay": [
"text"
],
"project": "text",
"organization": "text",
"externalId": "text",
"batches": [
"text"
],
"metadata": {},
"contextData": {},
"labelTasks": [
"text"
],
"deleted": true,
"createdAt": "2025-11-17T00:15:19.074Z",
"createdBy": "text"
}
],
"total": 1
}
}Deletes multiple assets from a project
API key for authentication. Format - apikey YOUR_API_KEY
Project ID
Assets deleted successfully
DELETE /v2/project/{projectId}/assets HTTP/1.1
Host: imeritapi.ango.ai
apikey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 19
{
"assets": [
"text"
]
}Assets deleted successfully
{
"status": "success",
"data": {
"deleted": 1,
"failed": 1
}
}Updates asset metadata or properties
API key for authentication. Format - apikey YOUR_API_KEY
Asset ID
Asset updated successfully
POST /v2/assets/{assetId} HTTP/1.1
Host: imeritapi.ango.ai
apikey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 85
{
"metadata": {},
"contextData": {},
"data": "text",
"overlay": [
"text"
],
"externalId": "text"
}Asset updated successfully
{
"status": "success",
"data": {
"asset": {
"_id": "text",
"data": "text",
"dataset": [
"text"
],
"overlay": [
"text"
],
"project": "text",
"organization": "text",
"externalId": "text",
"batches": [
"text"
],
"metadata": {},
"contextData": {},
"labelTasks": [
"text"
],
"deleted": true,
"createdAt": "2025-11-17T00:15:19.074Z",
"createdBy": "text"
}
}
}Assigns batch names to existing assets
API key for authentication. Format - apikey YOUR_API_KEY
addPossible values: Batches assigned successfully
curl -X POST "https://imeritapi.ango.ai/v2/assignBatches" \
-H "apikey: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"project": "507f1f77bcf86cd799439011",
"assets": ["asset123", "asset456"],
"batches": ["Batch1", "Batch2"]
}'
Batches assigned successfully
{
"status": "success",
"data": {
"assets": {
"modifiedCount": 1,
"batches": [
"text"
]
}
}
}Last updated