Add Items to Queue

Add source items to an annotation queue in bulk.

Add Items to Queue

Add one or more source items (e.g., traces) to an annotation queue. Duplicates are detected and reported.

POST https://api.futureagi.com/model-hub/annotation-queues/{queue_id}/items/add-items/
Bearer 
          Click "Try It" to send a request

Authentication

HeaderDescription
X-Api-KeyYour API key
X-Secret-KeyYour secret key

Path Parameters

ParameterTypeRequiredDescription
queue_idUUIDYesThe annotation queue ID

Request Body

FieldTypeRequiredDescription
itemsarrayYesArray of items to add
items[].source_typestringYesType of source (e.g. trace)
items[].source_idUUIDYesUUID of the source object

Response

FieldTypeDescription
addedintegerNumber of items successfully added
duplicatesintegerNumber of items that already existed in the queue
errorsarrayList of error messages for failed items

Code Examples

import requests

queue_id = "your-queue-uuid"
resp = requests.post(
    f"https://api.futureagi.com/model-hub/annotation-queues/{queue_id}/items/add-items/",
    headers={"X-Api-Key": "YOUR_KEY", "X-Secret-Key": "YOUR_SECRET"},
    json={
        "items": [
            {"source_type": "trace", "source_id": "trace-uuid-1"},
            {"source_type": "trace", "source_id": "trace-uuid-2"}
        ]
    }
)
print(resp.json())
import axios from 'axios';

const queueId = 'your-queue-uuid';
const resp = await axios.post(
  `https://api.futureagi.com/model-hub/annotation-queues/${queueId}/items/add-items/`,
  {
    items: [
      { sourceType: 'trace', sourceId: 'trace-uuid-1' },
      { sourceType: 'trace', sourceId: 'trace-uuid-2' }
    ]
  },
  { headers: { 'X-Api-Key': 'YOUR_KEY', 'X-Secret-Key': 'YOUR_SECRET' } }
);
console.log(resp.data);
curl -X POST "https://api.futureagi.com/model-hub/annotation-queues/your-queue-uuid/items/add-items/" \
  -H "X-Api-Key: YOUR_KEY" \
  -H "X-Secret-Key: YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"items": [{"source_type": "trace", "source_id": "trace-uuid-1"}, {"source_type": "trace", "source_id": "trace-uuid-2"}]}'
Was this page helpful?

Questions & Discussion