API Reference
Assign tags to many prompts at once, upserting tag names into the library
Idempotent, sized for CSV imports. Prompts outside the organization and empty tag names are reported in `skipped` instead of failing the request.
POST
header
X-API-Key<token>API Key for programmatic access
domainId*stringPublic UUID of the domain whose tag library is addressed
application/json- body
assignments*array<>Items
items <= 500Assignment summary
application/json- response
assigned*numberLinks in place after the call, including ones that already existed
created*numberSubset of assigned this call actually inserted
tagsCreated*numberTag definitions this call added to the domain's library
skipped*array<>Pairs that were not applied
curl -X POST 'https://api.getmint.ai/api/domains/3fa85f64-5717-4562-b3fc-2c963f66afa6/tags/assignments/bulk' \ -H 'Content-Type: application/json' \ -d '{ "assignments": [ { "promptId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "tagNames": [ "retail", "high priority" ] } ]}'{ "assigned": 3800, "created": 3800, "tagsCreated": 12, "skipped": [ { "promptId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "tagName": "retail", "reason": "Prompt does not belong to this domain" } ]}